Avaliação de criador com transcrições
Crie um brief de uma página sobre um criador a partir de dados públicos: quem ele é em cada plataforma, com que frequência publica, o desempenho de suas postagens recentes, com quais marcas já trabalha e o que diz em vídeo.
O que isso pode e não pode dizer
- Apenas dados públicos e sem login. Contas privadas, dados demográficos da audiência, pontuações de autenticidade de seguidores e DMs não estão disponíveis — diga isso; nunca os invente.
- A taxa de engajamento aqui é
(curtidas + comentários) / seguidoresnas postagens coletadas. É um sinal aproximado de uma pequena amostra, não uma métrica auditada. - Alguns números são arredondados pela plataforma (ex.: "1,2M"); mantenha os sinalizadores
...IsApproximateda resposta e mostre "≈" para eles. - As transcrições vêm da fala no vídeo (TikTok, Instagram) ou legendas publicadas (YouTube). Uma transcrição ausente significa que não há fala ou legendas, não que o criador não disse nada que valha a pena verificar.
Entradas a coletar primeiro
- As URLs ou handles de perfil do criador no TikTok, Instagram e/ou YouTube. Não adivinhe handles entre plataformas — pergunte ou marque a plataforma como "não fornecida".
- Quantas postagens recentes por plataforma (padrão 10) e quantas transcrições (padrão 3 vídeos mais recentes por plataforma).
- Com o que a marca se importa: concorrentes a procurar, tópicos a evitar.
Estimativa de créditos — mostre antes de executar
Por criador, com padrões (10 postagens, 3 transcrições por plataforma):
| Plataforma | Chamadas | Créditos |
|---|---|---|
| TikTok | /v1/tiktok/channel-details 1 · /v1/tiktok/channel-posts 2 · 3 × /v1/tiktok/transcript 2 | 9 |
/v1/instagram/channel-details 1 · /v1/instagram/channel-posts (0.3 por postagem, 10 postagens = 3) · 3 × /v1/instagram/transcript 2 | 10 | |
| YouTube | /v1/youtube/channel-details 1 · /v1/youtube/channel-videos 2 · 3 × /v1/youtube/transcript 1 · /v1/youtube/video-sponsors 0 | 6 |
Todas as três plataformas: cerca de 25 créditos por criador; até ~35 com mais postagens ou transcrições. Imprima a estimativa para os criadores solicitados, verifique GET /v1/account/balance (gratuito) e peça confirmação ao usuário.
Como chamar a Captapi
- MCP:
tiktok_channel_details,tiktok_channel_posts,tiktok_transcript,instagram_channel_details,instagram_channel_posts,instagram_transcript,youtube_channel_details,youtube_channel_videos,youtube_transcript,youtube_video_sponsors. - REST:
GET https://api.captapi.com<path>?url=<URL do perfil ou vídeo>com cabeçalhoAuthorization: Bearer $CAPTAPI_API_KEY.
Chamadas com falha custam 0 créditos. Um 403 como profile_restricted ou um 404 é uma resposta final para aquela plataforma — registre e siga em frente.
Etapas
Para cada plataforma que o usuário forneceu:
- Perfil —
channel-detailscom a URL do perfil. Mantenha seguidores, seguindo, contagem de postagens, biografia, links da biografia, sinalizador de verificado, tipo de conta. - Postagens recentes —
tiktok/channel-posts,instagram/channel-postsouyoutube/channel-videoscomlimit=<N>. A partir das linhas, calcule: postagens por semana no período, mediana de visualizações (quando presente), mediana de curtidas e comentários, taxa de engajamento, e a melhor e pior postagem. - Sinais de patrocinador das mesmas linhas:
- Linhas do Instagram carregam
isPaidPartnership; liste essas postagens e as marcas que mencionam. - TikTok e YouTube: examine legendas/títulos por
#ad,#sponsored, "paid partnership", códigos de desconto e @menções de marcas. - YouTube:
youtube/video-sponsors?url=<URL do vídeo>para cada vídeo transcrito retorna segmentos de patrocinadores enviados pela comunidade (gratuito). Rotule-os como relatados pela comunidade.
- Linhas do Instagram carregam
- Transcrições — para os vídeos mais recentes,
tiktok/transcript,instagram/transcriptouyoutube/transcriptcom a URL do vídeo. Leia-as em busca de: produtos e marcas mencionados, menções a concorrentes, alegações que exigiriam comprovação (saúde, finanças) e linguagem ou tópicos que a marca listou como proibidos.
Formato do brief
- Tabela de visão geral: uma linha por plataforma — handle, seguidores, postagens/semana, mediana de visualizações, taxa de engajamento, verificado. Cada célula rastreável até seu endpoint.
- Patrocinadores anteriores: marca, plataforma, data da postagem, link e como foi detectado (
isPaidPartnership, tag na legenda, segmento da comunidade). - O que eles dizem: 3–5 marcadores extraídos das transcrições, cada um com uma breve citação e o link do vídeo.
- Bandeiras
[precisa de revisão humana]: trabalho com concorrentes, alegações arriscadas, tópicos proibidos, saltos repentinos de seguidores entre dados de perfil e postagens. - Lacunas: plataformas não fornecidas, restritas ou sem transcrições.
- Total de créditos da execução.
Onde um humano deve revisar
- Cada bandeira — transcrições podem ser mal interpretadas e o contexto é importante.
- Se um "patrocinador" detectado foi pago ou apenas uma menção.
- Adequação à marca: o brief fornece evidências, não um veredito de contratar ou não contratar.