linkedin-ad-library/
search

Busque anuncios públicos de LinkedIn por empresa, ID de empresa o palabra clave con filtros de país y fecha, con anunciante, creatividad, difusión, destino, impresiones y contenido multimedia normalizados.

LinkedIn Ad Library Search API

Búsqueda por empresa y palabra clave
Paginación de 24 registros
Divulgaciones públicas de anuncios
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 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ámetrosObligatorioDescripción
companyObligatorio (al menos uno)Nombre de la empresa o del anunciante. Se requiere al menos uno de company, keyword o company_id.
keywordObligatorio (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_idObligatorio (al menos uno)ID de empresa de LinkedIn exacto, usado como entrada de búsqueda.
countriesOpcionalLista opcional de códigos de país alfabéticos de dos letras, preferiblemente en mayúsculas, como US y CA.
start_dateOpcionalInicio opcional del filtro público de fecha de difusión en formato YYYY-MM-DD.
end_dateOpcionalFin opcional del filtro público de fecha de difusión en formato YYYY-MM-DD; no puede ser anterior a start_date.
results_limitOpcionalMá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.

  1. Proporcione company, keyword o company_id; combínelos solo cuando se busque esa coincidencia más acotada definida por el origen.
  2. Opcionalmente, agregue countries de dos letras, un rango de fechas válido y un results_limit que sea múltiplo de 24.
  3. Envíe la solicitud por POST a /v1/linkedin-ad-library/search y guarde el task_id devuelto.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

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

LinkedIn Ad Library Search API — FAQ

LinkedIn Ad Library Search API es una interfaz programática para descubrir registros públicos de anuncios de LinkedIn que se conservan, a partir del nombre de una empresa, un ID de empresa exacto, una palabra clave o una combinación admitida. Devuelve los campos disponibles en la estructura de anuncio normalizada de SocQ.

Proporcione al menos uno de company, keyword o company_id. Puede enviar varios a la vez, pero la búsqueda pública del origen controla cómo coinciden exactamente y cómo se cruzan.

El endpoint acepta una lista de countries de dos letras, además de los valores opcionales start_date y end_date. No expone ninguna opción pública de ordenamiento.

Un registro puede incluir la identidad del anuncio y del anunciante, la URL de detalle pública, el texto de la creatividad, las fechas de inicio y fin, los países, las impresiones escalares, el formato, las ubicaciones, el destino, el contenido multimedia y la hora de recopilación, cuando están disponibles.

Es posible que ningún anuncio público conservado coincida con los campos de descubrimiento y los filtros enviados en el momento de la recopilación. Un resultado vacío no prueba que el anunciante nunca haya publicado anuncios.

El origen devuelve hasta 24 anuncios por página. SocQ sigue cada nuevo token de paginación hasta llegar a results_limit, a la última página, a una página vacía, a un token ausente o a un token repetido.

Cada anuncio normalizado devuelto cuesta 0.5 créditos de SocQ. Una tarea exitosa sin registros devueltos no tiene cargo por resultados.