facebook-ad-library/
company-ads

Collectez les publicités publiques de la Facebook Ad Library pour l’ID de Page d’un annonceur et obtenez texte de la création, médias, contexte de la Page, détails de diffusion et signaux visibles sous forme d’enregistrements normalisés.

Facebook Ad Library Company Ads API

ID de Page d’annonceur en entrée
Création et contexte de diffusion
Enregistrements publicitaires publics
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

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ètresObligatoireDescription
page_idObligatoireID 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_limitFacultatifNombre 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.
countryFacultatifUtilisez ALL ou un code pays à deux lettres. La valeur par défaut est ALL.
statusFacultatifFiltre sur le statut de diffusion de la publicité. Utilisez exactement ALL, ACTIVE ou INACTIVE ; la valeur par défaut est ACTIVE.
media_typeFacultatifFiltre 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.
languageFacultatifCode de langue de la publicité à deux lettres, facultatif.
sort_byFacultatifTrie les publicités renvoyées par total_impressions ou relevancy_monthly_grouped ; la valeur par défaut est total_impressions.
start_dateFacultatifDate de début facultative au format YYYY-MM-DD. Elle ne peut pas être postérieure à end_date.
end_dateFacultatifDate 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.

  1. 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.
  2. Envoyez page_id et les filtres choisis à /v1/facebook-ad-library/company-ads, puis récupérez task_id.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou renvoie un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Facebook Ad Library avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Ad Library Company Ads API — FAQ

Facebook Ad Library Company Ads API récupère les publicités publiques d’un ID de Page d’annonceur numérique. Elle renvoie des champs normalisés de création, de médias, d’annonceur, de diffusion, de marché, de CTA, de signaux visibles et d’heure de collecte.

Utilisez Facebook Ad Library Company Search avec le nom de l’entreprise ou de la marque, puis choisissez le bon ID de Page numérique parmi les candidats renvoyés avant d’envoyer Company Ads.

Vous pouvez filtrer par pays, statut de diffusion, type de média, code de langue à deux lettres, dates de début et de fin, et choisir l’un des deux ordres de tri pris en charge. results_limit fixe le nombre maximal de publicités uniques enregistrées.

La Page choisie peut n’avoir aucune publicité publique correspondant aux filtres de pays, de statut, de média, de langue ou de période, ou aucune page source supplémentaire peut être disponible. Un résultat vide réussi ne crée pas de publicités fictives.

Chaque enregistrement de publicité renvoyé coûte 0,5 crédit SocQ. Un jeu de résultats vide n’entraîne aucun frais de résultat.