REST API
Семь эндпоинтов на чтение: трендовые видео, авторы, категории. JSON, авторизация по ключу, описание в OpenAPI.
Документация APIРазработчикам
Данные о трендах в вашем коде
Два способа получить те же данные, на которых работает YoTrends: REST API для вашего бэкенда и MCP-сервер, чтобы AI-ассистент обращался к ним напрямую.
Два интерфейса
MCP-сервер
Девять инструментов для Claude, Cursor и других MCP-клиентов: искать тренды, вести топики, собрать текстовый пак прямо в чате.
Как это работаетЭндпоинты
Все эндпоинты только на чтение и возвращают JSON. Параметры, формат ответа и консоль для проб — в интерактивной документации.
| Эндпоинт | Что возвращает |
|---|---|
GET /api/public/v1/youtube/trends/videos | Трендовые видео YouTube по региону, категории и окну |
GET /api/public/v1/tiktok/trends/videos | Трендовые видео TikTok по региону, категории и окну |
GET /api/public/v1/youtube/trends/influencers | Авторы YouTube по частоте попадания в тренды |
GET /api/public/v1/tiktok/trends/influencers | Авторы TikTok по тому же принципу |
GET /api/public/v1/categories | Таксономия категорий |
GET /api/public/v1/categories/{group}/subcategories | Подкатегории внутри группы |
GET /api/public/v1/categories/{group}/trendline | Динамика категории во времени |
Авторизация
Ключ передаётся в заголовке X-API-Key. Создать его можно в настройках, если тариф включает доступ к API.
curl -H "X-API-Key: $YOTRENDS_API_KEY" \ "https://yotrends.ai/api/public/v1/youtube/trends/videos?region=US&limit=10"
Ключ секретный и несёт доступ вашего тарифа. Держите его на сервере, не в коде страницы.
Что входит в тарифы
| Тариф | Запросов в месяц | MCP-сервер |
|---|---|---|
| Free, Creator, Pro | Не входит | Creator и Pro: да |
| Team | 500 | Да |
| Agency | 1000 | Да |
MCP-сервер входит в любой платный тариф. REST API — в Team и Agency. Нужен больший лимит — напишите нам.