Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

1,000 a day

Pedidos da Research API permitidos por dia, para até 100,000 registos, com a quota reposta às 12 AM UTC.

30 days

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.

Top 200

/discovery/trending_list/ ordena as hashtags populares de um país e categoria nos últimos 1, 7, 30 ou 120 dias.

20

/discovery/trending/search/ devolve, para contas com Advanced Access ou uma Verified Business Account, as palavras-chave de pesquisa em tendência.

50 characters

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:

Research APIPublic videos by keyword, hashtag, username, region or date; approved researchers
Commercial Content APIAds by keyword or advertiser name, starting with ads data from the EU
Discovery endpointsPopular hashtags, their trending videos, and trending search keywords
Mentions endpointsUp to 1,000 recent public posts carrying the business's brand hashtags
Hashtag suggestion10 hashtags for a keyword, for the authorized account's captions
Display APINo search: an authorized user's profile and public videos

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:

A Research API video query, after TikTok's own example
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.

Hashtag suggestions from your own code
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.
Fazer isto com a EasyCoexistence

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