linkedin-ad-library/
search

Recherchez des publicités LinkedIn publiques par entreprise, ID d’entreprise ou mot-clé, avec filtres de pays et de dates, et obtenez annonceur, créatif, diffusion, destination, impressions et médias normalisés.

LinkedIn Ad Library Search API

Recherche par entreprise et mot-clé
Pagination par 24 enregistrements
Divulgations publiques de publicités
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

LinkedIn Ad Library Search

LinkedIn Ad Library Search découvre les divulgations publiques de publicités conservées à partir d’un nom d’entreprise, d’un ID d’entreprise exact, d’un mot-clé ou d’une combinaison de ces entrées. Les enregistrements renvoyés normalisent l’identité de l’annonceur, le texte du créatif, l’URL source, la fenêtre de diffusion, les pays, les impressions, le format, la destination et les médias disponibles, sans assimiler à zéro un champ de divulgation absent.

Fonctionnalités de la LinkedIn Ad Library Search API

  • Trois entrées de découverteRecherchez avec un nom d’entreprise, un mot-clé, un ID d’entreprise LinkedIn exact, ou plusieurs de ces champs dans une même requête ; au moins un est obligatoire.
  • Filtres de pays et de datesAffinez l’index public avec des codes pays à deux lettres et une plage facultative de dates de diffusion, bornes incluses, au format YYYY-MM-DD.
  • Enregistrements de publicités publics normalisésRenvoie l’identité stable de la publicité, la référence de l’annonceur, le texte du créatif, l’URL de détail, les dates, les marchés, le format, la destination, les impressions et les médias lorsqu’ils sont divulgués.
  • Pagination par jetons bornéeCollectez de 24 à 1 992 enregistrements, par multiples de 24, pendant que SocQ suit les nouveaux jetons de pagination amont jusqu’à la limite ou jusqu’à la dernière page exploitable.
  • De la recherche au détailTransmettez une URL /ad-library/detail/ renvoyée à LinkedIn Ad Library Ad lorsqu’un enregistrement découvert nécessite la vue de détail disponible.

Paramètres de la LinkedIn Ad Library Search API

ParamètresObligatoireDescription
companyObligatoire (au moins un)Nom de l’entreprise ou de l’annonceur. Au moins un des champs company, keyword ou company_id est obligatoire.
keywordObligatoire (au moins un)Texte à faire correspondre dans la recherche publique de publicités. La sémantique de correspondance vient de la source publique.
company_idObligatoire (au moins un)ID d’entreprise LinkedIn exact, utilisé comme entrée de recherche.
countriesFacultatifListe facultative de codes pays alphabétiques à deux lettres, de préférence en majuscules, comme US et CA.
start_dateFacultatifDébut facultatif du filtre de dates de diffusion publiques, au format YYYY-MM-DD.
end_dateFacultatifFin facultative du filtre de dates de diffusion publiques, au format YYYY-MM-DD ; elle ne peut pas précéder start_date.
results_limitFacultatifNombre maximal d’enregistrements demandés. Vaut 24 par défaut et accepte les multiples de 24 de 24 à 1 992.

Comment utiliser la LinkedIn Ad Library Search API

Choisissez au moins un champ de découverte, ajoutez uniquement les filtres qui définissent votre échantillon et lisez les pages de la tâche asynchrone terminée.

  1. Fournissez company, keyword ou company_id ; ne les combinez que lorsque vous voulez cette correspondance plus étroite définie par la source.
  2. Ajoutez au besoin countries à deux lettres, une plage de dates valide et un results_limit multiple de 24.
  3. Envoyez la requête en POST à /v1/linkedin-ad-library/search et conservez le task_id renvoyé.
  4. Interrogez /v1/tasks/{task_id}, puis lisez data.results.items et suivez next_cursor tant que has_more vaut 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

Cas d’usage de la LinkedIn Ad Library Search API

  • Découverte des publicités d’un annonceur : Partez d’un nom d’entreprise ou d’un ID d’entreprise exact pour rassembler les publicités publiques observables associées à un annonceur au moment de la collecte.
  • Étude des messages et des thèmes : Recherchez des mots-clés de produits, de concurrents ou de thèmes et comparez les textes de créatifs, formats, médias et destinations renvoyés.
  • Comparaison par marché et par période : Répétez la même requête avec des filtres de pays et de dates maîtrisés pour comparer les divulgations publiques sur des échantillons définis.
  • Sélection de candidats pour le détail : Servez-vous des ID de publicités et des URL de détail renvoyés pour choisir des enregistrements à examiner de plus près avec l’opération de détail distincte.

Conseils d’expert pour la LinkedIn Ad Library Search API

  • Commencez avec un seul champ de découverte, puis combinez company, keyword et company_id uniquement quand un jeu de résultats plus étroit, défini par la source, est utile.
  • Utilisez des codes pays en majuscules pour des entrées stockées cohérentes, même si le validateur actuel accepte les deux casses.
  • Choisissez results_limit par incréments de 24 enregistrements et voyez-le comme un plafond de collecte, non comme la promesse que chaque emplacement trouvera une correspondance.
  • Conservez la requête, les filtres et l’heure de collected_at quand vous comparez des exécutions, car la disponibilité publique et les enregistrements conservés évoluent.
  • Traitez les valeurs manquantes d’annonceur, de dates, de pays, d’impressions, de destination, de format ou de médias comme des données de divulgation indisponibles, et non comme des zéros.

En complément de la LinkedIn Ad Library Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques LinkedIn Ad Library.

  • LinkedIn Ad Library Ad API — Récupérez une fiche publique de la LinkedIn Ad Library à partir de l’URL exacte de son détail avec champs normalisés d’annonceur, création, diffusion, destination, impressions et médias.

Explorer d’autres plateformes

Combinez les données LinkedIn Ad Library avec les données publiques d’autres plateformes sociales prises en charge.

LinkedIn Ad Library Search API — FAQ

LinkedIn Ad Library Search API est une interface programmatique qui découvre les enregistrements publics de publicités LinkedIn conservés, à partir d’un nom d’entreprise, d’un ID d’entreprise exact, d’un mot-clé ou d’une combinaison prise en charge. Elle renvoie les champs disponibles dans la structure de publicité normalisée de SocQ.

Fournissez au moins un des champs company, keyword ou company_id. Vous pouvez en envoyer plusieurs ensemble, mais la recherche publique en amont détermine leur correspondance exacte et leur intersection.

L’endpoint accepte une liste de countries à deux lettres ainsi que des valeurs facultatives start_date et end_date. Il n’expose aucune option de tri publique.

Un enregistrement peut contenir l’identité de la publicité et de l’annonceur, l’URL de détail publique, le texte du créatif, les dates de début et de fin, les pays, les impressions scalaires, le format, les emplacements, la destination, les médias et la date de collecte lorsqu’ils sont disponibles.

Il se peut qu’aucune publicité publique conservée ne corresponde aux champs de découverte et aux filtres envoyés au moment de la collecte. Un résultat vide ne prouve pas que l’annonceur n’a jamais diffusé de publicités.

La source en amont renvoie jusqu’à 24 publicités par page. SocQ suit chaque nouveau jeton de pagination jusqu’à results_limit, à la dernière page, à une page vide, à un jeton manquant ou à un jeton répété.

Chaque publicité normalisée renvoyée coûte 0,5 crédit SocQ. Une tâche réussie sans enregistrement renvoyé n’entraîne aucun coût de résultat.