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é | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Usage principal | Découvrir et normaliser des enregistrements publicitaires publics | Créer et gérer des campagnes autorisées |
| Entrées | Recherche par entreprise ou mot-clé, ou une URL de détail exacte | Identifiants de compte et de campagne autorisés |
| Authentification | Clé API SocQ | Compte LinkedIn et autorisations publicitaires |
| Sortie | Champs publics de transparence | Configuration 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. 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. 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. 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.
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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.
Reddit API
Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.
Pinterest API
Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.
Threads API
Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.
Bluesky API
Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.
Snapchat API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.
Twitch API
Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.

