# What’s Trending API

The What’s Trending API exposes workspace configuration, ranked customer-interest trends, source-linked public evidence and rate-limited live scans.

Base URL: `https://api.whatstrending.cc`

Authoritative contract: https://api.whatstrending.cc/openapi.json

## Authentication

API access is included with Pro. Create a key in the application under Settings → Agent access and send it with every protected request:

```http
Authorization: Bearer wt_live_YOUR_KEY
```

Keys are scoped to one workspace, displayed once, stored as hashes and revocable.

## Endpoints

- `GET /v1/workspace` — WordBank, competitor URLs, resolved handles and collection window.
- `GET /v1/trends?days=30` — ranked topics for 7, 30, 90, 180 or 365 days.
- `GET /v1/evidence?days=30&platform=reddit&q=topic&limit=50` — source posts and available public metrics.
- `POST /v1/scans` — run the four live collectors; limited to one API-triggered scan every 15 minutes.

## MCP

The same capabilities are available through Streamable HTTP MCP at `https://api.whatstrending.cc/mcp`. Send the same Bearer key for authenticated tool calls. Discovery metadata is at `https://api.whatstrending.cc/.well-known/mcp.json`.

## Data interpretation

Metric fields vary by source. Missing values mean unavailable, not zero. Inspect and cite original URLs before turning a trend into a claim.