Volver a las API
Transparencia publicitaria de TikTok

TikTok Ad Library API

Descubra registros publicitarios públicos compatibles de TikTok con una consulta o convierta la URL de un anuncio conocido en campos normalizados para investigación, revisión y archivo.

API de TikTok Ad Library disponibles

Use Search para descubrir registros publicitarios públicos por anunciante o palabra clave, y Ad Details para resolver la URL pública de un anuncio conocido que cumpla los requisitos.

¿Qué datos de anuncios públicos se pueden obtener?

Los campos devueltos reflejan la información pública que se expone actualmente para cada registro compatible; los valores de origen no disponibles permanecen en null o vacíos.

Identidad del anuncio y del anunciante

Recopile ID de anuncios públicos, URL de registros disponibles, nombres de anunciantes, referencias de anunciantes y tipos de recurso estables.

Creatividad y destino

Inspeccione el texto del anuncio, el formato, las referencias multimedia y las URL públicas de las páginas de destino, cuando estén disponibles.

Contexto de entrega visible

Lea las fechas de emisión compatibles, la fecha de publicación, los países, las plataformas, la audiencia y la información de impresiones cuando se exponen.

Contexto de recopilación

Conserve los campos normalizados de origen y de recopilación para colas de revisión, catálogos y conjuntos de datos de investigación.

SocQ y los productos publicitarios de TikTok

SocQ ofrece una recopilación de solo lectura de registros públicos de transparencia compatibles. Los productos de TikTok cumplen otros fines, desde el acceso a la biblioteca pública hasta la administración autorizada de campañas.

FuncionalidadSocQProductos publicitarios de TikTok
Uso principalBuscar y normalizar registros de anuncios públicos compatiblesTransparencia pública u operaciones de campañas autorizadas, según el producto
EntradasUn anunciante o una palabra clave, o la URL de un anuncio conocidoLos controles varían según la superficie de TikTok correspondiente
Datos privados de campañasNo disponiblesRequiere la cuenta, el producto, la aprobación y los permisos correspondientes
AccionesFlujo de datos públicos de solo lecturaAds Manager permite operaciones de campañas autorizadas
Formato de respuestaRegistros de anuncios estables de SocQVistas o respuestas nativas específicas de cada producto

Cómo funcionan las API de TikTok Ad Library

Ambos endpoints usan un ciclo de vida asíncrono de envío, consulta y lectura; Search puede recopilar varias páginas de origen, mientras que Ad Details devuelve como máximo un registro.

  1. 1. Elegir un endpoint

    Envíe un anunciante o una palabra clave a Search, o la URL pública de un anuncio de TikTok que cumpla los requisitos a Ad Details.

  2. 2. Consultar la tarea

    Use el task_id devuelto con /v1/tasks/{task_id} hasta que el procesamiento se complete o falle.

  3. 3. Leer los registros normalizados

    Consuma data.results.items y cualquier cursor del resultado de la tarea; una solicitud de detalle devuelve cero o un anuncio.

Comience con una sola solicitud a la API

Autentíquese con una clave de API de SocQ. Search devuelve 12 resultados de forma predeterminada; Ad Details no tiene paginación ni results_limit.

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}'

# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}

Casos de uso frecuentes de la API de TikTok Ad Library

Monitoreo de marcas

Cree conjuntos de revisión periódicos con los anuncios públicos disponibles que coincidan con el nombre de un anunciante conocido.

Revisión de creatividades

Resuelva anuncios seleccionados e inspeccione los campos públicos compatibles de texto, anunciante, formato, multimedia y destino.

Archivo de transparencia

Conserve registros publicitarios públicos normalizados con el contexto de fechas de emisión y de recopilación.

Enriquecimiento de investigaciones

Use los resultados de búsqueda para identificar registros y luego convierta URL de anuncios públicos conocidas en campos de detalle estables.

Límites y política de datos públicos

Los registros publicitarios públicos dependen de la visibilidad de la fuente, la elegibilidad, la disponibilidad geográfica, el retraso de publicación, la retención y los campos que expone la superficie de TikTok correspondiente.

  • Que un anunciante no aparezca en la búsqueda no prueba que nunca haya publicado un anuncio, y las URL no disponibles pueden no generar un resultado de detalle.
  • Search no expone controles de país, fecha, sección, idioma, industria, objetivo, enriquecimiento ni orden.
  • Las fechas, la audiencia o los valores de impresiones públicos no equivalen a informes privados de gasto, conversión, atribución o retorno de la inversión publicitaria.
  • Las referencias multimedia pueden ser temporales o estar controladas por la fuente, y todos los campos que dependen de la fuente pueden ser null o estar vacíos.

Preguntas frecuentes sobre la API de TikTok Ad Library

¿SocQ es TikTok Ads Manager?

No. SocQ busca y normaliza registros públicos de transparencia compatibles; no administra cuentas, campañas, presupuestos, segmentación ni creatividades.

¿Qué puedo enviar?

Search acepta el nombre de un anunciante o una palabra clave. Ad Details acepta la URL pública de un anuncio de TikTok conocido que cumpla los requisitos.

¿Todos los resultados incluyen los detalles completos del anuncio?

No. Search suele devolver resúmenes, la consulta de detalle puede no devolver ningún registro, y todos los campos que dependen de la fuente pueden ser null o estar vacíos.

¿Cómo se cobra el uso?

Cada registro devuelto cuesta 0.5 créditos de SocQ sin cargo base; Search devuelve 12 resultados de forma predeterminada y Ad Details devuelve como máximo uno.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.