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.
| Funcionalidad | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Uso principal | Descubrir y normalizar registros públicos de anuncios | Crear y administrar campañas autorizadas |
| Entradas | Búsqueda por empresa o palabra clave, o una URL exacta de detalle | Identificadores autorizados de cuentas y campañas |
| Autenticación | Clave de API de SocQ | Cuenta de LinkedIn y permisos de publicidad |
| Salida | Campos públicos de divulgación | Configuració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. 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. 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. 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.
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.
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.
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.
Threads API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.
Snapchat API
Obtenga un Spotlight público conocido de Snapchat como un registro normalizado con los campos disponibles de creador, descripción, multimedia, audio, marca de tiempo, duración e interacción.
Twitch API
Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.

