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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL 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.
- Copie una URL http o https de la LinkedIn Ad Library cuya ruta contenga /ad-library/detail/.
- Envíe url por POST a /v1/linkedin-ad-library/ad y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
- 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 itemCasos 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ó.
APIs relacionadas
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.