Captapi

oficial

Dados públicos de redes sociais para agentes de IA: perfis, posts, comentários, transcrições e busca no TikTok, Instagram, YouTube, X, Facebook, Threads, Reddit e páginas de empresa do LinkedIn, além das bibliotecas de anúncios da Meta, Google, LinkedIn e TikTok.

Ver em captapi.com

O que você pode fazer com Captapi MCP?

  • Buscar transcrições — Peça a transcrição de um vídeo público do YouTube, TikTok, Instagram, Facebook ou X por URL.
  • Resumir conteúdo social — Solicite um resumo por IA de um vídeo, reel ou post nas plataformas compatíveis.
  • Obter comentários e respostas — Recupere comentários ou respostas de comentários de um determinado post ou vídeo.
  • Pesquisa e consulta de perfis — Pesquise posts, usuários ou hashtags e obtenha detalhes de canal, perfil ou página.
  • Comparar métricas de posts — Obtenha visualizações, curtidas, comentários, compartilhamentos e taxa de engajamento normalizados para uma URL ou até 10 URLs.
  • Verificar uso da conta — Consulte seu saldo de créditos, histórico de solicitações ou uso diário.

Servidor MCP hospedado

npx add-mcp 'https://api.captapi.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Introdução

O Captapi fornece a você dados estruturados de mídias sociais públicas por meio de uma única API REST consistente. Envie uma URL pública do YouTube, TikTok, Instagram, Facebook e muito mais e receba de volta um JSON limpo — perfis, publicações, transcrições, resumos por IA, comentários, resultados de busca e dados de biblioteca de anúncios. Sem OAuth, sem SDKs por plataforma, sem infraestrutura de coleta de dados para manter.

  • • Uma única chave de API funciona em todas as 33 plataformas.
  • • Passe cache=true para servir a partir do cache compartilhado de 24h (0 créditos em caso de acerto). O padrão é sempre dados atualizados.
  • • Você só é cobrado por requisições bem-sucedidas.

Início rápido

Depois de se cadastrar e copiar sua chave de API do painel, faça sua primeira requisição:

curl "https://api.captapi.com/v1/youtube/transcript?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer capt_live_..."

Legível por máquina: especificação OpenAPI 3.1 (parâmetros, esquemas de resposta, erros, custo em créditos por endpoint), lista de endpoints em uma linha e llms.txt.

Autenticação

Todas as requisições são autenticadas com um token Bearer. Gere chaves em seu painel e envie-as no cabeçalho Authorization. Mantenha as chaves em segredo — nunca exponha chaves capt_live_ em código do lado do cliente.

Como alternativa ao Authorization: Bearer, envie a mesma chave como x-api-key: <key>.

Authorization: Bearer capt_live_xxxxxxxxxxxxxxxxxxxx

Fazendo requisições

A maioria dos endpoints aceita um parâmetro de consulta url ou q. Alguns precisam de um identificador diferente — por exemplo userId, username, repo, advertiser ou comment_id. Consulte a documentação de cada endpoint para os parâmetros exatos. Ao construir uma string de consulta, você deve codificar em URL os valores de URL para que não sejam interpretados erroneamente como múltiplos parâmetros.

# URL-encode the target URL before passing it
urlencode "https://youtube.com/watch?v=dQw4w9WgXcQ"

Formato da resposta

Toda resposta é JSON com um booleano success de nível superior e um objeto data.

Sucesso

{
  "success": true,
  "data": {
    "language": "en",
    "segments": [
      { "start": 0.0, "end": 4.12, "text": "Hey everyone, welcome back." }
    ],
    "text": "Hey everyone, welcome back."
  }
}

Erro

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
  }
}

Cabeçalhos de resposta. X-Captapi-Credits é a quantidade de créditos cobrados, X-Captapi-Cache é 1 em caso de acerto no cache e 0 caso contrário, e X-Captapi-Request-Id identifica a chamada; inclua-o ao contatar o suporte. Server-Timing informa o tempo total que a requisição levou em milissegundos, por exemplo total;dur=4387.

O campo source. Endpoints que podem servir dados de mais de uma forma incluem source em data: native (a própria página ou API da plataforma), extended (um caminho alternativo mais lento; alguns endpoints o precificam de forma diferente e informam isso em sua página), cache (servido a partir do cache de 24h), captions (uma transcrição a partir das legendas publicadas pela plataforma) ou asr (transcrição produzida por reconhecimento de fala).

