# Exorde Intel API

> Structured narrative intelligence from public web and social-media conversation. Trending terms, narrative summaries, LLM-validated volume-spike alerts, conversation clusters, named-entity leaderboards, evidence posts, webhooks, and editorial reports — exposed through a single REST API in three tiers (Watch / See / Know).

The Exorde Intel API turns ~4 billion public posts per month into structured signals. Curated topics (`global`, `cyber`, `finance`, `disinfo`) and customer-defined watchlists expose the same analytics surface. Authentication is a single `X-API-Key` header. Every non-2xx response carries a typed `error` enum, a human `message`, and a 16-hex `trace_id`. A free 7-day Watch-tier trial key is mintable via an unauthenticated POST to `/v1/keys/trial`.

Base URL: https://intel-v1.exorde.io
Auth: `X-API-Key` header
Trial mint: `POST /v1/keys/trial` with `{"email": "..."}`
Live OpenAPI: https://intel-v1.exorde.io/v1/openapi.json
Live status: https://intel-v1.exorde.io/v1/status
Support: intel@exorde.io

## Getting started

- [Overview](https://docs.exorde.io/): What the API is, three pillars, three tiers, sample responses.
- [Quickstart](https://docs.exorde.io/quickstart): Mint a trial, call trending, narrative, and alerts on `global` in five minutes.
- [Authentication](https://docs.exorde.io/authentication): Mint, rotate, revoke. Test-mode keys. The typed error envelope.

## Core concepts

- [Tiers and quotas](https://docs.exorde.io/tiers): Watch / See / Know capability matrix, RPM and burst limits, history-depth caps, result-size caps.
- [Topics and watchlists](https://docs.exorde.io/topics-and-watchlists): The four curated topics; custom watchlists with `keyword`, `phrase`, `entity`, `domain` term types; same analytics surface for both.
- [Rate limits](https://docs.exorde.io/rate-limits): Per-tier RPM and burst, response headers (`X-RateLimit-*`, `Retry-After`), backoff patterns in Python / Node / PowerShell.
- [Errors](https://docs.exorde.io/errors): Every typed error code (`upgrade_required`, `rate_limited`, `topic_denied`, `invalid_api_key`, …), the envelope shape, and what to do.

## Signals

- [Trending](https://docs.exorde.io/trending): Top terms ranked by rolling z-score against a 14-day baseline. State of the conversation in one call. Watch-tier+.
- [Narrative](https://docs.exorde.io/narrative): Editorial summary of the dominant storyline plus weighted sub-narratives. Currently in alpha — output format and per-customer voice tailoring being co-designed with early customers. Watch-tier+.
- [Alerts](https://docs.exorde.io/alerts): LLM-validated volume-spike events with severity (sigma deviation), spread (domain × language), IOCs, sample posts, matched cluster context. Polling on Watch; webhook delivery on See and Know.

## Build

- [Use cases](https://docs.exorde.io/use-cases): Five copy-paste recipes — newsroom alerts, brand watchlist monitoring, threat-intel daily digest, disinformation early-warning, executive dashboard.
- [API reference](https://docs.exorde.io/reference): Every endpoint with a live try-it, generated from the OpenAPI spec.
- [Changelog](https://docs.exorde.io/changelog): Release-by-release notes, semantic-versioning policy.

## Optional

- [OpenAPI spec (JSON)](https://intel-v1.exorde.io/v1/openapi.json): Generate clients in any language.
- [Live status](https://intel-v1.exorde.io/v1/status): Per-stream freshness, never cached more than 30 seconds.
- [GitHub](https://github.com/exorde-labs): Public examples and SDKs.