Facebook Ad Library Company Ads
Les publicités d’entreprise de la Facebook Ad Library sont des enregistrements publics d’annonceurs, avec le texte de la création, les médias, l’identité de la Page, les dates de diffusion, l’état actif, les plateformes de diffusion, le contexte par pays et des signaux visibles. Ces enregistrements servent à surveiller un annonceur, à comparer des créations, à examiner un marché précis et à établir des rapports à la date de collecte.
Fonctionnalités de la Facebook Ad Library Company Ads API
- Collecte limitée à la Page d’un annonceurUn seul ID de Page d’annonceur numérique garde chaque publicité renvoyée rattachée à la Page publique choisie, et non à une recherche par mot-clé.
- Filtres de marché et de diffusionAffinez la collecte par pays, statut de diffusion, type de média, langue, période et ordre de tri pris en charge avant l’enregistrement des résultats.
- Champs de création, de médias et de destinationRenvoie pour chaque publicité les titres, textes principaux, images ou vidéos, valeurs de CTA, URL de destination publiques et formats d’affichage disponibles.
- Contexte de l’annonceur et de la diffusionConserve l’identité de la Page, les mentions J’aime de la Page, les dates de diffusion, l’état actif, les plateformes de diffusion, les pays, la portée, la devise et les dépenses lorsqu’ils sont exposés publiquement.
- Publicités uniques en nombre bornéSuit les pages source disponibles, supprime les ID d’archive ou URL en double et s’arrête à results_limit ou à la dernière page disponible.
Paramètres de la Facebook Ad Library Company Ads API
| Paramètres | Obligatoire | Description |
|---|---|---|
page_id | Obligatoire | ID numérique obligatoire de la Page d’annonceur dans la Facebook Ad Library. Utilisez d’abord Company Search lorsque l’ID de Page est inconnu ; une tâche accepte un seul ID de Page. |
results_limit | Facultatif | Nombre maximal de publicités uniques à enregistrer. La valeur par défaut est 100 et les valeurs acceptées sont des entiers de 20 à 2 000. |
country | Facultatif | Utilisez ALL ou un code pays à deux lettres. La valeur par défaut est ALL. |
status | Facultatif | Filtre sur le statut de diffusion de la publicité. Utilisez exactement ALL, ACTIVE ou INACTIVE ; la valeur par défaut est ACTIVE. |
media_type | Facultatif | Filtre sur le média de la création. Utilisez exactement ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME ou NONE ; la valeur par défaut est ALL. |
language | Facultatif | Code de langue de la publicité à deux lettres, facultatif. |
sort_by | Facultatif | Trie les publicités renvoyées par total_impressions ou relevancy_monthly_grouped ; la valeur par défaut est total_impressions. |
start_date | Facultatif | Date de début facultative au format YYYY-MM-DD. Elle ne peut pas être postérieure à end_date. |
end_date | Facultatif | Date de fin facultative au format YYYY-MM-DD. Elle ne peut pas être antérieure à start_date. |
Comment utiliser la Facebook Ad Library Company Ads API
Envoyez l’ID de Page d’un annonceur avec des filtres facultatifs, suivez la tâche asynchrone, puis lisez les publicités normalisées avec la pagination par curseur.
- Récupérez l’ID de Page numérique de l’annonceur et choisissez, si besoin, des filtres de pays, de statut, de média, de langue, de tri ou de période.
- Envoyez page_id et les filtres choisis à /v1/facebook-ad-library/company-ads, puis récupérez task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou renvoie un échec.
- Lisez data.results.items, puis demandez la page suivante avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Facebook Ad Library Company Ads API
- Surveillance des publicités d’un annonceur : Suivez les ID d’archive, textes de création, médias, état actif, dates de diffusion, URL sources et collected_at pour la Page d’un annonceur connu.
- Comparaison des créations et des formats : Comparez textes, images ou vidéos, formats d’affichage, CTA, liens de destination et contexte de regroupement (collation) entre les publicités renvoyées pour la Page.
- Revue de publicités filtrées par marché : Appliquez des filtres de pays, de langue, de statut, de média et de période pour constituer des ensembles distincts de publicités selon des questions de marché ou de diffusion précises.
- Rapports d’instantanés des signaux publics : Combinez identité de la Page, mentions J’aime de la Page, portée, dépenses, devise, état de diffusion et collected_at lorsque ces valeurs publiques sont exposées.
Conseils d’expert pour la Facebook Ad Library Company Ads API
- Commencez avec country sur ALL et des filtres de média et de période larges, puis affinez une condition à la fois pour pouvoir interpréter correctement un résultat vide.
- Utilisez le results_limit minimal de 20 pendant la validation d’un ID de Page et d’un jeu de filtres, puis augmentez-le seulement quand le périmètre renvoyé correspond à votre tâche.
- Envoyez des tâches séparées pour les marques qui possèdent plusieurs ID de Page d’annonceur, car une requête Company Ads n’accepte qu’un seul ID de Page.
- Dédoublonnez les exécutions répétées par id de publicité, traitez la portée, les dépenses, les médias et les dates manquants comme indisponibles plutôt que comme zéro, et utilisez les champs de regroupement pour constituer des groupes, pas pour avancer des performances.
API associées
En complément de la Facebook Ad Library Company Ads API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook Ad Library.
- Facebook Ad Library Search API — Recherchez des publicités publiques par mot-clé avec contrôle de la correspondance, de la publicité, du pays, du statut, des médias, du tri, de la date et du nombre de résultats.
- Facebook Ad Library Company Search API — Trouvez des Pages d’annonceurs par nom d’entreprise ou de Page avec ID de Page, classifications, images, audience visible et signaux Instagram associés.
- Facebook Ad Library Ad API — Collectez une publicité publique de l’Ad Library à partir de son URL avec création publicitaire, annonceur, médias, diffusion, CTA et signaux visibles.