Obsoleto: o campo timings. O objeto timings em data será removido dos corpos de resposta em 2026-12-17. Leia o cabeçalho de resposta Server-Timing em vez disso.

Créditos e cache

Créditos são a unidade de cobrança. O custo é por endpoint (veja a página de documentação de cada um) — tipicamente 1–4 para consultas simples; muitos endpoints de listagem/busca/comentários têm um custo fixo de 2 créditos por chamada, enquanto alguns endpoints de listagem ainda escalam com os resultados (geralmente mais alto). Requisições com falha nunca são cobradas.

Resultados vazios são gratuitos. Uma chamada de listagem ou busca que foi executada mas não encontrou nada custa 0 créditos, por exemplo uma busca sem correspondências, uma publicação sem comentários ou uma página além do último resultado. O cabeçalho de resposta X-Captapi-Credits sempre mostra quanto uma chamada realmente custou.

Alguns endpoints custam mais quando um caminho alternativo mais lento atende a chamada, por exemplo quando a própria página da plataforma não carrega. Suas páginas informam a regra e a faixa que observamos: TikTok Song Details, LinkedIn Company Posts e TikTok Shop Products.

Por padrão, toda requisição de dados busca dados atualizados (cache=false). Passe cache=true para servir a partir do cache de respostas compartilhado de 24h com 0 créditos.

Erros

Erros retornam um status não-2xx e um objeto error com um code estável, um message legível por humanos e retryable. Tente novamente apenas quando retryable for verdadeiro, após o cabeçalho Retry-After. Requisições com falha nunca são cobradas. Compare com code exatamente: o uso de maiúsculas/minúsculas difere entre os códigos. A tabela lista os comuns; as páginas dos endpoints listam seus códigos específicos.

StatusCódigoRepetívelSignificado
400BAD_REQUESTfalseUm parâmetro está ausente ou é inválido, por exemplo uma URL da plataforma errada. Alguns endpoints usam um código mais específico, como HASHTAG_HAS_SPACES.
400plaintext_not_allowedfalseChave de API enviada por http://. Rotacione a chave e tente novamente com https:// — um redirecionamento não protege o primeiro salto.
401UNAUTHORIZEDfalseChave de API ausente, inválida ou revogada.
402insufficient_creditsfalseSeu saldo é insuficiente para esta requisição. Nada é cobrado.
404NOT_FOUNDfalseO recurso de destino não existe ou não é público. Alguns endpoints nomeiam o caso, por exemplo no_captions ou PROFILE_NOT_FOUND.
422VALIDATION_ERRORfalseUm parâmetro falhou na validação. error.issues lista cada campo.
429rate_limit_exceededtrueAcima do limite por minuto do seu plano. Aguarde o Retry-After.
502UPSTREAM_UNAVAILABLEtrueA plataforma falhou para esta requisição. Tente novamente em breve.
503SERVICE_UNAVAILABLEtrueTemporariamente indisponível. Alguns endpoints usam um código mais específico, por exemplo COMMUNITY_UNAVAILABLE.
504UPSTREAM_TIMEOUTtrueA plataforma não respondeu a tempo. Tente novamente em breve.

Limites de taxa

Os limites de taxa escalam com seu plano e são retornados em toda resposta por meio dos cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Quando você exceder o limite, receberá um 429 — recue e tente novamente após a janela de redefinição.

Referência da API

179 endpoints em 36 grupos. Clique em qualquer endpoint para ver parâmetros completos, exemplos e perguntas frequentes.

YouTube e Shorts

MétodoEndpointCréditosDescrição
GET/v1/youtube/transcript1Transcrição
GET/v1/youtube/audio-transcript2Transcrição de áudio
GET/v1/youtube/summarize3Resumidor
GET/v1/youtube/video-details1Detalhes do vídeo
GET/v1/youtube/comments2Comentários
GET/v1/youtube/channel-details1Detalhes do canal
GET/v1/youtube/search2Busca
GET/v1/youtube/channel-videos2Vídeos do canal
GET/v1/youtube/playlist-videos2Vídeos da playlist
GET/v1/youtube/playlist1Playlist
GET/v1/youtube/shorts/transcript1Transcrição de Shorts
GET/v1/youtube/shorts/summarize3Resumidor de Shorts
GET/v1/youtube/shorts/video-details1Estatísticas de Shorts
GET/v1/youtube/shorts/comments2Comentários de Shorts
GET/v1/youtube/channel-shorts2Shorts do canal
GET/v1/youtube/trending-shorts2Shorts em alta
GET/v1/youtube/channel-streams2Transmissões do canal
GET/v1/youtube/hashtag-search~20Busca por hashtag
GET/v1/youtube/comment-replies2Respostas a comentários
GET/v1/youtube/channel-playlists2Playlists do canal
GET/v1/youtube/community-posts1Publicações da comunidade
GET/v1/youtube/community-post-details1Detalhes da publicação da comunidade
GET/v1/youtube/video-sponsors0Patrocinadores do vídeo

