A API do TikTok consegue pesquisar vídeos, hashtags ou tendências?
Sim, a API do TikTok pode pesquisar vídeos, anúncios e tendências, cada um numa API separada: a Research API pesquisa vídeos públicos por palavra-chave, hashtag, nome de utilizador, região ou data, para investigadores aprovados pelo TikTok. A Commercial Content API pesquisa anúncios por palavra-chave ou nome do anunciante. A API for Business devolve as hashtags populares, os respetivos vídeos em tendência e as palavras-chave de pesquisa em tendência. A Display API lê o perfil e os vídeos do próprio utilizador autorizado.
O easyCoexistence liga contas do TikTok através da API for Business do TikTok, para que o Claude, o ChatGPT ou a sua própria plataforma listem as publicações e os comentários da conta e leiam as métricas, e get_social_credentials dá ao seu próprio código o token para endpoints business/, como as sugestões de hashtags, com cada ligação vigiada permanentemente.
Pedidos da Research API permitidos por dia, para até 100,000 registos, com a quota reposta às 12 AM UTC.
Intervalo mais longo entre start_date e end_date numa consulta de vídeos da Research API, que devolve até 100 vídeos por pedido.
/discovery/trending_list/ ordena as hashtags populares de um país e categoria nos últimos 1, 7, 30 ou 120 dias.
/discovery/trending/search/ devolve, para contas com Advanced Access ou uma Verified Business Account, as palavras-chave de pesquisa em tendência.
search_term mais longo que a Commercial Content API aceita, comparado como frase exata por defeito ou como frase aproximada.
Que API do TikTok pode pesquisar?
Várias, em dois portais de programadores, cada um destinado a um tipo diferente de programador. developers.tiktok.com aloja a Research API, a Commercial Content API e a Display API; business-api.tiktok.com aloja a API for Business, cujos endpoints Discovery, Accounts e Mentions cobrem tendências e os conteúdos da própria empresa:
Como é que a Research API pesquisa vídeos?
Com POST https://open.tiktokapis.com/v2/research/video/query/ e um token de acesso de cliente com o âmbito 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, escritas em YYYYMMDD, podem ter no máximo 30 dias de diferença, e max_count devolve até 100 vídeos por pedido:
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 devolve a Research API e quão atualizada está?
Os campos públicos de vídeo indicados 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 avisa que estatísticas como o número de visualizações e de seguidores podem demorar até 10 dias a atualizar, e que os vídeos novos podem demorar até 48 horas a aparecer na pesquisa. A quota diária é de 1,000 pedidos, até 100,000 registos em todas as APIs de investigação, reposta às 12 AM UTC.
Quem pode usar a Research API?
Investigadores cujo projeto o TikTok aprova; uma conta de programador, por si só, não dá acesso. O TikTok indica instituições académicas nos EUA, no EEE, no Reino Unido, no Canadá ou na Suíça, organismos de investigação sem fins lucrativos ou independentes na UE, e organizações académicas ou sem fins lucrativos no Brasil que estudem a segurança dos jovens em linha. Os candidatos trabalham de forma independente de interesses comerciais, com uma proposta de investigação definida, financiamento divulgado e uma avaliação ética, e o TikTok costuma responder em 4 semanas. Quando se pergunta se criadores, anunciantes e utilizadores comerciais são elegíveis, a FAQ responde que não.
Como se pesquisam anúncios com a Commercial Content API?
Com POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ e o âmbito research.adlib.basic. search_term aceita até 50 caracteres, comparados como exact_phrase por defeito ou como fuzzy_phrase, que encontra qualquer ou todas as palavras em qualquer ordem; os filtros limitam os resultados por datas de publicação e países-alvo, e cada chamada devolve 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 se mantêm disponíveis até um ano depois de um anúncio ter sido mostrado pela última vez. O público e os investigadores de qualquer país podem candidatar-se através de um formulário em linha, e o TikTok prevê responder em 2 dias úteis.
Que tendências devolve a API for Business?
As dos seus endpoints Discovery, que diferem consoante o token que recebem. /discovery/trending_list/ ordena até 200 hashtags populares de um país, os EUA por defeito, e de uma categoria setorial, nos últimos 1, 7, 30 ou 120 dias, com a posição, as visualizações e as publicações de cada hashtag, e /discovery/video_list/ devolve os 20 vídeos em tendência mais relevantes de até 10 dessas hashtags; ambos recebem um advertiser_id e um token de acesso de anunciante. Dois outros recebem o token de uma conta do TikTok com o âmbito discovery.search.words, para contas com Advanced Access ou uma Verified Business Account:
- /discovery/trending/search/: 20 palavras-chave de pesquisa em tendência no TikTok, ou personalizadas para a conta com
is_personalized. - /discovery/trending/search/keyword/: 20 palavras-chave de pesquisa recomendadas para uma consulta de até 255 caracteres, como um produto ou uma marca.
O que consegue pesquisar a API própria de uma conta do TikTok?
Hashtags para as suas legendas, e publicações que levam as suas hashtags de marca. GET /business/hashtag/suggestion/ recebe uma palavra-chave e um idioma opcional e devolve 10 hashtags, ordenadas por correspondência exata e depois pelo número de publicações, cada uma com o seu post_count. O endpoint Mentions /business/mention/hashtag/video/list/ devolve até 1,000 publicações públicas dos últimos 90 dias que usam uma das hashtags de marca ativadas pela empresa, até 50 delas, ordenadas por data, gostos, comentários ou partilhas. Exige o âmbito biz.brand.insights e uma conta com Advanced Access ou uma Verified Business Account.
A Display API consegue pesquisar?
Não. Lê o utilizador que autorizou a aplicação: /v2/user/info/ devolve o perfil desse utilizador, /v2/video/list/ os seus vídeos públicos, do mais recente para o mais antigo e até 20 por página, e /v2/video/query/ vídeos específicos pelo ID, com os âmbitos user.info.basic e video.list. Nenhum dos seus endpoints recebe uma palavra-chave ou uma hashtag.
O que consegue o easyCoexistence pesquisar no TikTok?
O que a API própria da conta ligada 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 sob business/ com o token de get_social_credentials, incluindo as sugestões de hashtags. Os caminhos /discovery/ recebem o token de um anunciante, pelo que o token da conta não os alcança, e as APIs Research e Commercial Content são produtos separados do developers.tiktok.com, com candidaturas 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
- Candidatar-se à Research API para acompanhar uma marca. A FAQ do TikTok responde que não a criadores, anunciantes e utilizadores comerciais, e aprova projetos de investigação não comerciais.
- Consultar um período longo numa única chamada da Research API. end_date pode ficar no máximo 30 dias depois de start_date, por isso divida os períodos mais longos em janelas.
- Ler as 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/ ordena por popularidade num período escolhido.
- Chamar os endpoints de pesquisa em tendência para uma conta pessoal. Respondem a contas com Advanced Access ou uma Verified Business Account, com discovery.search.words no token.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso pesquisar vídeos do TikTok por palavra-chave através da API?
Com a Research API, depois de o TikTok aprovar o seu projeto de investigação: a consulta de vídeos aceita condições de keyword e hashtag_name sobre vídeos públicos, até 100 por pedido.
Existe uma API do TikTok para hashtags em tendência?
Sim. /discovery/trending_list/ da API for Business ordena até 200 hashtags populares de um país e categoria, cada uma com as suas visualizações e publicações, com o token de um anunciante.
Existe uma API do TikTok para vídeos em tendência?
Sim. /discovery/video_list/ da API for Business devolve os 20 vídeos em tendência mais relevantes de até 10 hashtags populares, com um advertiser_id e um token de acesso de anunciante.
A API do TikTok consegue encontrar comentários que mencionam a minha conta?
Sim, para contas com Advanced Access ou uma Verified Business Account: o /business/mention/comment/list/ da Mentions API devolve até 1,000 comentários ou respostas que a mencionam com @, ao abrigo dos âmbitos biz.brand.insights e comment.list.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em