linkedin-ad-library/
ad

Obtenga un registro público de la LinkedIn Ad Library a partir de su URL de detalle exacta, con anunciante, creatividad, difusión, destino, impresiones y contenido multimedia normalizados cuando se divulgan.

LinkedIn Ad Library Ad API

URL de detalle exacta
Divulgación pública del anuncio
Campos de transparencia anulables
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

LinkedIn Ad Library Ad

Las páginas de detalle de la LinkedIn Ad Library son divulgaciones públicas, limitadas en el tiempo, de anuncios que se publicaron en LinkedIn, con contexto de creatividad, anunciante, difusión, destino, impresiones y contenido multimedia cuando está disponible. Un registro recopilado documenta lo que se podía observar en ese momento y puede quedar incompleto o dejar de estar disponible si cambian las condiciones de retención, las restricciones o el origen.

Funcionalidades de la LinkedIn Ad Library Ad API

  • Resolución de detalle exactaResuelve una URL de linkedin.com cuya ruta contiene /ad-library/detail/ en, como máximo, un registro público de anuncio normalizado.
  • Contexto de creatividad y anuncianteConserva la identidad del anuncio, el texto, la referencia del anunciante, el formato, el destino y el contenido multimedia disponibles en la estructura de anuncio estable de SocQ.
  • Divulgación pública de la difusiónDevuelve las fechas de primera y última difusión, los países, las ubicaciones y un valor escalar de impresiones normalizado de forma segura, cuando están disponibles, sin reconstruir la segmentación privada.
  • Seguridad en registros restringidosMantiene como anulables los valores de anunciante, texto, destino, impresiones o contenido multimedia que no estén disponibles, en lugar de inferir información que el origen no divulga.

Parámetros de la LinkedIn Ad Library Ad API

ParámetrosObligatorioDescripción
urlObligatorioURL pública obligatoria de detalle de la LinkedIn Ad Library. El esquema debe ser http o https, el host debe terminar en linkedin.com y la ruta debe contener /ad-library/detail/.

Cómo usar la LinkedIn Ad Library Ad API

Envíe una URL de detalle pública y exacta de la LinkedIn Ad Library, siga la tarea asíncrona y lea el registro normalizado cuando esté disponible.

  1. Copie una URL http o https de la LinkedIn Ad Library cuya ruta contenga /ad-library/detail/.
  2. Envíe url por POST a /v1/linkedin-ad-library/ad y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
  4. Lea data.results.items; la operación de detalle devuelve como máximo un registro y no amplía a una búsqueda una URL no disponible.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Casos de uso de la LinkedIn Ad Library Ad API

  • Enriquecer un anuncio de LinkedIn descubierto: Obtenga los campos disponibles de creatividad, anunciante, difusión, destino, impresiones y contenido multimedia de una URL de detalle pública conocida.
  • Conservar una instantánea de la divulgación: Almacene el registro normalizado y el valor de collected_at antes de que una entrada pública limitada en el tiempo o restringida cambie o desaparezca.
  • Comparar evidencia pública de creatividades: Revise el mensaje, el formato, los recursos y el contexto de difusión divulgado en anuncios seleccionados, sin tratar el registro como datos de rendimiento de campañas.

Consejos de expertos para la LinkedIn Ad Library Ad API

  • Envíe la URL de detalle completa y no solo el ID del anuncio, una página de empresa, una URL de búsqueda ni una lista de URL.
  • Distinga una tarea exitosa sin ningún elemento utilizable de un error del proveedor; ninguna de las dos prueba que el anuncio nunca existió.
  • Conserve los campos anulables, porque los registros restringidos o vencidos pueden omitir de forma intencional la información de anunciante, vista previa, pagador, texto, contenido multimedia o difusión.
  • Use LinkedIn Ad Library Search para el descubrimiento; esta operación solo resuelve la URL de detalle exacta que se envió.

Además de la LinkedIn Ad Library Ad API, use estas APIs cuando necesite otro tipo de datos públicos de LinkedIn Ad Library.

  • LinkedIn Ad Library Search API — Busca anuncios públicos de LinkedIn por empresa, ID de empresa o palabra clave, con controles de país, fecha y límite de resultados.

Explorar otras plataformas

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

LinkedIn Ad Library Ad API — FAQ

LinkedIn Ad Library Ad API es una interfaz programática para obtener un registro público de la LinkedIn Ad Library a partir de su URL de detalle exacta. Devuelve los campos normalizados de anunciante, creatividad, difusión, destino, impresiones y contenido multimedia cuando el registro público los expone.

Envíe una URL http o https de linkedin.com cuya ruta contenga /ad-library/detail/. No se aceptan ID sueltos, páginas de empresa, URL de búsqueda ni listas de URL.

El origen puede exponer divulgaciones más amplias en algunas regiones, pero el contrato estable no promete la identidad del pagador, las reglas de segmentación, el desglose de impresiones por país, los llamados a la acción ni el estado de restricción.

El anuncio puede haberse eliminado, haber vencido según el periodo público de retención, estar restringido, estar mal formado en el origen o no estar disponible a través del proveedor actual. La operación no sustituye el anuncio por otro.

Cada registro devuelto cuesta 0.5 créditos de SocQ. Un resultado vacío exitoso solo incurre en el cargo base configurado de cero créditos.