TikTok Data Skill

O caminho de leitura determinístico para dados públicos do TikTok via UnifAPI. Este é um Data Skill: ele não executa um trabalho de marketing por conta própria — ele nomeia as operações tiktok/... concretas, os formatos de resposta e as pegadinhas, para que qualquer fluxo de trabalho voltado a criadores ou tendências (shortlisting, aderência de público, radar de demanda, buzz local) leia a partir de uma receita conhecida em vez de redescobrir a superfície a cada vez.

Somente leitura — olhos, não mãos. Ele pesquisa dados públicos do TikTok e retorna registros citados; ele nunca posta, comenta ou segue, e a UnifAPI nunca guarda credenciais do TikTok.

Use o skill unifapi para evidências ao vivo

Conecte-se uma vez através do skill compartilhado unifapi (OAuth MCP) e depois chame as operações abaixo. Usuários e vídeos do TikTok são indexados por id numérico — resolva primeiro um @handle ou uma URL de vídeo para o seu id (veja Pegadinhas). Preserve qualquer metadado de billing para que a saída possa informar o custo por registro.

Contrato de resposta

Endpoints de entidade única retornam o objeto em data:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

Endpoints de lista retornam um array em data mais pagination:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Quando pagination.has_more for verdadeiro, passe pagination.next_cursor como o cursor da próxima requisição (limit define o tamanho da página). Sempre preserve billing.

Operações principais

Precisa de um campo que não está listado aqui? Use o get_operation do skill unifapi para ler o schema exato antes de chamar — mas escolha a operação a partir desta tabela, não descubra às cegas.

Fluxo de trabalho

As receitas determinísticas. Escolha a que corresponde ao trabalho; cada uma nomeia exatamente o que chamar.

1. Descobrir por tópico. Chame tiktok/search/videos?q=..., tiktok/search/users?q=... ou tiktok/search/hashtags?q=... para o nicho; use tiktok/search?q=... para um resultado misto.
2. Resolver um criador. Chame tiktok/users/resolve?username=... para obter o id numérico e depois tiktok/users/{id} para follower_count, like_count e video_count.
3. Ler engajamento. Chame tiktok/users/{id}/videos; cada Video carrega view_count, like_count, comment_count e share_count — calcule o engajamento por vídeo. Pagine via next_cursor.
4. Ler um vídeo e sua reação. Chame tiktok/videos/{id} (resolva uma URL com tiktok/videos/resolve?url=... primeiro) e depois tiktok/videos/{id}/comments para o sentimento.
5. Rastrear tendências. Chame tiktok/hashtags/{id} para video_count/view_count e tiktok/hashtags/{id}/videos (ou tiktok/music/{id}/videos) para o que está se espalhando em uma tag ou som.
6. Mapear uma rede. Chame tiktok/users/{id}/followers, .../following ou .../likes para trabalho de alcance e afinidade.
7. Citar tudo. Cada número remete ao vídeo ou perfil de onde veio; informe billing.records_charged (ou estime quando o metadado de billing estiver ausente).

Notas de formato

• User — username, display_name, follower_count, following_count, like_count, video_count, is_verified, is_private, region.
• Video — video_description, view_count, like_count, comment_count, share_count, duration, author, music, hashtags, create_time.
• Hashtag — name, video_count, view_count, is_commerce.
• Music — title, author, is_original.

Pegadinhas

• Usuários e vídeos do TikTok são indexados por id numérico. Resolva um @handle com tiktok/users/resolve?username=... e uma URL de vídeo com tiktok/videos/resolve?url=... antes de qualquer chamada tiktok/users/{id}/... ou tiktok/videos/{id}/....
• tiktok/videos/batch é um POST (ids no corpo), não um GET — use-o para hidratar muitos ids de vídeo de uma vez.
• Um criador privado (is_private) limita o que você pode ler — sinalize isso.
• Um saldo baixo pode truncar silenciosamente as páginas de lista: verifique billing.truncated_due_to_balance — quando verdadeiro, a página está parcial, então recarregue antes de confiar em qualquer contagem.

Saída

Retorne os registros de que o fluxo de trabalho chamador precisa, cada um citado ao seu vídeo ou perfil, mais uma nota de custo de uma linha (records_charged). Quando este skill é usado diretamente, um resumo compacto do criador é o padrão:

**@handle** — {followers} followers, {videos} videos. Recent videos: avg {views} views / {likes} likes / {comments} comments. Rising tags: {#hashtags}. Evidence: {video URLs}. Records: ~{N}.

Skills relacionados

• creator-shortlist, audience-fit-check (Influencer Marketing) — faça shortlist e avalie criadores do TikTok sobre este caminho de leitura.
• social-listening-brief (Social Listening), treatment-demand-radar, menu-demand-radar, restaurant-local-buzz (verticais) — trabalho de tendências e demanda que lê o TikTok primeiro.
• unifapi — o data skill compartilhado: conecte o MCP e consulte os schemas exatos com get_operation.