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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL 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.
- Copiez une URL http ou https de la LinkedIn Ad Library dont le chemin contient /ad-library/detail/.
- Envoyez url en POST à /v1/linkedin-ad-library/ad et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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 itemCas 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.
API associées
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.