API para TikTok: Buscar principais resultados

Busque os principais resultados do TikTok para uma palavra-chave (legenda, visualizações, curtidas, comentários, compartilhamentos) com paginação por cursor.

POST/v1/run/tiktok.search_top

Disponibilidade

99,88%

30d · 1.667 chamadas

Requisições

1.667

30d · semanal, últimas 12 sem.

Resposta

4,1s

mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

ProvedoresParcela das chamadas

Giraffe1.212 atendidas99,67% de disponibilidade4222ms p5072,7%72,7%99,67% (1.216 chamadas)4222ms (1.212 chamadas)1.212US$ 1,20/mil req.preço fixo

BisonTentado primeiro452 atendidas91,50% de disponibilidade1369ms p5027,1%27,1%91,50% (494 chamadas)1369ms (452 chamadas)452US$ 0,90/mil req.preço fixo

Fox2 atendidas100,00% de disponibilidade2442ms p500,1%0,1%100,00% (2 chamadas)2442ms (2 chamadas)2US$ 3,60/mil req.preço fixo

Flamingo- atendidas- de disponibilidade- p50-----US$ 0,90/mil req.preço fixo

Teste

Faça sua primeira requisição

query*stringPalavra-chave a buscar (ex.: "funny").cursorstringCursor de paginação de uma resposta anterior.publishTimeenumFiltro de período: yesterday, this-week, this-month, last-3-months, last-6-months, all-time.regionstringCódigo de país de 2 letras para a localização do proxy (ex.: US, GB, FR).

requireFieldsarray

contentTypenextCursor

Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `nextCursor`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um registro que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.

sortByenumOrdenação: relevance, most-liked, date-posted.

Abrir emPrompt copiado

Obter chave grátis

Resposta de exemplo

Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.

{
  "data": {
    "items": [
      {
        "author": "Alex Rivera",
        "authorImage": "https://example.com/image.jpg",
        "authorName": "Alex Rivera",
        "authorUserId": "Alex Rivera",
        "caption": "A short example description of this item.",
        "comments": 12500,
        "contentType": "A short example description of this item.",
        "createdUtc": 12.5,
        "durationSeconds": 12.5,
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "likes": 12500,
        "saves": 42,
        "shares": 13,
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page",
        "views": 12500
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface TiktokSearchTopResponse {
  data: {
    items: {
      author: string;
      authorImage?: string;
      authorName?: string;
      authorUserId?: string;
      caption: string;
      comments: number;
      contentType: string | null;
      createdUtc?: number;
      durationSeconds?: number;
      id: string;
      image?: string;
      likes: number;
      saves?: number;
      shares: number;
      url: string;
      videoUrl?: string;
      views: number;
    }[];
    nextCursor: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d

POST /v1/run/tiktok.search_top

curl -X POST https://api.getanyapi.com/v1/run/tiktok.search_top \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"funny"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
query	string	"funny"Palavra-chave a buscar (ex.: "funny").
cursor	string	Cursor de paginação de uma resposta anterior.
publishTime	enum	Filtro de período: yesterday, this-week, this-month, last-3-months, last-6-months, all-time.
region	string	Código de país de 2 letras para a localização do proxy (ex.: US, GB, FR).
requireFields	array	Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `nextCursor`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um registro que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
sortBy	enum	Ordenação: relevance, most-liked, date-posted.
Resposta
data	object
data.items	object[]	Populated whenever the provider has data for the entity.
data.items[].author	string	Populated whenever the provider has data for the entity.
data.items[].authorImage	string	Author's avatar image URL. Signed and short-lived, so the query string is load-bearing and kept intact.
data.items[].authorName	string	Author's display name.
data.items[].authorUserId	string	Author's numeric TikTok user id.
data.items[].caption	string	Populated whenever the provider has data for the entity.
data.items[].comments	integer
data.items[].contentTypepode ser exigido	string	TikTok's own label for the post format, such as video, or null when the serving source does not report it.
data.items[].createdUtc	number	UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.items[].durationSeconds	number	Media duration in seconds.
data.items[].id	string	Populated whenever the provider has data for the entity.
data.items[].image	string	URL of the item's cover image. Signed and short-lived, so the query string is load-bearing and kept intact.
data.items[].likes	integer
data.items[].saves	integer
data.items[].shares	integer
data.items[].url	string	Populated whenever the provider has data for the entity.
data.items[].videoUrl	string	Playable video URL. Signed and short-lived, so the query string is load-bearing and kept intact.
data.items[].views	integer
data.nextCursorpode ser exigido	string	Opaque cursor for the next page of results, or null when this lane has no more. Pass it back as cursor to continue.
found	boolean
reason	"not_found"	Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisição	USD	US$ 0,0009
Preço /mil req.	USD	US$ 0,90

Dúvidas frequentes

Sobre o endpoint Buscar principais resultados da API para TikTok

O endpoint Buscar principais resultados da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.search_top. Busque os principais resultados do TikTok para uma palavra-chave (legenda, visualizações, curtidas, comentários, compartilhamentos) com paginação por cursor. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,90 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,9% das chamadas ao endpoint Buscar principais resultados da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,1 segundos, em 1.667 chamadas medidas.

Custa a partir de US$ 0,90 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque os principais resultados do TikTok para uma palavra-chave (legenda, visualizações, curtidas, comentários, compartilhamentos) com paginação por cursor. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,9% das chamadas ao endpoint Buscar principais resultados da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,1 segundos, em 1.667 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Mais para chamar

Outros endpoints de TikTok

Uma chave, uma carteira e
sua primeira chamada de TikTok.

Ganhe ~150 requisições grátis

API para TikTok: Buscar principais resultados

Provedores ordenados por tráfego

Faça sua primeira requisição

Requisição, resposta e preço

Sobre o endpoint Buscar principais resultados da API para TikTok

Quanto custa o endpoint Buscar principais resultados da API para TikTok?

O que o endpoint Buscar principais resultados da API para TikTok retorna?

Quão confiável é o endpoint Buscar principais resultados da API para TikTok?

Outros endpoints de TikTok

Uma chave, uma carteira esua primeira chamada de TikTok.

Uma chave, uma carteira e
sua primeira chamada de TikTok.