A API do TikTok consegue buscar vídeos, hashtags ou tendências?
Sim, a API do TikTok consegue buscar vídeos, anúncios e tendências, cada um em uma API separada: a Research API busca vídeos públicos por palavra-chave, hashtag, nome de usuário, região ou data, para pesquisadores que o TikTok aprova. A Commercial Content API busca anúncios por palavra-chave ou nome do anunciante. A API for Business retorna hashtags populares, seus vídeos em alta e as palavras-chave de busca em alta. A Display API lê o perfil e os vídeos do próprio usuário autorizado.
O easyCoexistence conecta contas do TikTok pela API for Business do TikTok, para que Claude, ChatGPT ou sua própria plataforma listem as publicações e os comentários da conta e leiam seus insights, e get_social_credentials entrega ao seu próprio código o token para endpoints business/, como as sugestões de hashtags, com cada conexão monitorada 24 horas por dia.
Requisições da Research API permitidas por dia, para até 100,000 registros, com a cota reiniciada à meia-noite UTC.
Maior intervalo entre start_date e end_date em uma consulta de vídeos da Research API, que retorna até 100 vídeos por requisição.
/discovery/trending_list/ classifica as hashtags populares de um país e de uma categoria nos últimos 1, 7, 30 ou 120 dias.
/discovery/trending/search/ retorna palavras-chave de busca em alta, para contas com Advanced Access ou uma Verified Business Account.
Maior search_term aceito pela Commercial Content API, comparado como frase exata por padrão ou como frase aproximada.
Qual API do TikTok pode buscar?
Várias, em dois portais de desenvolvedor, cada um voltado a um tipo diferente de desenvolvedor. developers.tiktok.com hospeda a Research API, a Commercial Content API e a Display API; business-api.tiktok.com hospeda a API for Business, cujos endpoints Discovery, Accounts e Mentions cobrem tendências e o conteúdo da própria empresa:
Como a Research API busca vídeos?
Com POST https://open.tiktokapis.com/v2/research/video/query/ e um access token de cliente com o escopo research.data.basic. O objeto query combina condições and, or e not, cada uma uma operação como EQ ou IN sobre um campo como keyword, hashtag_name, username, region_code, create_date ou video_length. start_date e end_date, escritos YYYYMMDD, podem ter no máximo 30 dias de diferença entre si, e max_count retorna até 100 vídeos por requisição:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'O que a Research API retorna, e quão atualizados estão os dados?
Os campos de vídeo públicos listados em fields, como id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names e username. A FAQ do TikTok alerta que estatísticas como contagens de visualizações e de seguidores podem levar até 10 dias para ser atualizadas, e que vídeos novos podem levar até 48 horas para aparecer na busca. A cota diária é de 1,000 requisições, com até 100,000 registros entre as APIs de pesquisa, reiniciada à meia-noite UTC.
Quem pode usar a Research API?
Pesquisadores cujo projeto o TikTok aprova; uma conta de desenvolvedor sozinha não concede acesso. O TikTok lista instituições acadêmicas nos EUA, no EEE, no Reino Unido, no Canadá ou na Suíça, organizações de pesquisa sem fins lucrativos ou independentes na UE e organizações acadêmicas ou sem fins lucrativos no Brasil que estudem a segurança de jovens online. Os candidatos atuam de forma independente de interesses comerciais, com uma proposta de pesquisa definida, financiamento divulgado e avaliação ética, e o TikTok costuma responder em até 4 semanas. Perguntada se criadores, anunciantes e usuários comerciais são elegíveis, a FAQ responde que não.
Como buscar anúncios com a Commercial Content API?
Com POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ e o escopo research.adlib.basic. search_term aceita até 50 caracteres, comparados como exact_phrase por padrão ou como fuzzy_phrase, que encontra qualquer uma ou todas as suas palavras, em qualquer ordem. Filtros refinam os resultados por datas de publicação e países-alvo, e cada chamada retorna no máximo 10 anúncios. A página de produto do TikTok diz que os dados começam com anúncios da UE e ficam disponíveis até um ano depois da última exibição de um anúncio. O público em geral e pesquisadores de qualquer país podem solicitar acesso por formulário online, e o TikTok espera responder em até 2 dias úteis.
Quais tendências a API for Business retorna?
As de seus endpoints Discovery, que diferem pelo token que recebem. /discovery/trending_list/ classifica até 200 hashtags populares de um país, por padrão os EUA, e uma categoria de setor, nos últimos 1, 7, 30 ou 120 dias, com a posição, as visualizações e as publicações de cada hashtag. /discovery/video_list/ retorna os 20 principais vídeos em alta de até 10 dessas hashtags. Ambos recebem um advertiser_id e o access token de um anunciante. Outros dois recebem o token de uma conta do TikTok com o escopo discovery.search.words, para contas com Advanced Access ou uma Verified Business Account:
- /discovery/trending/search/: 20 palavras-chave de busca em alta no TikTok, ou personalizadas para a conta com
is_personalized. - /discovery/trending/search/keyword/: 20 palavras-chave de busca recomendadas para uma consulta de até 255 caracteres, como um produto ou uma marca.
O que a API própria de uma conta do TikTok pode buscar?
Hashtags para legendas e publicações que usam as hashtags de marca da empresa. GET /business/hashtag/suggestion/ recebe uma palavra-chave e um idioma opcional e retorna 10 hashtags, ordenadas primeiro por correspondência exata e depois pelo número de publicações, cada uma com seu post_count. O endpoint Mentions /business/mention/hashtag/video/list/ retorna até 1,000 publicações públicas dos últimos 90 dias que usam uma das hashtags de marca habilitadas pela empresa, até 50 delas, ordenadas por data, curtidas, comentários ou compartilhamentos. Exige o escopo biz.brand.insights e uma conta com Advanced Access ou uma Verified Business Account.
A Display API pode buscar?
Não. Ela lê o usuário que autorizou o app: /v2/user/info/ retorna o perfil desse usuário, /v2/video/list/ seus vídeos públicos, do mais recente ao mais antigo e até 20 por página, e /v2/video/query/ vídeos específicos por ID, sob os escopos user.info.basic e video.list. Nenhum de seus endpoints recebe uma palavra-chave ou uma hashtag.
O que o easyCoexistence pode buscar no TikTok?
O que a API própria da conta conectada responde. list_social_posts lista as publicações recentes da conta e list_social_comments os comentários de uma publicação, enquanto o seu próprio código chama caminhos da API for Business em business/ com o token de get_social_credentials, incluindo as sugestões de hashtags. Os caminhos /discovery/ recebem o token de um anunciante, então o token da conta não os alcança, e a Research API e a Commercial Content API são produtos separados do developers.tiktok.com, com aplicações próprias.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Erros comuns
- Pedir acesso à Research API para acompanhar uma marca. A FAQ do TikTok responde não a criadores, anunciantes e usuários comerciais, e aprova apenas projetos de pesquisa não comerciais.
- Consultar um período longo em uma única chamada da Research API. end_date pode estar no máximo 30 dias depois de start_date, então divida períodos maiores em janelas.
- Tratar sugestões de hashtags como tendências. /business/hashtag/suggestion/ ordena por correspondência exata e número de publicações, enquanto /discovery/trending_list/ classifica a popularidade em um período escolhido.
- Chamar os endpoints de buscas em alta para uma conta pessoal. Eles respondem para contas com Advanced Access ou uma Verified Business Account, com discovery.search.words no token.
De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Posso buscar vídeos do TikTok por palavra-chave pela API?
Com a Research API, depois que o TikTok aprova seu projeto de pesquisa: sua consulta de vídeos aceita condições de keyword e hashtag_name sobre vídeos públicos, até 100 por requisição.
Existe uma API do TikTok para hashtags em alta?
Sim. /discovery/trending_list/ na API for Business classifica até 200 hashtags populares de um país e categoria, cada uma com suas visualizações e publicações, para o token de um anunciante.
Existe uma API do TikTok para vídeos em alta?
Sim. /discovery/video_list/ na API for Business retorna os 20 principais vídeos em alta de até 10 hashtags populares, com um advertiser_id e o access token de um anunciante.
A API do TikTok consegue encontrar comentários que mencionam minha conta?
Sim, para contas com Advanced Access ou uma Verified Business Account: /business/mention/comment/list/ da Mentions API retorna até 1,000 comentários ou respostas que marcam a conta com @, sob os escopos biz.brand.insights e comment.list.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em