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 точно: регистр символов различается между кодами. В таблице перечислены распространённые коды; на страницах конечных точек указаны их специфические коды.

СтатусКодПовторяемыйЗначение
400BAD_REQUESTfalseПараметр отсутствует или недействителен, например URL с неверной платформы. Некоторые конечные точки используют более конкретный код, например HASHTAG_HAS_SPACES.
400plaintext_not_allowedfalseAPI-ключ отправлен по http://. Смените ключ и повторите запрос через https:// — перенаправление не защищает первый переход.
401UNAUTHORIZEDfalseAPI-ключ отсутствует, недействителен или отозван.
402insufficient_creditsfalseВаш баланс слишком мал для этого запроса. Плата не взимается.
404NOT_FOUNDfalseЦелевой ресурс не существует или не является публичным. Некоторые конечные точки называют случай, например no_captions или PROFILE_NOT_FOUND.
422VALIDATION_ERRORfalseПараметр не прошёл проверку. error.issues перечисляет каждое поле.
429rate_limit_exceededtrueПревышен лимит запросов в минуту для вашего тарифа. Дождитесь Retry-After.
502UPSTREAM_UNAVAILABLEtrueПлатформа дала сбой при обработке этого запроса. Повторите вскоре.
503SERVICE_UNAVAILABLEtrueВременно недоступно. Некоторые конечные точки используют более конкретный код, например COMMUNITY_UNAVAILABLE.
504UPSTREAM_TIMEOUTtrueПлатформа не ответила вовремя. Повторите вскоре.

Ограничения частоты запросов

Ограничения частоты запросов зависят от вашего тарифа и возвращаются в каждом ответе через заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. При превышении лимита вы получите 429 — сделайте паузу и повторите запрос после окончания окна сброса.

Справочник API

179 конечных точек в 36 группах. Нажмите на любую конечную точку, чтобы увидеть полные параметры, примеры и часто задаваемые вопросы.

YouTube и Shorts

МетодКонечная точкаКредитыОписание
GET/v1/youtube/transcript1Транскрипт
GET/v1/youtube/audio-transcript2Аудиотранскрипт
GET/v1/youtube/summarize3Суммаризатор
GET/v1/youtube/video-details1Детали видео
GET/v1/youtube/comments2Комментарии
GET/v1/youtube/channel-details1Детали канала
GET/v1/youtube/search2Поиск
GET/v1/youtube/channel-videos2Видео канала
GET/v1/youtube/playlist-videos2Видео плейлиста
GET/v1/youtube/playlist1Плейлист
GET/v1/youtube/shorts/transcript1Транскрипт Shorts
GET/v1/youtube/shorts/summarize3Суммаризатор Shorts
GET/v1/youtube/shorts/video-details1Статистика Shorts
GET/v1/youtube/shorts/comments2Комментарии Shorts
GET/v1/youtube/channel-shorts2Shorts канала
GET/v1/youtube/trending-shorts2Популярные Shorts
GET/v1/youtube/channel-streams2Трансляции канала
GET/v1/youtube/hashtag-search~20Поиск по хэштегу
GET/v1/youtube/comment-replies2Ответы на комментарии
GET/v1/youtube/channel-playlists2Плейлисты канала
GET/v1/youtube/community-posts1Публикации сообщества
GET/v1/youtube/community-post-details1Детали публикации сообщества
GET/v1/youtube/video-sponsors0Спонсоры видео

TikTok

МетодКонечная точкаКредитыОписание
GET/v1/tiktok/transcript2Транскрипт
GET/v1/tiktok/summarize4Суммаризатор
GET/v1/tiktok/video-details1Детали видео
GET/v1/tiktok/comments2Комментарии
GET/v1/tiktok/channel-details1Детали канала
GET/v1/tiktok/profile-region2Регион профиля
GET/v1/tiktok/audience-demographics3Демография аудитории
GET/v1/tiktok/search-suggestions2Поисковые подсказки
GET/v1/tiktok/channel-posts2Публикации канала
GET/v1/tiktok/comment-replies2Ответы на комментарии
GET/v1/tiktok/user-followers1Подписчики пользователя
GET/v1/tiktok/user-followings1Подписки пользователя
GET/v1/tiktok/music-posts2Публикации с музыкой
GET/v1/tiktok/top-search2Топ поиска
GET/v1/tiktok/search/hashtag~14Поиск по хэштегу
GET/v1/tiktok/search/users1Поиск пользователей
GET/v1/tiktok/song-details1Детали песни
GET/v1/tiktok/trending-feed2Лента популярного
GET/v1/tiktok/popular-hashtags2Популярные хэштеги
GET/v1/tiktok/popular-songs2Популярные песни
GET/v1/tiktok/live1Прямой эфир
GET/v1/tiktok/live-info1Информация о прямом эфире
GET/v1/tiktok/popular-creators2Популярные авторы

