LinkedIn Ad Library Search
LinkedIn Ad Library Search descubre divulgaciones públicas de anuncios que se conservan, a partir del nombre de una empresa, un ID de empresa exacto, una palabra clave o una combinación de estas entradas. Los registros devueltos normalizan la identidad del anunciante, el texto de la creatividad, la URL de origen, el periodo de difusión, los países, las impresiones, el formato, el destino y el contenido multimedia disponibles, sin tratar como cero los campos de divulgación ausentes.
Funcionalidades de la LinkedIn Ad Library Search API
- Tres entradas de descubrimientoBusque con el nombre de una empresa, una palabra clave, un ID de empresa de LinkedIn exacto o varios de estos campos en una misma solicitud; se requiere al menos uno.
- Filtros de país y fechaAcote el índice público con códigos de país de dos letras y un rango opcional e inclusivo de fechas de difusión en formato YYYY-MM-DD.
- Registros públicos de anuncios normalizadosDevuelve una identidad de anuncio estable, la referencia del anunciante, el texto de la creatividad, la URL de detalle, las fechas, los mercados, el formato, el destino, las impresiones y el contenido multimedia cuando se divulgan.
- Paginación acotada por tokensRecopile de 24 a 1,992 registros en múltiplos de 24, mientras SocQ sigue los nuevos tokens de paginación del origen hasta alcanzar el límite o la última página utilizable.
- Flujo de búsqueda a detallePase una URL /ad-library/detail/ devuelta a LinkedIn Ad Library Ad cuando un registro descubierto necesite la vista de detalle disponible.
Parámetros de la LinkedIn Ad Library Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
company | Obligatorio (al menos uno) | Nombre de la empresa o del anunciante. Se requiere al menos uno de company, keyword o company_id. |
keyword | Obligatorio (al menos uno) | Texto que se busca en la búsqueda pública de anuncios. La semántica de coincidencia proviene del origen público. |
company_id | Obligatorio (al menos uno) | ID de empresa de LinkedIn exacto, usado como entrada de búsqueda. |
countries | Opcional | Lista opcional de códigos de país alfabéticos de dos letras, preferiblemente en mayúsculas, como US y CA. |
start_date | Opcional | Inicio opcional del filtro público de fecha de difusión en formato YYYY-MM-DD. |
end_date | Opcional | Fin opcional del filtro público de fecha de difusión en formato YYYY-MM-DD; no puede ser anterior a start_date. |
results_limit | Opcional | Máximo de registros solicitados. El valor predeterminado es 24 y acepta múltiplos de 24 de 24 a 1,992. |
Cómo usar la LinkedIn Ad Library Search API
Elija al menos un campo de descubrimiento, agregue solo los filtros que definan su muestra y lea las páginas de la tarea asíncrona completada.
- Proporcione company, keyword o company_id; combínelos solo cuando se busque esa coincidencia más acotada definida por el origen.
- Opcionalmente, agregue countries de dos letras, un rango de fechas válido y un results_limit que sea múltiplo de 24.
- Envíe la solicitud por POST a /v1/linkedin-ad-library/search y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id}, lea data.results.items y siga next_cursor mientras has_more sea true.
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}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la LinkedIn Ad Library Search API
- Descubrimiento de anuncios de un anunciante: Use el nombre de una empresa o un ID de empresa exacto para reunir los anuncios públicos observables asociados con un anunciante en el momento de la recopilación.
- Investigación de mensajes y temas: Busque palabras clave de productos, competidores o temas y compare el texto de las creatividades, los formatos, el contenido multimedia y los destinos devueltos.
- Comparación de mercados y periodos: Repita la misma consulta con filtros controlados de país y fecha para comparar las divulgaciones públicas entre muestras definidas.
- Selección de candidatos para el detalle: Use los ID de anuncio y las URL de detalle devueltos para elegir registros individuales y examinarlos con más detalle mediante la operación de detalle independiente.
Consejos de expertos para la LinkedIn Ad Library Search API
- Comience con un solo campo de descubrimiento y combine company, keyword y company_id únicamente cuando resulte útil un conjunto de resultados más acotado definido por el origen.
- Use códigos de país en mayúsculas para que las entradas almacenadas sean consistentes, aunque el validador actual acepta ambos casos.
- Elija results_limit en incrementos de 24 registros y trátelo como un tope de recopilación, no como una promesa de que cada espacio tenga una coincidencia.
- Conserve la consulta, los filtros y la hora de collected_at al comparar ejecuciones, porque la disponibilidad pública y los registros que se conservan cambian.
- Trate los valores ausentes de anunciante, fechas, país, impresiones, destino, formato o contenido multimedia como datos de divulgación no disponibles y no como cero.
APIs relacionadas
Además de la LinkedIn Ad Library Search API, use estas APIs cuando necesite otro tipo de datos públicos de LinkedIn Ad Library.
- LinkedIn Ad Library Ad API — Obtiene un registro público conocido de la LinkedIn Ad Library mediante la URL exacta de su detalle, con campos normalizados de anunciante, creativo, entrega, destino, impresiones y contenido multimedia.