Use dados públicos de TikTok, Instagram e YouTube em Skills de criadores e social listening: primeiro via MCP, via HTTP ao levar para produção.

Em resumo: este cookbook é para leitores em fase de implementação que precisam de registros de TikTok, Instagram e YouTube para pesquisa de criadores ou social listening sem construir três integrações.

A UnifAPI expõe os dados públicos de TikTok, Instagram e YouTube por meio de uma superfície MCP e HTTP compartilhada, precificada com créditos de $0.001. Este guia enquadra as primitivas comuns, a paginação e a matemática de custo para que um agent possa executar Skills de pesquisa de criadores e social listening sem uma GUI customizada.

A maioria dos fluxos de trabalho de dados públicos voltados ao consumidor — monitoramento de marca, pesquisa de criadores, análise de lançamento de produto, detecção de tendências — termina nas mesmas três plataformas: TikTok para vídeo curto, Instagram para social visual, YouTube para formato longo. Montar um feed estável das três historicamente significou três contratos de fornecedor e três envelopes diferentes. Com a UnifAPI, é um único servidor MCP e um único formato para o conjunto todo.

Quais endpoints você realmente precisa

Para a maioria dos fluxos de trabalho de agents, três primitivas bastam por plataforma: buscar por palavra-chave ou hashtag, buscar um único post ou vídeo por ID e listar posts recentes de um criador. Qualquer outra coisa — comentários, posts relacionados, contexto de seguidores — é detalhe de apoio que o agent pode expandir depois, uma vez que o conjunto principal esteja em mãos.

Na UnifAPI, esses mapeiam para: TikTok — /tiktok/search, /tiktok/videos/{id}, /tiktok/users/{id}/videos. YouTube — /youtube/search, /youtube/videos/{video_id}, /youtube/channels/{channel_id}/videos. Instagram — /instagram/search, /instagram/posts/{shortcode}, /instagram/users/{username}/posts. A nomenclatura se alinha intencionalmente entre as plataformas, de modo que o prompt do agent que aprendeu uma aprendeu as três.

O formato unificado de requisição

Todo endpoint HTTP aceita o mesmo header Authorization: Bearer <key> e retorna o mesmo envelope externo: { request_id, data, pagination?, billing }. Os campos dentro de data são específicos da plataforma (um vídeo do TikTok tem uma lista de hashtags, um vídeo do YouTube tem metadados de canal), mas o formato ao redor é consistente.

Essa uniformidade importa mais do que parece. Significa que o loop de uso de tools do seu agent tem uma única política de retry, um único handler de paginação, um único envelope de erro — não três. O conhecimento específico da plataforma fica dentro do campo data, onde o modelo pode vê-lo.

Paginação entre três plataformas

Cada plataforma pagina de forma diferente — o TikTok usa um token de cursor, o YouTube usa pageToken, o Instagram usa end_cursor. A UnifAPI normaliza esses sinais para um único objeto { cursor, has_more }. O loop do seu agent lê o cursor, passa-o de volta como o parâmetro de query cursor na próxima chamada, e para quando has_more vira false.

O tamanho de página padrão é 20 registros em todas as plataformas. O limite é 50. Para a maioria das execuções de agents, uma página basta — o modelo raramente precisa de mais do que os 20 principais resultados para tomar uma decisão.

Estimando o custo por execução de agent

O custo é registros × $0.001. Uma execução de "monitorar menções do TikTok à nossa marca nesta semana" que puxa 20 resultados de busca e então expande para buscar 5 vídeos individuais para transcrições é 25 registros — $0.025. Uma execução de "pesquisa de criador nesta conta" que puxa 50 posts recentes e 10 detalhes de vídeo é 60 registros — $0.06.

Uma regra de bolso que nos serviu bem: orce $0.05 por execução de agent para fluxos de trabalho de pesquisa típicos, e $0.20 para análises profundas. Só o bônus único de 2.000 créditos da primeira recarga cobre cerca de quarenta execuções leves.

Juntando tudo

Um agent de ponta a ponta para "encontrar o que está em alta sobre nós nesta semana nas três plataformas" se parece com: chamar em paralelo /tiktok/search, /instagram/search, /youtube/search com a palavra-chave da marca; coletar os 10 principais de cada; para os 3 principais de cada plataforma, expandir para /tiktok/videos/{id}, /instagram/posts/{shortcode} ou /youtube/videos/{video_id} para a transcrição ou legenda completa; passar o conjunto ao modelo com um prompt de sumarização.

Custo total: 30 registros de busca + 9 consultas de detalhe = 45 créditos, $0.045 — cada uma das três consultas de posts do Instagram cobra o mínimo de 3 créditos por chamada publicado no contrato OpenAPI. Contagem total de integrações: uma. Esse é o argumento — comece por uma Skill, conecte o servidor MCP em https://mcp.unifapi.com e faça login apenas quando o OAuth for necessário para chamadas de tools e créditos do workspace.

O que ler a seguir

Execute um agent de precificação de KOL com MCP - usa essas plataformas como enriquecimento de precificação de criadores.

Envelope de resposta unificado - explica como respostas multiplataforma permanecem comparáveis.

Catálogo de API - lista as operações de plataforma ao vivo.