Instagram Reels

МетодКонечная точкаКредитыОписание
GET/v1/instagram/transcript2Транскрипт
GET/v1/instagram/summarize4Суммаризатор
GET/v1/instagram/details1Детали публикации и Reels
GET/v1/instagram/comments~45Комментарии к публикации
GET/v1/instagram/channel-details1Детали канала
GET/v1/instagram/channel-posts~6Публикации канала
GET/v1/instagram/channel-reels~6Reels канала
GET/v1/instagram/reels-search2Поиск Reels
GET/v1/instagram/trending-reels2Популярные Reels
GET/v1/instagram/tagged-posts1Публикации с отметками
GET/v1/instagram/reels-by-audio-id~28Reels по ID аудио
GET/v1/instagram/hashtag-search2Поиск по хэштегу
GET/v1/instagram/profile-search1Поиск профиля
GET/v1/instagram/embed1HTML для встраивания
GET/v1/instagram/highlights1Актуальные истории
GET/v1/instagram/highlights-details1Детали актуальной истории
GET/v1/instagram/basic-profile1Базовый профиль

Facebook

МетодКонечная точкаКредитыОписание
GET/v1/facebook/details2Детали публикации и Reels
GET/v1/facebook/summarize4Суммаризатор
GET/v1/facebook/comments2Комментарии
GET/v1/facebook/page-details2Детали страницы
GET/v1/facebook/profile-posts2Публикации профиля
GET/v1/facebook/profile-reels2Reels профиля
GET/v1/facebook/group-posts~20Публикации группы
GET/v1/facebook/comment-replies2Ответы на комментарии
GET/v1/facebook/profile-photos2Фотографии профиля

Twitter / X

МетодЭндпоинтКредитыОписание
GET/v1/twitter/tweet-details1Детали твита
GET/v1/twitter/transcript1Транскрипт
GET/v1/twitter/profile1Профиль
GET/v1/twitter/user-tweets2Твиты пользователя
GET/v1/twitter/community1Сообщество
GET/v1/twitter/community-tweets2Твиты сообщества

Reddit

МетодЭндпоинтКредитыОписание
GET/v1/reddit/subreddit-posts2Посты сабреддита
GET/v1/reddit/post-details1Детали поста
GET/v1/reddit/post-comments2Комментарии к посту
GET/v1/reddit/post-transcript2Транскрипт поста
GET/v1/reddit/search2Поиск
GET/v1/reddit/subreddit-details1Детали сабреддита
GET/v1/reddit/subreddit-search2Поиск постов в сабреддите

Threads

МетодЭндпоинтКредитыОписание
GET/v1/threads/profile1Профиль
GET/v1/threads/user-posts2Посты пользователя
GET/v1/threads/post-details1Детали поста
GET/v1/threads/search2Поиск постов
GET/v1/threads/search-users1Поиск пользователей

Bluesky

МетодЭндпоинтКредитыОписание
GET/v1/bluesky/profile1Профиль
GET/v1/bluesky/user-posts~3Посты пользователя
GET/v1/bluesky/post-details1Детали поста

Pinterest

МетодЭндпоинтКредитыОписание
GET/v1/pinterest/pin-details1Детали пина
GET/v1/pinterest/user-pins~13Пины пользователя
GET/v1/pinterest/search2Поиск
GET/v1/pinterest/board~13Доска
GET/v1/pinterest/user-boards~13Доски пользователя

LinkedIn

МетодЭндпоинтКредитыОписание
GET/v1/linkedin/profile1Профиль
GET/v1/linkedin/company2Компания
GET/v1/linkedin/post-details1Детали поста
GET/v1/linkedin/post-transcript1Транскрипт поста
GET/v1/linkedin/company-posts1Посты компании
GET/v1/linkedin/search-posts~16Поиск постов

Rumble

МетодЭндпоинтКредитыОписание
GET/v1/rumble/video-details1Детали видео
GET/v1/rumble/video/transcript1Транскрипт видео
GET/v1/rumble/channel-videos~12Видео канала
GET/v1/rumble/search~12Поиск
GET/v1/rumble/comments2Комментарии

TikTok Shop

МетодЭндпоинтКредитыОписание
GET/v1/tiktok-shop/shop-search2Поиск магазинов
GET/v1/tiktok-shop/shop-products2Товары магазина
GET/v1/tiktok-shop/product-details2Детали товара
GET/v1/tiktok-shop/product-reviews~45Отзывы о товаре
GET/v1/tiktok-shop/user-showcase~45Витрина пользователя

Facebook Marketplace

МетодЭндпоинтКредитыОписание
GET/v1/facebook/marketplace-search2Поиск на Marketplace
GET/v1/facebook/marketplace-location-search2Поиск по местоположению
GET/v1/facebook/marketplace-item2Товар на Marketplace

