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.
| Funcionalidad | SocQ | Productos publicitarios de TikTok |
|---|---|---|
| Uso principal | Buscar y normalizar registros de anuncios públicos compatibles | Transparencia pública u operaciones de campañas autorizadas, según el producto |
| Entradas | Un anunciante o una palabra clave, o la URL de un anuncio conocido | Los controles varían según la superficie de TikTok correspondiente |
| Datos privados de campañas | No disponibles | Requiere la cuenta, el producto, la aprobación y los permisos correspondientes |
| Acciones | Flujo de datos públicos de solo lectura | Ads Manager permite operaciones de campañas autorizadas |
| Formato de respuesta | Registros de anuncios estables de SocQ | Vistas 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. 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. Consultar la tarea
Use el task_id devuelto con /v1/tasks/{task_id} hasta que el procesamiento se complete o falle.
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.
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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
YouTube API
Recopile perfiles públicos compatibles de canales de YouTube, detalles de videos, videos de canales, comentarios, Shorts, resultados por palabra clave y hashtag, y transcripciones disponibles con un único flujo asíncrono normalizado.
Facebook API
Obtenga perfiles públicos de páginas de Facebook, publicaciones, publicaciones de grupos, comentarios, eventos que coinciden con una palabra clave y transcripciones de video disponibles, con campos normalizados de identidad, contenido, origen, formato, lugar, contenido multimedia, reacciones, asistencia e interacción.
X API
Recopile perfiles públicos, relaciones de seguidores y seguidos, posts, respuestas, citas, quienes hicieron repost, resultados de búsqueda y tendencias actuales. Use resultados consistentes para investigación y monitoreo.
LinkedIn API
Obtenga datos públicos de perfiles, empresas, publicaciones y empleos de LinkedIn a partir de URL conocidas, con campos normalizados de identidad, trayectoria profesional, empresa, contenido, interacción y empleo.
Reddit API
Obtenga publicaciones y comentarios públicos de Reddit a partir de URL conocidas, explore publicaciones nuevas, principales o populares de un subreddit, o busque conversaciones por palabra clave y período de publicación.
Pinterest API
Obtenga datos de perfiles públicos de Pinterest, resuelva Pins conocidos, recopile Pins de perfiles seleccionados o busque por palabra clave para investigar creadores de contenido, contenidos y tendencias visuales.

