API para TikTok: Busca de principais anúncios
Busque os principais anúncios em vídeo do TikTok Creative Center por palavra-chave, com filtros de objetivo de campanha, percentil de desempenho e janela de tempo.
US$ 1,20/mil req., pague por requisição, sem assinatura.
Top Ads Dashboard
Search results for "glasses"
Solstice Optics
Blue light glasses that actually block glare
18.4KCTR 4.12%
{"adId": "7431029384756102912","adTitle": "Blue light glasses that actually block glare","brandName": "Solstice Optics","cost": 8.7,"ctr": 0.0412,"likes": 18400,"industry": "apparel_accessories","objective": "conversions",... 5 campos a mais}
Preços
Preços do endpoint Busca de principais anúncios da API para TikTok
Teste
Obtenha Busca de principais anúncios do TikTok em uma só requisição
Este exemplo mostra 20 de 21 campos. Ver todos os campos
{
"found": true,
"data": {
"page": 1,
"pageSize": 3,
"total": 214,
"hasMore": true,
"ads": [
{
"adId": "7431029384756102912",
"adTitle": "Blue light glasses that actually block glare",
"brandName": "Solstice Optics",
"cost": 8.7,
"ctr": 0.0412,
"likes": 18400,
"industry": "apparel_accessories",
"objective": "conversions",
"durationSeconds": 22.5,
"width": 1080,
"height": 1920,
"videoUrl": "https://sf16-ies-music-va.tiktokcdn.com/obj/tos-useast5-ve-0068c001/solstice-ad-7431029384756102912?x-signature=Kj2f9pQmZs",
"image": "https://p16-ads-sign-va.tiktokcdn.com/tos-useast5-p-0068-va/solstice-cover-7431029384756102912~tplv-obj.image?x-signature=Q1w0eRtY2u"
},
{
"adId": "7431029384756118500",
"adTitle": "Try on 5 frames from your couch",
"brandName": "Frame Collective",
"cost": 6.3,
"ctr": 0.0356,
"likes": 9200,
"industry": "apparel_accessories",
"objective": "conversions",
"durationSeconds": 15.2,
"width": 1080,
"height": 1920,
"videoUrl": "https://sf16-ies-music-va.tiktokcdn.com/obj/tos-useast5-ve-0068c001/framecollective-ad-7431029384756118500?x-signature=A9c3dEfGh1",
"image": "https://p16-ads-sign-va.tiktokcdn.com/tos-useast5-p-0068-va/framecollective-cover-7431029384756118500~tplv-obj.image?x-signature=B2d4fGhIj3"
},
{
"adId": "7431029384756124800",
"adTitle": "These reading glasses fold flat",
"brandName": "Nella Vision",
"cost": 4.9,
"ctr": 0.0289,
"likes": 5600,
"industry": "apparel_accessories",
"objective": "conversions",
"durationSeconds": 18.8,
"width": 1080,
"height": 1920,
"videoUrl": "https://sf16-ies-music-va.tiktokcdn.com/obj/tos-useast5-ve-0068c001/nellavision-ad-7431029384756124800?x-signature=C5e6gHiJk4",
"image": "https://p16-ads-sign-va.tiktokcdn.com/tos-useast5-p-0068-va/nellavision-cover-7431029384756124800~tplv-obj.image?x-signature=D8f7hIjKl5"
}
]
}
}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.
- querystring
glasses
Palavra-chave para buscar nos principais anúncios em vídeo do TikTok Creative Center.
- limitinteger
3
Número máximo de anúncios solicitados para esta página, de 1 a 20 (padrão 20).
- objectiveenum
conversions
Filtro de objetivo de campanha. Omita para buscar em todos os objetivos.
- pageinteger
Número da página no provedor, a partir de 1 (padrão 1).
- performanceRankenum
top_1_20
Faixa de percentil de desempenho do anúncio, em que top_1_20 são os 20% de melhor desempenho. Omita para buscar em todas as faixas.
- periodenum
180
Período de retrospectiva em dias (padrão 180).
Resposta
JSON, um valor de exemplo por campo.
TikTok Creative Center top-ad records returned for this page. Populated whenever the provider has data for the entity.
- adIdstring
7431029384756102912
TikTok Creative Center ad material identifier. Populated whenever the provider has data for the entity.
- adTitlestring
Blue light glasses that actually block glare
Title or primary copy shown for the ad. Populated whenever the provider has data for the entity.
- brandNamestring
Solstice Optics
Advertiser brand name when supplied by TikTok Creative Center. Populated whenever the provider has data for the entity.
- costnumber
8.7
TikTok Creative Center's relative cost ranking value for the ad. Populated whenever the provider has data for the entity.
- ctrnumber
0.0412
TikTok Creative Center's click-through rate value for the ad. Populated whenever the provider has data for the entity.
- durationSecondsnumber
22.5
Video duration in seconds. Populated whenever the provider has data for the entity.
- heightinteger
1920
Video height in pixels. Populated whenever the provider has data for the entity.
- imagestring
https://p16-ads-sign-va.tiktokcdn.com/tos-useast5-p-0068-va/solstice-cover-7431029384756102912~tplv-obj.image?x-signature=Q1w0eRtY2u
Signed video cover image URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
- industrystring
apparel_accessories
TikTok Creative Center industry classification key. Populated whenever the provider has data for the entity.
- likesinteger
18400
Number of likes reported for the ad. Populated whenever the provider has data for the entity.
- objectivestring
conversions
TikTok Creative Center campaign objective key. Populated whenever the provider has data for the entity.
- videoUrlstring
https://sf16-ies-music-va.tiktokcdn.com/obj/tos-useast5-ve-0068c001/solstice-ad-7431029384756102912?x-signature=Kj2f9pQmZs
Signed 720p video asset URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
- widthinteger
1080
Video width in pixels. Populated whenever the provider has data for the entity.
Top-ad results and page metadata, or null when no matching ads were found.
- hasMoreboolean
true
Whether TikTok Creative Center reports another page of matching ads. Populated whenever the provider has data for the entity.
- pageinteger
1
One-based page number reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
- pageSizeinteger
3
Page size reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
- totalinteger
214
Total number of matching top ads reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
- foundboolean
true
True when TikTok Creative Center returned at least one matching top 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 principais anúncios da API para TikTok
O endpoint Busca de principais anúncios da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.top_ads_search. Busque os principais anúncios em vídeo do TikTok Creative Center por palavra-chave, com filtros de objetivo de campanha, percentil de desempenho e janela de tempo. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 77,0% das chamadas ao endpoint Busca de principais anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,1 segundos, em 13.060 chamadas medidas.