Facebook Events

МетодЭндпоинтКредитыОписание
GET/v1/facebook/event-search2Поиск событий
GET/v1/facebook/event-details2Детали события
GET/v1/facebook/profile-events2События профиля

Facebook Ad Library

МетодЭндпоинтКредитыОписание
GET/v1/ad-library/facebook/search2Поиск
GET/v1/ad-library/facebook/company-ads2Реклама компании
GET/v1/ad-library/facebook/search-companies2Поиск компаний
GET/v1/ad-library/facebook/ad-details2Детали объявления
GET/v1/ad-library/facebook/ad-transcript2Текст объявления

TikTok Ad Library

МетодЭндпоинтКредитыОписание
GET/v1/ad-library/tiktok/search2Поиск
GET/v1/ad-library/tiktok/top-ads2Лучшие объявления
GET/v1/ad-library/tiktok/ad-details2Детали объявления

Google Ad Library

МетодЭндпоинтКредитыОписание
GET/v1/ad-library/google/company-ads2Реклама компании
GET/v1/ad-library/google/ad-details2Детали объявления
GET/v1/ad-library/google/advertiser-search1Поиск рекламодателей

LinkedIn Ad Library

МетодЭндпоинтКредитыОписание
GET/v1/ad-library/linkedin/search-ads2Поиск объявлений
GET/v1/ad-library/linkedin/ad-details2Детали объявления

Amazon Seller Storefront

МетодЭндпоинтКредитыОписание
GET/v1/amazon-shop/page1Витрина продавца

GitHub

МетодЭндпоинтКредитыОписание
GET/v1/github/user1Пользователь
GET/v1/github/repositories~12Репозитории
GET/v1/github/pull-requests~12Pull-запросы
GET/v1/github/activity~12Активность
GET/v1/github/followers~3Подписчики
GET/v1/github/following~3Подписки
GET/v1/github/contributions2Вклад
GET/v1/github/repository1Репозиторий
GET/v1/github/trending-repositories2В тренде
GET/v1/github/trending-developers2Разработчики в тренде

Twitch

МетодЭндпоинтКредитыОписание
GET/v1/twitch/profile1Профиль
GET/v1/twitch/user-videos2Видео пользователя
GET/v1/twitch/user-schedule1Расписание пользователя
GET/v1/twitch/clip1Клип

Spotify

МетодЭндпоинтКредитыОписание
GET/v1/spotify/artist1Исполнитель
GET/v1/spotify/track1Трек
GET/v1/spotify/album1Альбом
GET/v1/spotify/search2Поиск
GET/v1/spotify/podcast1Подкаст
GET/v1/spotify/podcast-episodes2Эпизоды подкаста

SoundCloud

МетодЭндпоинтКредитыОписание
GET/v1/soundcloud/artist1Исполнитель
GET/v1/soundcloud/artist-tracks2Треки исполнителя
GET/v1/soundcloud/track1Трек

Linktree

МетодЭндпоинтКредитыОписание
GET/v1/linktree/page1Страница

Snapchat

МетодЭндпоинтКредитыОписание
GET/v1/snapchat/user-profile1Профиль пользователя

Truth Social

МетодЭндпоинтКредитыОписание
GET/v1/truth-social/profile1Профиль
GET/v1/truth-social/user-posts2Посты пользователя
GET/v1/truth-social/post1Пост

Kick

МетодЭндпоинтКредитыОписание
GET/v1/kick/clip1Клип

Аккаунт CaptAPI

МетодЭндпоинтКредитыОписание
GET/v1/account/balance0Баланс кредитов
GET/v1/account/request-history0История запросов
GET/v1/account/daily-usage0Ежедневное использование
GET/v1/account/most-used-routes0Самые используемые маршруты

Kwai

МетодЭндпоинтКредитыОписание
GET/v1/kwai/profile1Профиль
GET/v1/kwai/user-posts~20Посты пользователя
GET/v1/kwai/post2Пост

Komi

МетодЭндпоинтКредитыОписание
GET/v1/komi/page1Страница

Pillar

МетодЭндпоинтКредитыОписание
GET/v1/pillar/page1Страница

Linkbio

МетодЭндпоинтКредитыОписание
GET/v1/linkbio/page1Страница

Linkme

МетодЭндпоинтКредитыОписание
GET/v1/linkme/profile1Профиль

Google Maps

МетодЭндпоинтКредитыОписание
GET/v1/google/business-search2Поиск компаний

Кроссплатформенная аналитика

МетодЭндпоинтКредитыОписание
GET/v1/analytics/post1Унифицированные метрики для одного поста/видео/рилса (платформа определяется автоматически)
GET/v1/analytics/compare1/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/transcript1/минРаспознавание речи из загруженного файла
POST/v1/video/summarize1/мин +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 секунд.

Получить API-ключ