REST API
Тренды, авторы, кластеры, звуки и ниши — и та же работа, что в приложении: темы, брифы, текст-паки, контент-план. JSON, авторизация по ключу, описание в OpenAPI.
Документация APIРазработчикам
Данные о трендах в вашем коде
Два способа получить то, на чём работает YoTrends: REST API для вашего бэкенда и MCP-сервер, чтобы AI-ассистент обращался к данным и функциям напрямую.
Два интерфейса
MCP-сервер
Те же функции инструментами для Claude, Cursor и других MCP-клиентов: найти тренды, вести темы, собрать бриф и текст-пак, положить идею в контент-план — прямо в чате.
Как это работаетЭндпоинты
Эндпоинты возвращают JSON, базовый адрес — https://yotrends.ai/api/public/v1. AI-операции тратят кредиты тарифа, как в приложении. Полный список, параметры и консоль для проб — в интерактивной документации.
| Эндпоинт | Что возвращает |
|---|---|
GET /me | Ваш тариф, AI-кредиты и остаток запросов |
GET /{youtube|tiktok}/trends/videos | Трендовые видео по рынку, категории и окну |
GET /{youtube|tiktok}/trends/influencers | Авторы по частоте попадания в тренды |
GET /{youtube|tiktok}/trends/rising-creators | Каналы, которые растут быстрее своего размера |
GET /trends/clusters, /trends/clusters/{id} | Растущие тренды и ролики каждого из них |
GET /tiktok/sounds, /tiktok/sounds/{id}/videos | Трендовые звуки TikTok и ролики на них |
GET /categories, …/{group}/subcategories, …/{group}/trendline | Ниши: что растёт, что остывает, дневная динамика |
POST /subcategories/{name}/report | AI-отчёт по подкатегории — тратит кредиты |
GET /topics, POST /topics, GET /topics/agenda | Ваши темы, новая тема, что снимать сейчас |
GET /topics/{id}/feed, /topics/{id}/trends, POST /topics/{id}/digest | Ролики, тренды и AI-разбор одной темы |
POST /trends/clusters/{id}/brief, /topics/{id}/trends/{cluster_id}/brief | Три готовых угла для тренда — тратит кредиты |
POST /topics/{id}/text-pack, /videos/{video_id}/text-pack | Текст-пак под угол темы или по ролику — тратит кредиты |
GET · POST · PATCH · DELETE /content-plan | Контент-план: список, добавить, изменить, удалить |
GET /channels | Подключённые каналы |
Авторизация
Ключ передаётся в заголовке X-API-Key. Создать его можно в настройках, если тариф включает доступ к API.
curl -H "X-API-Key: $YOTRENDS_API_KEY" \ "https://yotrends.ai/api/public/v1/youtube/trends/videos?region=US&pageSize=10"
Ключ секретный и несёт доступ вашего тарифа. Держите его на сервере, не в коде страницы.
Что входит в тарифы
| Тариф | REST API: запросов в месяц | MCP: запросов к данным в месяц |
|---|---|---|
| Free | Не входит | Не входит |
| Creator | Не входит | 3 000 |
| Pro | Не входит | 10 000 |
| Team | 500 | 30 000 |
| Agency | 1 000 | 100 000 |
MCP-сервер входит в любой платный тариф, REST API — в Team и Agency. AI-операции — паки, брифы, отчёты — тратят кредиты тарифа на обеих поверхностях и в квоту MCP не входят. Нужен больший лимит — напишите нам.