API para TikTok: Vídeos da hashtag
Liste vídeos recentes do TikTok de uma hashtag (criador, legenda, visualizações, curtidas, compartilhamentos).
Rede de provedores
Provedores ordenados por tráfego
com teto de US$ 0,0066 por requisição1 resultadoUS$ 0,0003310 resultadosUS$ 0,003320 resultadosUS$ 0,0066 (teto)Você paga pelo que volta. Reduza o limite para pagar menos - e nenhuma requisição custa mais que o teto, não importa quanto volte.
Teste
Faça sua primeira requisição
{
"data": {
"items": [
{
"authorHandle": "alex_rivera",
"authorImage": "https://example.com/image.jpg",
"authorName": "Alex Rivera",
"authorUserId": "Alex Rivera",
"authorVerified": true,
"collectCount": 12500,
"commentCount": 12500,
"createdUtc": 12.5,
"durationSeconds": 12.5,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"likeCount": 12500,
"playCount": 12500,
"shareCount": 13,
"text": "A short example description of this item.",
"url": "https://example.com/page",
"videoUrl": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}interface TiktokHashtagVideosResponse {
data: {
items: {
authorHandle?: string;
authorImage?: string;
authorName?: string;
authorUserId?: string;
authorVerified?: boolean;
collectCount?: number;
commentCount?: number;
createdUtc: number;
durationSeconds?: number;
id: string;
image?: string;
likeCount?: number;
playCount?: number;
shareCount?: number;
text?: string;
url: string;
videoUrl?: string;
}[];
} | 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 30dcurl -X POST https://api.getanyapi.com/v1/run/tiktok.hashtag_videos \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag":"cooking","limit":3}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| hashtag | string | "cooking"Hashtag do TikTok cujos vídeos buscar, sem o prefixo # (ex.: booktok). |
| limit | integer | 3Número máximo de resultados a retornar (1-20, padrão 20). |
| 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 `playCount`, 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 vídeo 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. Uma fonte que retorna só um valor arredondado ou abreviado de um campo não conta como fonte que retorna esse campo. |
| Resposta | ||
| data | object | |
| data.items | object[] | Recent TikTok video records for the hashtag. Populated whenever the provider has data for the entity. |
| data.items[].authorHandle | string | Username of the video's creator, without the @ prefix. Empty when the upstream omits it. |
| 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[].authorVerified | boolean | Whether the author's account carries a TikTok verification badge. |
| data.items[].collectCount | integer | Number of times the video was saved. |
| data.items[].commentCountpode ser exigido | integer | Number of comments on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].durationSeconds | number | Video duration in seconds. |
| data.items[].id | string | The video's numeric TikTok ID, as a string. Populated whenever the provider has data for the entity. |
| data.items[].image | string | URL of the video's cover/thumbnail image, with tracking query params stripped. Empty when the upstream omits it. |
| data.items[].likeCountpode ser exigido | integer | Number of likes on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].playCountpode ser exigido | integer | Number of views/plays of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].shareCountpode ser exigido | integer | Number of shares of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].text | string | The video caption text. Empty for videos with no caption. |
| data.items[].url | string | Canonical tiktok.com URL of the video, with tracking query params stripped. 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. |
| found | boolean | Whether any videos were returned for the hashtag. |
| 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,0008 |
| Preço /mil req. | USD | US$ 0,80 |
Dúvidas frequentes
Sobre o endpoint Vídeos da hashtag da API para TikTok
O endpoint Vídeos da hashtag da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.hashtag_videos. Liste vídeos recentes do TikTok de uma hashtag (criador, legenda, visualizações, curtidas, compartilhamentos). A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,80 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,4% das chamadas ao endpoint Vídeos da hashtag da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 17,9 segundos, em 168 chamadas medidas.