tiktok-ad-library/
ad

Resuelva una URL pública conocida de un anuncio de TikTok en campos normalizados de creatividad, anunciante, entrega, destino, impresiones, medios, publicación y recopilación.

TikTok Ad Library Ad API

URL única
Un anuncio como máximo
Registro canónico de anuncio
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlObligatorioUna ú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.

  1. 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.
  2. Envíe url por POST a /v1/tiktok-ad-library/ad y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea alcance un estado final.
  4. 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 item

Casos 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.

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.

Explorar otras plataformas

Combine los datos de TikTok Ad Library con datos públicos de otras plataformas sociales compatibles.

TikTok Ad Library Ad API — FAQ

TikTok Ad Library Ad API es una interfaz que resuelve una URL pública conocida de un anuncio de TikTok en un único registro normalizado de detalle, con campos admitidos de anunciante, creatividad, entrega, destino, impresiones, medios y fechas.

Envíe una URL oficial de TikTok con http o https cuya ruta contenga /ad. La consola de la página rechaza los hosts que imitan a TikTok antes del envío.

El adaptador toma el primer valor no vacío de id; si no existe, ad_id; y si tampoco existe, el segmento de ruta totalmente numérico situado más a la derecha. Si no hay ninguno, pasa la URL como alternativa que depende del proveedor.

No. El endpoint acepta una sola URL, devuelve como máximo un anuncio, no pagina y no tiene results_limit.

Los registros públicos de Ads Library y de Creative Center exponen campos distintos, y los registros de origen pueden omitir el anunciante, las fechas, los países, el formato, el destino, las impresiones o los medios.

No. No proporciona pujas, presupuestos, conversiones, atribución, segmentación privada ni la configuración completa de las campañas de Ads Manager.

Un registro de anuncio devuelto cuesta 0.5 créditos de SocQ, sin cargo base. La estimación es de un resultado, y un resultado vacío no tiene cargo.