TikTok

MétodoEndpointCréditosDescrição
GET/v1/tiktok/transcript2Transcrição
GET/v1/tiktok/summarize4Resumidor
GET/v1/tiktok/video-details1Detalhes do vídeo
GET/v1/tiktok/comments2Comentários
GET/v1/tiktok/channel-details1Detalhes do canal
GET/v1/tiktok/profile-region2Região do perfil
GET/v1/tiktok/audience-demographics3Dados demográficos da audiência
GET/v1/tiktok/search-suggestions2Sugestões de busca
GET/v1/tiktok/channel-posts2Publicações do canal
GET/v1/tiktok/comment-replies2Respostas a comentários
GET/v1/tiktok/user-followers1Seguidores do usuário
GET/v1/tiktok/user-followings1Usuários seguidos
GET/v1/tiktok/music-posts2Publicações com música
GET/v1/tiktok/top-search2Principais buscas
GET/v1/tiktok/search/hashtag~14Busca por hashtag
GET/v1/tiktok/search/users1Busca de usuários
GET/v1/tiktok/song-details1Detalhes da música
GET/v1/tiktok/trending-feed2Feed em alta
GET/v1/tiktok/popular-hashtags2Hashtags populares
GET/v1/tiktok/popular-songs2Músicas populares
GET/v1/tiktok/live1Ao vivo
GET/v1/tiktok/live-info1Informações ao vivo
GET/v1/tiktok/popular-creators2Criadores populares

Instagram Reels

MétodoEndpointCréditosDescrição
GET/v1/instagram/transcript2Transcrição
GET/v1/instagram/summarize4Resumidor
GET/v1/instagram/details1Detalhes de publicação e Reel
GET/v1/instagram/comments~45Comentários da publicação
GET/v1/instagram/channel-details1Detalhes do canal
GET/v1/instagram/channel-posts~6Publicações do canal
GET/v1/instagram/channel-reels~6Reels do canal
GET/v1/instagram/reels-search2Busca de Reels
GET/v1/instagram/trending-reels2Reels em alta
GET/v1/instagram/tagged-posts1Publicações marcadas
GET/v1/instagram/reels-by-audio-id~28Reels por ID de áudio
GET/v1/instagram/hashtag-search2Busca por hashtag
GET/v1/instagram/profile-search1Busca de perfis
GET/v1/instagram/embed1HTML de incorporação
GET/v1/instagram/highlights1Destaques
GET/v1/instagram/highlights-details1Detalhes do destaque
GET/v1/instagram/basic-profile1Perfil básico

Facebook

MétodoEndpointCréditosDescrição
GET/v1/facebook/details2Detalhes de publicação e Reel
GET/v1/facebook/summarize4Resumidor
GET/v1/facebook/comments2Comentários
GET/v1/facebook/page-details2Detalhes da página
GET/v1/facebook/profile-posts2Publicações do perfil
GET/v1/facebook/profile-reels2Reels do perfil
GET/v1/facebook/group-posts~20Publicações do grupo
GET/v1/facebook/comment-replies2Respostas a comentários
GET/v1/facebook/profile-photos2Fotos do perfil

Twitter / X

MétodoEndpointCréditosDescrição
GET/v1/twitter/tweet-details1Detalhes do Tweet
GET/v1/twitter/transcript1Transcrição
GET/v1/twitter/profile1Perfil
GET/v1/twitter/user-tweets2Tweets do Usuário
GET/v1/twitter/community1Comunidade
GET/v1/twitter/community-tweets2Tweets da Comunidade

Reddit

MétodoEndpointCréditosDescrição
GET/v1/reddit/subreddit-posts2Posts do Subreddit
GET/v1/reddit/post-details1Detalhes do Post
GET/v1/reddit/post-comments2Comentários do Post
GET/v1/reddit/post-transcript2Transcrição do Post
GET/v1/reddit/search2Pesquisa
GET/v1/reddit/subreddit-details1Detalhes do Subreddit
GET/v1/reddit/subreddit-search2Pesquisar Posts em um Subreddit

