# What’s Trending developer portal

Use the What’s Trending REST API or Streamable HTTP MCP server to read source-backed customer-interest trends and public evidence for an authenticated Pro workspace.

## Start

1. Sign in at https://app.whatstrending.cc/.
2. Activate Pro and complete workspace setup.
3. Open Settings → Agent access.
4. Create a workspace-scoped key and store it server-side.
5. Start with GET https://api.whatstrending.cc/v1/trends.

## Contracts

- OpenAPI 3.1: https://whatstrending.cc/openapi.json
- API guide: https://whatstrending.cc/api.md
- Authentication: https://whatstrending.cc/auth.md
- Pricing: https://whatstrending.cc/pricing.md
- MCP server: https://api.whatstrending.cc/mcp
- MCP card: https://whatstrending.cc/.well-known/mcp/server-card.json

## Safe scan retries

POST /v1/scans changes workspace history. Confirm user intent and send an Idempotency-Key of 8–128 supported ASCII characters. A completed retry with the same workspace and key replays the original response for 24 hours.

## Limits

Agent access requires Pro. Agent-triggered scans are limited to once per hour per workspace. There is no separate public sandbox. Missing source metrics mean unavailable, not zero.
