API de TikTok: Búsqueda de anuncios destacados
Busca los anuncios de video destacados de TikTok Creative Center por palabra clave, con filtros de objetivo de campaña, percentil de rendimiento y periodo.
US$1.20/1k solic., pagas por solicitud, sin suscripción.
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 más}
Precios
Precios del endpoint Búsqueda de anuncios destacados de la API de TikTok
Pruébalo
Obtén Búsqueda de anuncios destacados de TikTok en una sola solicitud
Este ejemplo muestra 20 de 21 campos. Ver todos los 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"
}
]
}
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- querystring
glasses
Palabra clave que buscar en los anuncios de video destacados de TikTok Creative Center.
- limitinteger
3
Número máximo de anuncios solicitados para esta página, de 1 a 20 (predeterminado 20).
- objectiveenum
conversions
Filtro de objetivo de campaña. Omítelo para buscar en todos los objetivos.
- pageinteger
Número de página del proveedor, empezando en uno (predeterminado 1).
- performanceRankenum
top_1_20
Grupo de percentil de rendimiento del anuncio, donde top_1_20 es el 20 por ciento de mayor rendimiento. Omítelo para buscar en todos los grupos.
- periodenum
180
Periodo hacia atrás en días (predeterminado 180).
Respuesta
JSON, un valor de ejemplo 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.
Preguntas frecuentes
Acerca del endpoint Búsqueda de anuncios destacados de la API de TikTok
El endpoint Búsqueda de anuncios destacados de AnyAPI para TikTok devuelve datos de TikTok como JSON normalizado con una sola llamada POST a /v1/run/tiktok.top_ads_search. Busca los anuncios de video destacados de TikTok Creative Center por palabra clave, con filtros de objetivo de campaña, percentil de rendimiento y periodo. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta desde US$1.20 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 77.0% de las llamadas al endpoint Búsqueda de anuncios destacados de la API de TikTok a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 1.1 segundos en 13.060 llamadas medidas.