Volver a las API
Datos independientes de publicidad pública

LinkedIn Ad Library API

Descubra anuncios públicos de LinkedIn con entradas de búsqueda estructuradas y luego consulte registros de divulgación seleccionados por su URL exacta de detalle, para investigación, revisión y archivo.

API de la LinkedIn Ad Library disponibles

Use Ad Search para descubrir registros públicos por empresa, ID de empresa o palabra clave, y Ad Details para consultar un registro conocido a partir de su URL pública exacta.

¿Qué datos de la LinkedIn Ad Library se pueden obtener?

SocQ normaliza los campos públicos de divulgación sin presentarlos como analítica privada de campañas; los valores de la fuente que no están disponibles quedan como null o vacíos.

Identidad del anuncio y del anunciante

Obtenga ID de anuncios estables, URL públicas de detalle, ID de anunciantes, nombres, URL de empresas y logotipos cuando estén expuestos.

Contexto de creatividades y destinos

Obtenga el texto de los anuncios, los formatos, los recursos de imagen o video, las ubicaciones y los destinos de las páginas de aterrizaje que estén disponibles.

Divulgaciones públicas de entrega

Conserve las fechas de publicación, los países, las plataformas, las impresiones y las horas de recolección que proporciona la fuente.

SocQ vs LinkedIn Campaign Manager

SocQ obtiene las divulgaciones públicas de la Ad Library. Campaign Manager es el producto independiente de LinkedIn para que los anunciantes autorizados administren sus propias campañas.

FuncionalidadSocQLinkedIn Campaign Manager
Uso principalDescubrir y normalizar registros públicos de anunciosCrear y administrar campañas autorizadas
EntradasBúsqueda por empresa o palabra clave, o una URL exacta de detalleIdentificadores autorizados de cuentas y campañas
AutenticaciónClave de API de SocQCuenta de LinkedIn y permisos de publicidad
SalidaCampos públicos de divulgaciónConfiguración e informes privados de campañas

Cómo funcionan las API de la LinkedIn Ad Library

Ambos endpoints usan el flujo asíncrono de SocQ de envío, consulta y lectura; Search puede devolver varias páginas, mientras que Ad Details devuelve como máximo un registro.

  1. 1. Elegir un endpoint

    Envíe una empresa, un ID de empresa o una palabra clave a Search, o una URL pública exacta de detalle de la Ad Library a Ad Details.

  2. 2. Enviar y dar seguimiento a la tarea

    Envíe la solicitud por POST, guarde el task_id y consulte /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Leer los registros normalizados

    Procese data.results.items y siga next_cursor mientras has_more sea true; una solicitud de detalle devuelve cero o un elemento.

Buscar anuncios públicos de LinkedIn

Autentíquese con su clave de API de SocQ. Search devuelve 24 resultados de forma predeterminada; Ad Details acepta una URL exacta de detalle y no pagina.

curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"Microsoft","countries":["US"],"results_limit":24}'

# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}

Casos de uso frecuentes de la LinkedIn Ad Library API

Descubrimiento de anuncios de la competencia

Encuentre los anuncios públicos observables asociados a empresas seleccionadas y conserve su contexto de divulgación para revisarlo.

Revisión de creatividades

Consulte registros seleccionados e inspeccione el texto, el contenido multimedia, los formatos, los destinos, los anunciantes y los períodos de publicación disponibles.

Conjuntos de datos de publicidad pública

Almacene para su análisis los campos normalizados de identidad del anuncio, anunciante, creatividad, entrega, origen y recolección.

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

Los resultados reflejan el índice público y la visibilidad de los registros disponibles al momento de la recolección, y no son datos privados de Campaign Manager.

  • Search requiere al menos uno de company, keyword o company_id; los campos combinados siguen el comportamiento de coincidencia de la fuente.
  • countries acepta códigos de dos letras, las fechas deben formar un rango válido y results_limit es un múltiplo de 24, de 24 a 1,992.
  • Una búsqueda completada puede no contener elementos o contener filas repetidas de la fuente; una URL de detalle no disponible también puede no devolver ningún registro.
  • Los campos de anunciante, creatividad, entrega, impresiones, destino, formato y contenido multimedia pueden estar ausentes y no deben interpretarse como cero.

Preguntas frecuentes sobre la LinkedIn Ad Library API

¿Qué se puede enviar?

Search acepta el nombre de una empresa, un ID de empresa, una palabra clave o una combinación compatible. Ad Details acepta una URL pública exacta de detalle de la LinkedIn Ad Library.

¿Esta API devuelve analítica privada de campañas?

No. Devuelve las divulgaciones públicas disponibles y no expone gasto, clics, conversiones, reglas de segmentación ni datos de cuentas de Campaign Manager.

¿Cuántos registros pueden devolver los endpoints?

Search devuelve 24 de forma predeterminada y acepta múltiplos de 24 hasta 1,992. Ad Details devuelve cero o un registro.

¿Cuánto cuestan los resultados?

Cada registro de anuncio devuelto cuesta 0.5 créditos. Una tarea correcta sin registros no tiene cargo por resultados.

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.