Captapi
официальныйПубличные данные социальных сетей для ИИ-агентов: профили, посты, комментарии, транскрипты и поиск в TikTok, Instagram, YouTube, X, Facebook, Threads, Reddit и на страницах компаний LinkedIn, а также библиотеки рекламы Meta, Google, LinkedIn и TikTok.
Что можно делать с Captapi MCP?
- Получение транскриптов — Запросите транскрипт публичного видео YouTube, TikTok, Instagram, Facebook или X по URL.
- Суммирование социального контента — Запросите AI-сводку видео, рилса или поста на поддерживаемых платформах.
- Извлечение комментариев и ответов — Получите комментарии или ответы на комментарии для данного поста или видео.
- Поиск и просмотр профилей — Ищите посты, пользователей или хэштеги и получайте сведения о канале, профиле или странице.
- Сравнение метрик постов — Получите нормализованные просмотры, лайки, комментарии, репосты и вовлечённость для одного URL или до 10 URL.
- Проверка использования аккаунта — Запросите баланс кредитов, историю запросов или ежедневное использование.
Размещённый MCP-сервер
npx add-mcp 'https://api.captapi.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
Введение
Captapi предоставляет вам структурированные данные из публичных социальных сетей через единый согласованный REST API. Отправьте публичный URL из YouTube, TikTok, Instagram, Facebook и других платформ и получите чистый JSON — профили, публикации, транскрипты, AI-сводки, комментарии, результаты поиска и данные рекламных библиотек. Без OAuth, без SDK для каждой платформы, без инфраструктуры сбора данных, которую нужно поддерживать.
- • Один API-ключ работает на всех 33 платформах.
- • Передайте
cache=true, чтобы получать данные из общего 24-часового кэша (0 кредитов при попадании). По умолчанию данные всегда свежие. - • Оплата взимается только за успешные запросы.
Быстрый старт
После регистрации и копирования API-ключа из панели управления выполните свой первый запрос:
curl "https://api.captapi.com/v1/youtube/transcript?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
-H "Authorization: Bearer capt_live_..."
Машиночитаемые форматы: спецификация OpenAPI 3.1 (параметры, схемы ответов, ошибки, стоимость в кредитах для каждой конечной точки), однострочный список конечных точек и llms.txt.
Аутентификация
Все запросы аутентифицируются с помощью Bearer-токена. Создайте ключи в своей панели управления и передавайте их в заголовке Authorization. Храните ключи в секрете — никогда не раскрывайте ключи capt_live_ в клиентском коде.
Как альтернативу Authorization: Bearer можно передать тот же ключ в x-api-key: <key>.
Authorization: Bearer capt_live_xxxxxxxxxxxxxxxxxxxx
Выполнение запросов
Большинство конечных точек принимают параметр запроса url или q. Некоторым вместо этого нужен другой идентификатор — например, userId, username, repo, advertiser или comment_id. Точные параметры смотрите в документации каждой конечной точки. При построении строки запроса необходимо URL-кодировать значения URL, чтобы они не были ошибочно восприняты как несколько параметров.
# URL-encode the target URL before passing it
urlencode "https://youtube.com/watch?v=dQw4w9WgXcQ"
Формат ответа
Каждый ответ — это JSON с логическим значением верхнего уровня success и объектом data.
Успех
{
"success": true,
"data": {
"language": "en",
"segments": [
{ "start": 0.0, "end": 4.12, "text": "Hey everyone, welcome back." }
],
"text": "Hey everyone, welcome back."
}
}
Ошибка
HTTP/1.1 502 Bad Gateway
Retry-After: 60
{
"success": false,
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The upstream data source failed for this request. Retry shortly.",
"retryable": true
}
}
Заголовки ответа. X-Captapi-Credits — это списанные кредиты, X-Captapi-Cache равен 1 при попадании в кэш и 0 в противном случае, а X-Captapi-Request-Id идентифицирует вызов; указывайте его при обращении в поддержку. Server-Timing показывает общее время выполнения запроса в миллисекундах, например total;dur=4387.
Поле source. Конечные точки, которые могут отдавать данные более чем одним способом, включают source в data: native (собственная страница или API платформы), extended (более медленный резервный путь; некоторые конечные точки тарифицируют его иначе и указывают это на своей странице), cache (данные из 24-часового кэша), captions (транскрипт из опубликованных субтитров платформы) или asr (транскрипт, созданный распознаванием речи).
Устарело: поле timings. Объект timings в data будет удалён из тел ответов 2026-12-17. Вместо него читайте заголовок ответа Server-Timing.
Кредиты и кэширование
Кредиты — это единица биллинга. Стоимость определяется для каждой конечной точки (см. страницу документации каждой из них) — обычно 1–4 для простых запросов; многие конечные точки списков/поиска/комментариев стоят фиксированные 2 кредита за вызов, тогда как некоторые конечные точки списков по-прежнему масштабируются по количеству результатов (часто дороже). За неудачные запросы плата никогда не взимается.
Пустые результаты бесплатны. Вызов списка или поиска, который выполнился, но ничего не нашёл, стоит 0 кредитов, например поиск без совпадений, публикация без комментариев или страница за последним результатом. Заголовок ответа X-Captapi-Credits всегда показывает фактическую стоимость вызова.
Несколько конечных точек стоят дороже, когда вызов обслуживается более медленным резервным путём, например когда собственная страница платформы не загружается. На их страницах указаны правило и диапазон, который мы наблюдали: TikTok Song Details, LinkedIn Company Posts и TikTok Shop Products.
По умолчанию каждый запрос данных получает свежие данные (cache=false). Передайте cache=true, чтобы получать данные из общего 24-часового кэша ответов за 0 кредитов.
Ошибки
Ошибки возвращают статус вне диапазона 2xx и объект error со стабильным code, понятным человеку message и retryable. Повторяйте запрос только когда retryable равно true, после заголовка Retry-After. За неудачные запросы плата никогда не взимается. Сравнивайте code точно: регистр символов различается между кодами. В таблице перечислены распространённые коды; на страницах конечных точек указаны их специфические коды.
| Статус | Код | Повторяемый | Значение |
|---|---|---|---|
| 400 | BAD_REQUEST | false | Параметр отсутствует или недействителен, например URL с неверной платформы. Некоторые конечные точки используют более конкретный код, например HASHTAG_HAS_SPACES. |
| 400 | plaintext_not_allowed | false | API-ключ отправлен по http://. Смените ключ и повторите запрос через https:// — перенаправление не защищает первый переход. |
| 401 | UNAUTHORIZED | false | API-ключ отсутствует, недействителен или отозван. |
| 402 | insufficient_credits | false | Ваш баланс слишком мал для этого запроса. Плата не взимается. |
| 404 | NOT_FOUND | false | Целевой ресурс не существует или не является публичным. Некоторые конечные точки называют случай, например no_captions или PROFILE_NOT_FOUND. |
| 422 | VALIDATION_ERROR | false | Параметр не прошёл проверку. error.issues перечисляет каждое поле. |
| 429 | rate_limit_exceeded | true | Превышен лимит запросов в минуту для вашего тарифа. Дождитесь Retry-After. |
| 502 | UPSTREAM_UNAVAILABLE | true | Платформа дала сбой при обработке этого запроса. Повторите вскоре. |
| 503 | SERVICE_UNAVAILABLE | true | Временно недоступно. Некоторые конечные точки используют более конкретный код, например COMMUNITY_UNAVAILABLE. |
| 504 | UPSTREAM_TIMEOUT | true | Платформа не ответила вовремя. Повторите вскоре. |
Ограничения частоты запросов
Ограничения частоты запросов зависят от вашего тарифа и возвращаются в каждом ответе через заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. При превышении лимита вы получите 429 — сделайте паузу и повторите запрос после окончания окна сброса.
Справочник API
179 конечных точек в 36 группах. Нажмите на любую конечную точку, чтобы увидеть полные параметры, примеры и часто задаваемые вопросы.
YouTube и Shorts
TikTok
Instagram Reels
| Метод | Конечная точка | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/instagram/transcript | 2 | Транскрипт |
| GET | /v1/instagram/summarize | 4 | Суммаризатор |
| GET | /v1/instagram/details | 1 | Детали публикации и Reels |
| GET | /v1/instagram/comments | ~45 | Комментарии к публикации |
| GET | /v1/instagram/channel-details | 1 | Детали канала |
| GET | /v1/instagram/channel-posts | ~6 | Публикации канала |
| GET | /v1/instagram/channel-reels | ~6 | Reels канала |
| GET | /v1/instagram/reels-search | 2 | Поиск Reels |
| GET | /v1/instagram/trending-reels | 2 | Популярные Reels |
| GET | /v1/instagram/tagged-posts | 1 | Публикации с отметками |
| GET | /v1/instagram/reels-by-audio-id | ~28 | Reels по ID аудио |
| GET | /v1/instagram/hashtag-search | 2 | Поиск по хэштегу |
| GET | /v1/instagram/profile-search | 1 | Поиск профиля |
| GET | /v1/instagram/embed | 1 | HTML для встраивания |
| GET | /v1/instagram/highlights | 1 | Актуальные истории |
| GET | /v1/instagram/highlights-details | 1 | Детали актуальной истории |
| GET | /v1/instagram/basic-profile | 1 | Базовый профиль |
| Метод | Конечная точка | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/facebook/details | 2 | Детали публикации и Reels |
| GET | /v1/facebook/summarize | 4 | Суммаризатор |
| GET | /v1/facebook/comments | 2 | Комментарии |
| GET | /v1/facebook/page-details | 2 | Детали страницы |
| GET | /v1/facebook/profile-posts | 2 | Публикации профиля |
| GET | /v1/facebook/profile-reels | 2 | Reels профиля |
| GET | /v1/facebook/group-posts | ~20 | Публикации группы |
| GET | /v1/facebook/comment-replies | 2 | Ответы на комментарии |
| GET | /v1/facebook/profile-photos | 2 | Фотографии профиля |
Twitter / X
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/twitter/tweet-details | 1 | Детали твита |
| GET | /v1/twitter/transcript | 1 | Транскрипт |
| GET | /v1/twitter/profile | 1 | Профиль |
| GET | /v1/twitter/user-tweets | 2 | Твиты пользователя |
| GET | /v1/twitter/community | 1 | Сообщество |
| GET | /v1/twitter/community-tweets | 2 | Твиты сообщества |
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/reddit/subreddit-posts | 2 | Посты сабреддита |
| GET | /v1/reddit/post-details | 1 | Детали поста |
| GET | /v1/reddit/post-comments | 2 | Комментарии к посту |
| GET | /v1/reddit/post-transcript | 2 | Транскрипт поста |
| GET | /v1/reddit/search | 2 | Поиск |
| GET | /v1/reddit/subreddit-details | 1 | Детали сабреддита |
| GET | /v1/reddit/subreddit-search | 2 | Поиск постов в сабреддите |
Threads
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/threads/profile | 1 | Профиль |
| GET | /v1/threads/user-posts | 2 | Посты пользователя |
| GET | /v1/threads/post-details | 1 | Детали поста |
| GET | /v1/threads/search | 2 | Поиск постов |
| GET | /v1/threads/search-users | 1 | Поиск пользователей |
Bluesky
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/bluesky/profile | 1 | Профиль |
| GET | /v1/bluesky/user-posts | ~3 | Посты пользователя |
| GET | /v1/bluesky/post-details | 1 | Детали поста |
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/pinterest/pin-details | 1 | Детали пина |
| GET | /v1/pinterest/user-pins | ~13 | Пины пользователя |
| GET | /v1/pinterest/search | 2 | Поиск |
| GET | /v1/pinterest/board | ~13 | Доска |
| GET | /v1/pinterest/user-boards | ~13 | Доски пользователя |
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/linkedin/profile | 1 | Профиль |
| GET | /v1/linkedin/company | 2 | Компания |
| GET | /v1/linkedin/post-details | 1 | Детали поста |
| GET | /v1/linkedin/post-transcript | 1 | Транскрипт поста |
| GET | /v1/linkedin/company-posts | 1 | Посты компании |
| GET | /v1/linkedin/search-posts | ~16 | Поиск постов |
Rumble
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/rumble/video-details | 1 | Детали видео |
| GET | /v1/rumble/video/transcript | 1 | Транскрипт видео |
| GET | /v1/rumble/channel-videos | ~12 | Видео канала |
| GET | /v1/rumble/search | ~12 | Поиск |
| GET | /v1/rumble/comments | 2 | Комментарии |
TikTok Shop
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/tiktok-shop/shop-search | 2 | Поиск магазинов |
| GET | /v1/tiktok-shop/shop-products | 2 | Товары магазина |
| GET | /v1/tiktok-shop/product-details | 2 | Детали товара |
| GET | /v1/tiktok-shop/product-reviews | ~45 | Отзывы о товаре |
| GET | /v1/tiktok-shop/user-showcase | ~45 | Витрина пользователя |
Facebook Marketplace
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/facebook/marketplace-search | 2 | Поиск на Marketplace |
| GET | /v1/facebook/marketplace-location-search | 2 | Поиск по местоположению |
| GET | /v1/facebook/marketplace-item | 2 | Товар на Marketplace |
Facebook Events
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/facebook/event-search | 2 | Поиск событий |
| GET | /v1/facebook/event-details | 2 | Детали события |
| GET | /v1/facebook/profile-events | 2 | События профиля |
Facebook Ad Library
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/ad-library/facebook/search | 2 | Поиск |
| GET | /v1/ad-library/facebook/company-ads | 2 | Реклама компании |
| GET | /v1/ad-library/facebook/search-companies | 2 | Поиск компаний |
| GET | /v1/ad-library/facebook/ad-details | 2 | Детали объявления |
| GET | /v1/ad-library/facebook/ad-transcript | 2 | Текст объявления |
TikTok Ad Library
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/ad-library/tiktok/search | 2 | Поиск |
| GET | /v1/ad-library/tiktok/top-ads | 2 | Лучшие объявления |
| GET | /v1/ad-library/tiktok/ad-details | 2 | Детали объявления |
Google Ad Library
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/ad-library/google/company-ads | 2 | Реклама компании |
| GET | /v1/ad-library/google/ad-details | 2 | Детали объявления |
| GET | /v1/ad-library/google/advertiser-search | 1 | Поиск рекламодателей |
LinkedIn Ad Library
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/ad-library/linkedin/search-ads | 2 | Поиск объявлений |
| GET | /v1/ad-library/linkedin/ad-details | 2 | Детали объявления |
Amazon Seller Storefront
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/amazon-shop/page | 1 | Витрина продавца |
GitHub
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/github/user | 1 | Пользователь |
| GET | /v1/github/repositories | ~12 | Репозитории |
| GET | /v1/github/pull-requests | ~12 | Pull-запросы |
| GET | /v1/github/activity | ~12 | Активность |
| GET | /v1/github/followers | ~3 | Подписчики |
| GET | /v1/github/following | ~3 | Подписки |
| GET | /v1/github/contributions | 2 | Вклад |
| GET | /v1/github/repository | 1 | Репозиторий |
| GET | /v1/github/trending-repositories | 2 | В тренде |
| GET | /v1/github/trending-developers | 2 | Разработчики в тренде |
Twitch
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/twitch/profile | 1 | Профиль |
| GET | /v1/twitch/user-videos | 2 | Видео пользователя |
| GET | /v1/twitch/user-schedule | 1 | Расписание пользователя |
| GET | /v1/twitch/clip | 1 | Клип |
Spotify
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/spotify/artist | 1 | Исполнитель |
| GET | /v1/spotify/track | 1 | Трек |
| GET | /v1/spotify/album | 1 | Альбом |
| GET | /v1/spotify/search | 2 | Поиск |
| GET | /v1/spotify/podcast | 1 | Подкаст |
| GET | /v1/spotify/podcast-episodes | 2 | Эпизоды подкаста |
SoundCloud
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/soundcloud/artist | 1 | Исполнитель |
| GET | /v1/soundcloud/artist-tracks | 2 | Треки исполнителя |
| GET | /v1/soundcloud/track | 1 | Трек |
Linktree
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/linktree/page | 1 | Страница |
Snapchat
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/snapchat/user-profile | 1 | Профиль пользователя |
Truth Social
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/truth-social/profile | 1 | Профиль |
| GET | /v1/truth-social/user-posts | 2 | Посты пользователя |
| GET | /v1/truth-social/post | 1 | Пост |
Kick
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/kick/clip | 1 | Клип |
Аккаунт CaptAPI
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/account/balance | 0 | Баланс кредитов |
| GET | /v1/account/request-history | 0 | История запросов |
| GET | /v1/account/daily-usage | 0 | Ежедневное использование |
| GET | /v1/account/most-used-routes | 0 | Самые используемые маршруты |
Kwai
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/kwai/profile | 1 | Профиль |
| GET | /v1/kwai/user-posts | ~20 | Посты пользователя |
| GET | /v1/kwai/post | 2 | Пост |
Komi
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/komi/page | 1 | Страница |
Pillar
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/pillar/page | 1 | Страница |
Linkbio
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/linkbio/page | 1 | Страница |
Linkme
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/linkme/profile | 1 | Профиль |
Google Maps
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/google/business-search | 2 | Поиск компаний |
Кроссплатформенная аналитика
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| GET | /v1/analytics/post | 1 | Унифицированные метрики для одного поста/видео/рилса (платформа определяется автоматически) |
| GET | /v1/analytics/compare | 1/url | Сравнение унифицированных метрик по до 10 URL за один вызов |
Компаньон для чтения к инструментам публикации и планирования: передайте URL любого поддерживаемого поста, видео или рилса (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn или Rumble) и получите один нормализованный объект метрик — просмотры, лайки, комментарии, репосты, сохранения, взаимодействия и engagementRate — с автоматическим определением платформы. Поля, которые сеть не раскрывает, остаются null (у YouTube нет публичных счётчиков репостов и сохранений).
# Platform is auto-detected from the URL
curl "https://api.captapi.com/v1/analytics/post?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
-H "Authorization: Bearer capt_live_..."
# Compare several posts in one call (same metrics shape per URL)
curl "https://api.captapi.com/v1/analytics/compare?urls=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ,https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DjNQXAC9IVRw" \
-H "Authorization: Bearer capt_live_..."
Видеофайлы (прямая загрузка)
| Метод | Эндпоинт | Кредиты | Описание |
|---|---|---|---|
| POST | /v1/video/transcript | 1/мин | Распознавание речи из загруженного файла |
| POST | /v1/video/summarize | 1/мин +1 | Транскрипция загруженного файла + AI-резюме |
Интеграции
Используйте Captapi из AI-агентов, инструментов рабочих процессов, облачных сервисов или терминала — те же 179 эндпоинтов, без REST-обвязки.
[
MCP Server
Сервер Model Context Protocol, предоставляющий все 179 эндпоинтов как типизированные инструменты для Claude, Cursor, VS Code и любого MCP-агента.
](https://captapi.com/docs/integrations#mcp)[
CLI
Вызывайте каждый из 179 эндпоинтов из терминала, скриптов или CI — одна команда, JSON в stdout.
](https://captapi.com/docs/integrations#cli)[
n8n
Community-узел (n8n-nodes-captapi), который добавляет все 179 эндпоинтов в ваши рабочие процессы n8n.
](https://captapi.com/docs/integrations#n8n)
Готовы начать разработку?
Получите бесплатный API-ключ и сделайте первый вызов за 60 секунд.