Threads

MétodoEndpointCréditosDescrição
GET/v1/threads/profile1Perfil
GET/v1/threads/user-posts2Posts do Usuário
GET/v1/threads/post-details1Detalhes do Post
GET/v1/threads/search2Pesquisa de Posts
GET/v1/threads/search-users1Pesquisar Usuários

Bluesky

MétodoEndpointCréditosDescrição
GET/v1/bluesky/profile1Perfil
GET/v1/bluesky/user-posts~3Posts do Usuário
GET/v1/bluesky/post-details1Detalhes do Post

Pinterest

MétodoEndpointCréditosDescrição
GET/v1/pinterest/pin-details1Detalhes do Pin
GET/v1/pinterest/user-pins~13Pins do Usuário
GET/v1/pinterest/search2Pesquisa
GET/v1/pinterest/board~13Board
GET/v1/pinterest/user-boards~13Boards do Usuário

LinkedIn

MétodoEndpointCréditosDescrição
GET/v1/linkedin/profile1Perfil
GET/v1/linkedin/company2Empresa
GET/v1/linkedin/post-details1Detalhes do Post
GET/v1/linkedin/post-transcript1Transcrição do Post
GET/v1/linkedin/company-posts1Posts da Empresa
GET/v1/linkedin/search-posts~16Pesquisar Posts

Rumble

MétodoEndpointCréditosDescrição
GET/v1/rumble/video-details1Detalhes do Vídeo
GET/v1/rumble/video/transcript1Transcrição do Vídeo
GET/v1/rumble/channel-videos~12Vídeos do Canal
GET/v1/rumble/search~12Pesquisa
GET/v1/rumble/comments2Comentários

TikTok Shop

MétodoEndpointCréditosDescrição
GET/v1/tiktok-shop/shop-search2Pesquisa de Lojas
GET/v1/tiktok-shop/shop-products2Produtos da Loja
GET/v1/tiktok-shop/product-details2Detalhes do Produto
GET/v1/tiktok-shop/product-reviews~45Avaliações do Produto
GET/v1/tiktok-shop/user-showcase~45Vitrine do Usuário

Facebook Marketplace

MétodoEndpointCréditosDescrição
GET/v1/facebook/marketplace-search2Pesquisa no Marketplace
GET/v1/facebook/marketplace-location-search2Pesquisa por Localização
GET/v1/facebook/marketplace-item2Item do Marketplace

Facebook Events

MétodoEndpointCréditosDescrição
GET/v1/facebook/event-search2Pesquisa de Eventos
GET/v1/facebook/event-details2Detalhes do Evento
GET/v1/facebook/profile-events2Eventos do Perfil

Facebook Ad Library

MétodoEndpointCréditosDescrição
GET/v1/ad-library/facebook/search2Pesquisa
GET/v1/ad-library/facebook/company-ads2Anúncios da Empresa
GET/v1/ad-library/facebook/search-companies2Pesquisar Empresas
GET/v1/ad-library/facebook/ad-details2Detalhes do Anúncio
GET/v1/ad-library/facebook/ad-transcript2Texto do Anúncio

TikTok Ad Library

MétodoEndpointCréditosDescrição
GET/v1/ad-library/tiktok/search2Pesquisa
GET/v1/ad-library/tiktok/top-ads2Principais Anúncios
GET/v1/ad-library/tiktok/ad-details2Detalhes do Anúncio

Google Ad Library

MétodoEndpointCréditosDescrição
GET/v1/ad-library/google/company-ads2Anúncios da Empresa
GET/v1/ad-library/google/ad-details2Detalhes do Anúncio
GET/v1/ad-library/google/advertiser-search1Pesquisa de Anunciantes

LinkedIn Ad Library

MétodoEndpointCréditosDescrição
GET/v1/ad-library/linkedin/search-ads2Pesquisar Anúncios
GET/v1/ad-library/linkedin/ad-details2Detalhes do Anúncio

Amazon Seller Storefront

MétodoEndpointCréditosDescrição
GET/v1/amazon-shop/page1Vitrine do Vendedor

GitHub

MétodoEndpointCréditosDescrição
GET/v1/github/user1Usuário
GET/v1/github/repositories~12Repositórios
GET/v1/github/pull-requests~12Pull Requests
GET/v1/github/activity~12Atividade
GET/v1/github/followers~3Seguidores
GET/v1/github/following~3Seguindo
GET/v1/github/contributions2Contribuições
GET/v1/github/repository1Repositório
GET/v1/github/trending-repositories2Em Alta
GET/v1/github/trending-developers2Desenvolvedores em Alta

