linkedin-ad-library/
ad

Récupérez un enregistrement public de la LinkedIn Ad Library à partir de son URL de détail exacte, avec annonceur, créatif, diffusion, destination, impressions et médias normalisés lorsqu’ils sont divulgués.

LinkedIn Ad Library Ad API

URL de détail exacte
Divulgation publique de la publicité
Champs de transparence nullables
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 Ad

Les pages de détail de la LinkedIn Ad Library sont des divulgations publiques limitées dans le temps, consacrées à des publicités diffusées sur LinkedIn, avec le contexte du créatif, de l’annonceur, de la diffusion, de la destination, des impressions et des médias lorsqu’il est disponible. Un enregistrement collecté documente ce qui était observable à ce moment-là et peut devenir partiel ou indisponible lorsque la conservation, les restrictions ou les conditions de la source évoluent.

Fonctionnalités de la LinkedIn Ad Library Ad API

  • Résolution d’une URL de détail exacteRésolvez une URL linkedin.com dont le chemin contient /ad-library/detail/ en un enregistrement de publicité public normalisé, au plus.
  • Contexte du créatif et de l’annonceurConserve l’identité de la publicité, le texte, la référence de l’annonceur, le format, la destination et les médias disponibles dans la structure stable de publicité de SocQ.
  • Divulgation publique de la diffusionRenvoie les première et dernière dates disponibles, les pays, les emplacements et une valeur scalaire d’impressions normalisée sans risque, sans reconstituer de ciblage privé.
  • Sécurité pour les enregistrements restreintsLaisse nullables les valeurs indisponibles d’annonceur, de texte, de destination, d’impressions ou de médias plutôt que de déduire des informations que la source retient.

Paramètres de la LinkedIn Ad Library Ad API

ParamètresObligatoireDescription
urlObligatoireURL de détail publique de la LinkedIn Ad Library, obligatoire. Le schéma doit être http ou https, l’hôte doit se terminer par linkedin.com et le chemin doit contenir /ad-library/detail/.

Comment utiliser la LinkedIn Ad Library Ad API

Envoyez une URL de détail exacte de la LinkedIn Ad Library, suivez la tâche asynchrone et lisez l’enregistrement normalisé lorsqu’il est disponible.

  1. Copiez une URL http ou https de la LinkedIn Ad Library dont le chemin contient /ad-library/detail/.
  2. Envoyez url en POST à /v1/linkedin-ad-library/ad et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items ; l’opération de détail renvoie un enregistrement au plus et n’élargit pas une URL indisponible en recherche.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Cas d’usage de la LinkedIn Ad Library Ad API

  • Enrichir une publicité LinkedIn repérée : Récupérez les champs de créatif, d’annonceur, de diffusion, de destination, d’impressions et de médias disponibles pour une URL de détail publique connue.
  • Conserver un instantané de divulgation : Stockez l’enregistrement normalisé et la valeur collected_at avant qu’une entrée publique limitée dans le temps ou restreinte ne change ou ne disparaisse.
  • Comparer des preuves publiques de créatifs : Passez en revue les messages, formats, éléments graphiques et contextes de diffusion divulgués pour des publicités choisies, sans traiter l’enregistrement comme une donnée de performance de campagne.

Conseils d’expert pour la LinkedIn Ad Library Ad API

  • Envoyez l’URL de détail complète, et non un simple ID de publicité, une page d’entreprise, une URL de recherche ou une liste d’URL.
  • Distinguez une tâche réussie sans élément exploitable d’un échec du fournisseur ; ni l’un ni l’autre ne prouve que la publicité n’a jamais existé.
  • Conservez les champs nullables, car les enregistrements restreints ou expirés peuvent omettre volontairement l’annonceur, l’aperçu, le payeur, le texte, les médias ou les informations de diffusion.
  • Passez par LinkedIn Ad Library Search pour la découverte ; cette opération ne résout que l’URL de détail exacte envoyée.

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

  • LinkedIn Ad Library Search API — Recherchez des publicités LinkedIn publiques par entreprise, ID d’entreprise ou mot-clé avec contrôle du pays, de la date et du nombre de résultats.

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 Ad API — FAQ

LinkedIn Ad Library Ad API est une interface programmatique qui récupère un enregistrement public de la LinkedIn Ad Library à partir de son URL de détail exacte. Elle renvoie l’annonceur, le créatif, la diffusion, la destination, les impressions et les médias normalisés lorsque l’enregistrement public les expose.

Envoyez une URL http ou https sur linkedin.com dont le chemin contient /ad-library/detail/. Les ID seuls, les pages d’entreprise, les URL de recherche et les listes d’URL ne sont pas acceptés.

La source peut exposer des divulgations plus riches dans certaines régions, mais le contrat stable ne promet ni l’identité du payeur, ni les règles de ciblage, ni la ventilation des impressions par pays, ni les appels à l’action, ni le statut restreint.

La publicité peut avoir été retirée, être expirée selon la fenêtre de conservation publique, être restreinte, être malformée à la source ou être indisponible via le fournisseur actuel. L’opération ne lui substitue pas une autre publicité.

Chaque enregistrement renvoyé coûte 0,5 crédit SocQ. Un résultat vide réussi n’entraîne que le coût de base configuré à zéro crédit.