API para TikTok: Busca de transparência de anúncios
Busque na Commercial Content Library da UE do TikTok por palavra-chave ou ID do anunciante.
US$ 0,80/mil req., pague por requisição, sem assinatura.
Ad target country
DEAdvertiser name or keyword
nikeSearch results
Total ads: 58
Nike
video · first shown Sep 11, 2025 · last shown Sep 27, 2025
{"id": "7649102384710103041","advertiserName": "Nike","status": "active","format": "video","firstShownUtc": 1757548800,"lastShownUtc": 1758931200,"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-video.mp4","image": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-cover.jpeg",... 2 campos a mais}
Preços
Preços do endpoint Busca de transparência de anúncios da API para TikTok
Teste
Obtenha Busca de transparência de anúncios do TikTok em uma só requisição
Este exemplo mostra 18 de 19 campos. Ver todos os campos
{
"found": true,
"data": {
"nextCursor": "eyJvZmZzZXQiOjIwfQ==",
"hasMore": true,
"total": 58,
"offset": 0,
"region": "DE",
"ads": [
{
"id": "7649102384710103041",
"advertiserName": "Nike",
"status": "active",
"format": "video",
"firstShownUtc": 1757548800,
"lastShownUtc": 1758931200,
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-video.mp4",
"image": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-cover.jpeg",
"adTitle": "Just Do It: Air Max Pulse",
"estimatedAudience": "1M-2M"
},
{
"id": "7649110056118763521",
"advertiserName": "Nike",
"status": "active",
"format": "video",
"firstShownUtc": 1757462400,
"lastShownUtc": 1758844800,
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649110056118763521~tplv-ad-video.mp4",
"image": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649110056118763521~tplv-ad-cover.jpeg",
"adTitle": "Nike Training Club: 30 days free",
"estimatedAudience": "500K-1M"
}
]
}
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- advertiserIdstring
ID do anunciante na Commercial Content Library do TikTok. Informe advertiserId ou query.
- cursorstring
Cursor de busca vindo do nextCursor de uma resposta anterior.
- daysinteger
30
Número de dias de histórico da Commercial Content Library a buscar, de 1 a 365. O padrão é 30.
- limitinteger
20
Maximum number of ads to return, from 1 to 50. Defaults to 50. Billing is flat per request.
- offsetinteger
Deslocamento dos resultados, a partir de zero. O padrão é 0.
- querystring
nike
Palavra-chave para buscar na Commercial Content Library da UE do TikTok. Informe query ou advertiserId.
- regionstring
DE
Código de região para a busca de transparência. O padrão é DE.
- sortstring
Expressão de ordenação do upstream. O padrão é last_shown_date,desc.
Resposta
JSON, um valor de exemplo por campo.
Commercial Content Library ad records returned for the search. Populated whenever the provider has data for the entity.
- adTitlestring
Just Do It: Air Max Pulse
Ad title as shown in TikTok's ad library.
- advertiserNamestring
Nike
Advertiser display name associated with the ad. Populated whenever the provider has data for the entity.
- estimatedAudiencestring
1M-2M
Estimated audience size band the ad reached, as a range string.
- firstShownUtcnumber
1757548800
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown. Populated whenever the provider has data for the entity.
- formatstring
video
Commercial Content Library creative format code for the ad. Populated whenever the provider has data for the entity.
- idstring
7649102384710103041
TikTok Commercial Content Library ad identifier. Populated whenever the provider has data for the entity.
- imagestring
https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-cover.jpeg
Signed cover image URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
- lastShownUtcnumber
1758931200
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown. Populated whenever the provider has data for the entity.
- statusstring
active
Commercial Content Library audit status code for the ad. Populated whenever the provider has data for the entity.
- videoUrlstring
https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7649102384710103041~tplv-ad-video.mp4
Signed video asset URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
Ad transparency search results and pagination, or null when no ads were found.
- hasMoreboolean
true
Whether the Commercial Content Library reports more matching ads. Populated whenever the provider has data for the entity.
- nextCursorstring
eyJvZmZzZXQiOjIwfQ==
Search cursor to pass as cursor on a subsequent request, or null when there is no next page. Populated whenever the provider has data for the entity.
- offsetinteger
0
Zero-based result offset reported for this page.
- regionstring
DE
Region code applied to this transparency search. Populated whenever the provider has data for the entity.
- totalinteger
58
Total number of matching ads reported by the Commercial Content Library. Populated whenever the provider has data for the entity.
- foundboolean
true
True when TikTok's EU Commercial Content Library returned at least one ad.
- 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.
Dúvidas frequentes
Sobre o endpoint Busca de transparência de anúncios da API para TikTok
O endpoint Busca de transparência de anúncios da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.ad_transparency_search. Busque na Commercial Content Library da UE do TikTok por palavra-chave ou ID do anunciante. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. 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, 94,1% das chamadas ao endpoint Busca de transparência de anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,3 segundos, em 4.688 chamadas medidas.