Retour aux API
Données indépendantes de publicité publique

LinkedIn Ad Library API

Découvrez des publicités LinkedIn publiques grâce à des entrées de recherche structurées, puis récupérez des fiches de transparence choisies par URL de détail exacte, pour la recherche, la vérification et l’archivage.

API LinkedIn Ad Library disponibles

Utilisez Ad Search pour découvrir des enregistrements publics par entreprise, ID d’entreprise ou mot-clé, et Ad Details pour récupérer un enregistrement connu depuis son URL publique exacte.

Quelles données de la LinkedIn Ad Library pouvez-vous récupérer ?

SocQ normalise les champs publics de transparence sans les présenter comme des analyses privées de campagne ; les valeurs sources indisponibles restent null ou vides.

Identité de la publicité et de l’annonceur

Récupérez les ID de publicités stables, URL de détail publiques, ID d’annonceurs, noms, URL d’entreprises et logos lorsqu’ils sont exposés.

Contexte des créations et des destinations

Collectez le texte publicitaire, les formats, les ressources image ou vidéo, les emplacements et les pages de destination disponibles.

Informations publiques de diffusion

Conservez les dates de diffusion, pays, plateformes, impressions et heures de collecte fournis par la source.

SocQ vs LinkedIn Campaign Manager

SocQ collecte les informations publiques de l’Ad Library. Campaign Manager est le produit distinct de LinkedIn pour les annonceurs autorisés qui gèrent leurs propres campagnes.

FonctionnalitéSocQLinkedIn Campaign Manager
Usage principalDécouvrir et normaliser des enregistrements publicitaires publicsCréer et gérer des campagnes autorisées
EntréesRecherche par entreprise ou mot-clé, ou une URL de détail exacteIdentifiants de compte et de campagne autorisés
AuthentificationClé API SocQCompte LinkedIn et autorisations publicitaires
SortieChamps publics de transparenceConfiguration et reporting privés de campagne

Fonctionnement des API LinkedIn Ad Library

Les deux endpoints suivent le workflow asynchrone de SocQ (envoi, interrogation, lecture) ; Search peut renvoyer plusieurs pages, tandis qu’Ad Details renvoie au plus un enregistrement.

  1. 1. Choisir un endpoint

    Envoyez une entreprise, un ID d’entreprise ou un mot-clé à Search, ou l’URL de détail publique exacte d’une publicité de l’Ad Library à Ad Details.

  2. 2. Envoyer et suivre la tâche

    Envoyez la requête en POST, conservez task_id et interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Lire les enregistrements normalisés

    Traitez data.results.items et suivez next_cursor tant que has_more vaut true ; une requête de détail renvoie zéro ou un élément.

Rechercher des publicités LinkedIn publiques

Authentifiez-vous avec votre clé API SocQ. Search renvoie 24 résultats par défaut ; Ad Details accepte une URL de détail exacte et ne pagine pas.

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}

Cas d’usage courants de l’API LinkedIn Ad Library

Découverte des publicités concurrentes

Trouvez les publicités publiques observables associées à des entreprises choisies et conservez leur contexte de transparence pour la revue.

Revue des créations

Récupérez des enregistrements choisis et examinez le texte, les médias, formats, destinations, annonceurs et périodes de diffusion disponibles.

Jeux de données publicitaires publics

Stockez les champs normalisés d’identité de publicité, d’annonceur, de création, de diffusion, de source et de collecte pour l’analyse.

Limites et politique sur les données publiques

Les résultats reflètent l’index public et la visibilité des enregistrements disponibles au moment de la collecte ; ce ne sont pas des données privées de Campaign Manager.

  • Search exige au moins l’un de company, keyword ou company_id ; les champs combinés suivent le comportement de correspondance de la source.
  • countries accepte des codes à deux lettres, les dates doivent former une plage valide, et results_limit est un multiple de 24 de 24 à 1 992.
  • Une recherche terminée peut ne contenir aucun élément ou des lignes sources répétées ; une URL de détail indisponible peut aussi ne renvoyer aucun enregistrement.
  • Les champs d’annonceur, de création, de diffusion, d’impressions, de destination, de format et de médias peuvent être absents et ne doivent pas être interprétés comme des zéros.

Questions fréquentes sur l’API LinkedIn Ad Library

Que puis-je envoyer ?

Search accepte un nom d’entreprise, un ID d’entreprise, un mot-clé ou une combinaison prise en charge. Ad Details accepte l’URL de détail publique exacte d’une publicité de la LinkedIn Ad Library.

Cette API renvoie-t-elle des analyses privées de campagne ?

Non. Elle renvoie les informations publiques disponibles et n’expose ni dépenses, ni clics, conversions, règles de ciblage ou données de compte de Campaign Manager.

Combien d’enregistrements les endpoints peuvent-ils renvoyer ?

Search renvoie 24 enregistrements par défaut et accepte des multiples de 24 jusqu’à 1 992. Ad Details renvoie zéro ou un enregistrement.

Comment les résultats sont-ils tarifés ?

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

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.