Twitch

MétodoEndpointCréditosDescrição
GET/v1/twitch/profile1Perfil
GET/v1/twitch/user-videos2Vídeos do Usuário
GET/v1/twitch/user-schedule1Agenda do Usuário
GET/v1/twitch/clip1Clipe

Spotify

MétodoEndpointCréditosDescrição
GET/v1/spotify/artist1Artista
GET/v1/spotify/track1Faixa
GET/v1/spotify/album1Álbum
GET/v1/spotify/search2Pesquisa
GET/v1/spotify/podcast1Podcast
GET/v1/spotify/podcast-episodes2Episódios do Podcast

SoundCloud

MétodoEndpointCréditosDescrição
GET/v1/soundcloud/artist1Artista
GET/v1/soundcloud/artist-tracks2Faixas do Artista
GET/v1/soundcloud/track1Faixa

Linktree

MétodoEndpointCréditosDescrição
GET/v1/linktree/page1Página

Snapchat

MétodoEndpointCréditosDescrição
GET/v1/snapchat/user-profile1Perfil do Usuário

Truth Social

MétodoEndpointCréditosDescrição
GET/v1/truth-social/profile1Perfil
GET/v1/truth-social/user-posts2Posts do Usuário
GET/v1/truth-social/post1Post

Kick

MétodoEndpointCréditosDescrição
GET/v1/kick/clip1Clipe

Conta CaptAPI

MétodoEndpointCréditosDescrição
GET/v1/account/balance0Saldo de Créditos
GET/v1/account/request-history0Histórico de Requisições
GET/v1/account/daily-usage0Uso Diário
GET/v1/account/most-used-routes0Rotas Mais Usadas

Kwai

MétodoEndpointCréditosDescrição
GET/v1/kwai/profile1Perfil
GET/v1/kwai/user-posts~20Posts do Usuário
GET/v1/kwai/post2Post

Komi

MétodoEndpointCréditosDescrição
GET/v1/komi/page1Página

Pillar

MétodoEndpointCréditosDescrição
GET/v1/pillar/page1Página

Linkbio

MétodoEndpointCréditosDescrição
GET/v1/linkbio/page1Página

Linkme

MétodoEndpointCréditosDescrição
GET/v1/linkme/profile1Perfil

Google Maps

MétodoEndpointCréditosDescrição
GET/v1/google/business-search2Pesquisa de Empresas

Análises entre Plataformas

MétodoEndpointCréditosDescrição
GET/v1/analytics/post1Métricas unificadas para um post/vídeo/reel (plataforma detectada automaticamente)
GET/v1/analytics/compare1/urlCompare métricas unificadas entre até 10 URLs em uma única chamada

O complemento de leitura para ferramentas de publicação e agendamento: passe qualquer URL de post, vídeo ou reel compatível (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn ou Rumble) e receba um único objeto de métricas normalizado — visualizações, curtidas, comentários, compartilhamentos, salvamentos, interações e engagementRate — com a plataforma detectada automaticamente. Campos que uma rede não expõe permanecem nulos (o YouTube não tem contagens públicas de compartilhamentos/salvamentos).

# 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_..."

Arquivos de Vídeo (upload direto)

MétodoEndpointCréditosDescrição
POST/v1/video/transcript1/minTranscrição de fala para texto de um arquivo enviado
POST/v1/video/summarize1/min +1Transcrever um arquivo enviado + resumo por IA

Integrações

Use o Captapi a partir de agentes de IA, ferramentas de fluxo de trabalho, atores de nuvem ou seu terminal — os mesmos 179 endpoints, sem complicações de REST.

Ver todas as integrações

[

Servidor MCP

Servidor Model Context Protocol que expõe todos os 179 endpoints como ferramentas tipadas para Claude, Cursor, VS Code e qualquer agente MCP.

](https://captapi.com/docs/integrations#mcp)[

CLI

Chame cada um dos 179 endpoints a partir do seu terminal, scripts ou CI — um comando, JSON na saída padrão.

](https://captapi.com/docs/integrations#cli)[

n8n

Nó da comunidade (n8n-nodes-captapi) que traz todos os 179 endpoints para seus fluxos de trabalho no n8n.

](https://captapi.com/docs/integrations#n8n)

Pronto para construir?

Pegue sua chave de API gratuita e faça sua primeira chamada em 60 segundos.

Obtenha sua chave de API