TikTok Ad Library Ad
TikTok Ad Library Ad resuelve un registro publicitario público conocido cuando la búsqueda o la revisión manual ya produjo una URL válida. Deriva un identificador de origen y devuelve como máximo un anuncio normalizado; no busca por anunciante, no enumera campañas ni expone datos de rendimiento privados de Ads Manager.
Funcionalidades de la TikTok Ad Library Ad API
- Entrada con URL de anuncio conocidoEnvíe una URL oficial de TikTok con http o https cuya ruta contenga /ad.
- Derivación del identificadorSe prefiere el primer valor de id en la consulta, luego ad_id y después el segmento numérico situado más a la derecha de la ruta; de lo contrario, el proveedor recibe la URL como alternativa.
- Detalle de un solo objetoSolicita un objeto de detalle al origen y emite como máximo un registro, solo cuando existe una identidad de anuncio compatible.
- Campos canónicos del anuncioReciba campos estables de anunciante, texto, fechas, país, plataforma, formato, destino, impresiones, medios, publicación y recopilación.
- Fidelidad al origen con valores nulosLos valores no disponibles se mantienen como null, porque los registros de Commercial Content Library y de Creative Center pueden exponer campos distintos.
Parámetros de la TikTok Ad Library Ad API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Una única URL oficial de TikTok con http o https, obligatoria, cuya ruta contenga /ad. Se prefiere un valor utilizable de id o ad_id en la consulta, o un segmento numérico en la ruta. |
Cómo usar la TikTok Ad Library Ad API
Envíe la URL de un anuncio público conocido, consulte la tarea asíncrona y procese el único resultado cuando esté disponible.
- Elija una URL oficial de anuncio de TikTok que, de ser posible, incluya un id, un ad_id o un identificador numérico en la ruta.
- Envíe url por POST a /v1/tiktok-ad-library/ad y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea alcance un estado final.
- Si tiene éxito, lea data.results.items; la operación de detalle devuelve cero o un elemento.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; the detail operation returns at most one itemCasos de uso de la TikTok Ad Library Ad API
- Inspección de un anuncio seleccionado: Resuelva un anuncio elegido en los resultados de una búsqueda en los campos de detalle normalizados disponibles actualmente.
- Revisión de creatividades: Inspeccione el texto creativo público, la identidad del anunciante, el formato, los medios y el destino de un anuncio conocido.
- Archivo de transparencia: Conserve un registro público con la URL de origen, las fechas de exhibición, el contexto de entrega y la hora de recopilación.
- Comparación entre bibliotecas: Compare los metadatos públicos admitidos de varios anuncios seleccionados, sin tratarlos como rendimiento de campaña.
Consejos de expertos para la TikTok Ad Library Ad API
- Prefiera las URL con un valor numérico explícito de id o ad_id en la consulta para evitar el comportamiento alternativo que depende del proveedor.
- Una URL válida no garantiza que el origen siga exponiendo un objeto de anuncio identificable.
- Trate los campos de Ads Library y de Creative Center como específicos de cada origen y no como directamente intercambiables.
- Archive referencias a medios o páginas de destino solo bajo los términos adecuados, porque las URL pueden vencer o redirigir.
- No infiera segmentación, gasto, conversiones ni rendimiento a partir de las fechas de exhibición o las impresiones públicas.
- Use el endpoint de búsqueda cuando necesite descubrir anuncios; este endpoint de detalle nunca enumera los anuncios de un anunciante.
APIs relacionadas
Además de la TikTok Ad Library Ad API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Ad Library.
- TikTok Ad Library Search API — Busca registros publicitarios públicos compatibles de TikTok por nombre de anunciante o palabra clave, con un límite de resultados alineado a las páginas.