TikTok Ad Library Search
TikTok Ad Library Search envía una consulta por nombre de anunciante o palabra clave a la biblioteca pública de anuncios y sigue su cursor opaco hasta alcanzar el límite solicitado, alineado a páginas, o una condición de parada del origen. Sirve para la investigación de transparencia y el descubrimiento de anuncios, no para la gestión de campañas privadas ni la medición de rendimiento.
Funcionalidades de la TikTok Ad Library Search API
- Una consulta específicaBusque con un único nombre de anunciante, término de marca o palabra clave, obligatorio y no vacío.
- Recopilación alineada a páginasSolicite de 12 a 2,000 resultados en múltiplos de 12; 1,992 es el mayor valor válido.
- Manejo de cursores opacosSigue los cursores del origen hasta el límite, una página vacía, una señal de fin, la ausencia de cursor o un cursor repetido.
- Resúmenes normalizados de anunciosReciba campos estables de identidad, anunciante, fechas de exhibición, entrega, destino, impresiones, medios, publicación y recopilación.
- Valores nulos fieles al origenLos campos se mantienen en null o vacíos cuando el resultado de búsqueda público solo expone un resumen u omite ese valor.
Parámetros de la TikTok Ad Library Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Nombre de anunciante o palabra clave, obligatorio y no vacío. Se acepta exactamente una consulta. |
results_limit | Opcional | Límite opcional de resultados. El valor predeterminado es 12 y debe ser un múltiplo de 12 entre 12 y 2,000; el mayor valor válido es 1,992. |
Cómo usar la TikTok Ad Library Search API
Envíe una consulta y un límite válido alineado a páginas, consulte la tarea asíncrona y use las páginas de resultados normalizados.
- Elija un nombre de anunciante o una palabra clave; el endpoint no acepta una lista de consultas.
- Envíe query y, de forma opcional, results_limit por POST a /v1/tiktok-ad-library/search.
- Consulte /v1/tasks/{task_id} hasta que la tarea alcance un estado final.
- Lea data.results.items y siga los cursores del resultado de la tarea cuando la respuesta indique que hay más páginas.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# Poll GET /v1/tasks/{task_id}
# Read normalized ads from data.results.itemsCasos de uso de la TikTok Ad Library Search API
- Descubrimiento de anunciantes: Encuentre los anuncios públicos admitidos asociados con el nombre de un anunciante o de una marca.
- Investigación de palabras clave: Arme un conjunto de revisión con los anuncios públicos cuyo contenido indexado en la biblioteca coincide con un término de tema.
- Revisión del panorama creativo: Compare los temas visibles, las referencias de medios, las etiquetas de anunciante y las fechas de exhibición de los registros devueltos.
- Cola de consulta de detalles: Reúna los ID de anuncios públicos y las referencias de origen para inspeccionar registros seleccionados con el endpoint de detalle.
Consejos de expertos para la TikTok Ad Library Search API
- Use un nombre de anunciante específico o una frase distintiva, porque la coincidencia y el orden del origen determinan la relevancia.
- Elija results_limit en incrementos de 12 registros; 2,000 está dentro del máximo general, pero incumple la regla del múltiplo de 12.
- Espere menos registros de los solicitados cuando el origen termine, devuelva una página vacía o repita un cursor.
- No dé por hecha la deduplicación entre páginas; use el id estable del anuncio en su propio pipeline cuando necesite unicidad.
- Interprete la audiencia estimada o las impresiones según la definición del origen, no como conversiones ni rendimiento verificado.
- Use el endpoint Ad Details para un registro seleccionado; Search no ofrece enriquecimiento opcional con detalles.
APIs relacionadas
Además de la TikTok Ad Library Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Ad Library.
- TikTok Ad Library Ad API — Convierte la URL de un anuncio público conocido de TikTok en campos normalizados de creativo, anunciante, entrega, destino, impresiones, contenido multimedia, publicación y recolección.