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ètres | Obligatoire | Description |
|---|---|---|
company | Obligatoire (au moins un) | Nom de l’entreprise ou de l’annonceur. Au moins un des champs company, keyword ou company_id est obligatoire. |
keyword | Obligatoire (au moins un) | Texte à faire correspondre dans la recherche publique de publicités. La sémantique de correspondance vient de la source publique. |
company_id | Obligatoire (au moins un) | ID d’entreprise LinkedIn exact, utilisé comme entrée de recherche. |
countries | Facultatif | Liste facultative de codes pays alphabétiques à deux lettres, de préférence en majuscules, comme US et CA. |
start_date | Facultatif | Début facultatif du filtre de dates de diffusion publiques, au format YYYY-MM-DD. |
end_date | Facultatif | Fin facultative du filtre de dates de diffusion publiques, au format YYYY-MM-DD ; elle ne peut pas précéder start_date. |
results_limit | Facultatif | Nombre 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.
- Fournissez company, keyword ou company_id ; ne les combinez que lorsque vous voulez cette correspondance plus étroite définie par la source.
- Ajoutez au besoin countries à deux lettres, une plage de dates valide et un results_limit multiple de 24.
- Envoyez la requête en POST à /v1/linkedin-ad-library/search et conservez le task_id renvoyé.
- 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 trueCas 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.
API associées
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.