REST API
Seven read endpoints over trending videos, creators and categories. JSON, API-key auth, documented in OpenAPI.
Open API docsFor developers
Two ways to reach the same data that powers YoTrends: a REST API for your backend, and an MCP server so an AI assistant can query it directly.
Seven read endpoints over trending videos, creators and categories. JSON, API-key auth, documented in OpenAPI.
Open API docsNine tools for Claude, Cursor and other MCP clients: search trends, track topics, generate a text pack without leaving the chat.
How it worksAll endpoints are read-only and return JSON. Parameters, response shapes and a live try-it console are in the interactive docs.
| Endpoint | Returns |
|---|---|
GET /api/public/v1/youtube/trends/videos | Trending YouTube videos by region, category and window |
GET /api/public/v1/tiktok/trends/videos | Trending TikTok videos by region, category and window |
GET /api/public/v1/youtube/trends/influencers | YouTube creators ranked by how often they appear in trends |
GET /api/public/v1/tiktok/trends/influencers | TikTok creators ranked the same way |
GET /api/public/v1/categories | The category taxonomy |
GET /api/public/v1/categories/{group}/subcategories | Subcategories inside one category group |
GET /api/public/v1/categories/{group}/trendline | A category's trend line over time |
Every request carries your key in the X-API-Key header. Generate one in Settings once your plan includes API access.
curl -H "X-API-Key: $YOTRENDS_API_KEY" \ "https://yotrends.ai/api/public/v1/youtube/trends/videos?region=US&limit=10"
Keys are secret and carry your plan's access. Keep them server-side, never in browser code.
| Plan | API calls per month | MCP server |
|---|---|---|
| Free, Creator, Pro | Not included | Creator and Pro: yes |
| Team | 500 | Yes |
| Agency | 1000 | Yes |
The MCP server is included with every paid plan. The REST API is on Team and Agency. Need a higher allowance? Contact us.