facebook-ad-library/
company-search

Recherchez les Pages d’annonceurs de la Facebook Ad Library par nom d’entreprise ou de Page et obtenez ID de Page, catégories, images et signaux d’audience Instagram dans des enregistrements normalisés.

Facebook Ad Library Company Search API

Requête par entreprise ou Page
Pages d’annonceurs candidates
Signaux de la Page et d’Instagram
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 Search

Les entreprises candidates de la Facebook Ad Library sont des Pages d’annonceurs identifiées par des ID de Page, des noms, des catégories, des pays, des images, des valeurs de vérification et le contexte Instagram associé. Ces signaux d’identité et d’audience servent à retrouver un annonceur, à comparer des Pages de même nom et à choisir une Page de façon vérifiable avant d’étudier ses publicités.

Fonctionnalités de la Facebook Ad Library Company Search API

  • Recherche par nom d’entreprise ou de PageEnvoyez une requête non vide portant sur une entreprise, une marque ou un nom de Page, et recevez chaque Page d’annonceur candidate renvoyée pour cette recherche.
  • Identité et classification de la PageRenvoie les ID de Page, noms, URL publiques déduites, catégories, pays, types d’entité, valeurs de vérification, images et état de Page supprimée, lorsqu’ils sont exposés.
  • Signaux visibles de la Page et d’InstagramGarde les mentions J’aime Facebook disponibles avec les noms d’utilisateur Instagram liés, leurs nombres d’abonnés et leur état de vérification dans les enregistrements candidats normalisés.

Paramètres de la Facebook Ad Library Company Search API

ParamètresObligatoireDescription
queryObligatoireNom obligatoire et non vide d’une entreprise, d’une marque ou d’une Page publique, utilisé pour trouver des Pages d’annonceurs candidates.

Comment utiliser la Facebook Ad Library Company Search API

Envoyez une requête portant sur une entreprise ou un nom de Page, suivez la tâche asynchrone, puis examinez les Pages d’annonceurs candidates normalisées.

  1. Préparez une requête non vide portant sur une entreprise, une marque ou le nom d’une Page publique.
  2. Envoyez query en POST à /v1/facebook-ad-library/company-search et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items et demandez next_cursor tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

# 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 Search API

  • Résolution de l’ID de Page d’un annonceur : Appuyez-vous sur les ID de Page, noms, URL, catégories et pays des candidats pour choisir l’identifiant nécessaire à une requête Company Ads limitée à une Page.
  • Comparaison de Pages homonymes et régionales : Comparez catégories, pays, types d’entité, images, valeurs de vérification et contexte Instagram associé entre des annonceurs aux noms proches.
  • Sélecteurs d’annonceurs vérifiables : Stockez l’identité de la Page, les signaux d’audience visibles, la requête d’origine et l’heure de collecte derrière un sélecteur d’annonceurs ou un index de recherche.

Conseils d’expert pour la Facebook Ad Library Company Search API

  • N’envoyez que query ; results_limit et les filtres de statut, de pays, de média ou de période des publicités ne sont pas acceptés par Company Search.
  • Lorsque plusieurs candidats portent un nom courant, comparez l’ID de Page, l’URL, la catégorie, le pays, l’image, la vérification et l’identité Instagram associée au lieu de retenir le premier résultat.
  • Suivez next_cursor jusqu’à ce que has_more passe à false, afin que la pagination des résultats de la tâche ne masque aucune entreprise candidate stockée.
  • Considérez l’identité Instagram, les nombres d’abonnés, les valeurs de vérification, les images et l’état de Page supprimée comme des signaux facultatifs, et gérez les champs absents sans rejeter le candidat.

En complément de la Facebook Ad Library Company Search 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 Ads API — Collectez les publicités publiques d’une Page d’annonceur à partir de son ID avec création publicitaire, diffusion, marché, médias, CTA et signaux visibles.
  • 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 Search API — FAQ

Facebook Ad Library Company Search API trouve des Pages d’annonceurs candidates à partir d’une requête non vide portant sur une entreprise ou un nom de Page. Elle renvoie les ID de Page, les champs d’identité et de classification, les images, les métriques d’audience visibles et le contexte Instagram associé.

L’endpoint accepte une seule chaîne query obligatoire et non vide. Il n’accepte ni results_limit ni filtres de pays, de statut, de média, de langue, de tri ou de période pour les publicités.

Non. Il renvoie des Pages d’annonceurs candidates et l’ID de Page numérique utilisé par Company Ads, et non des créations publicitaires ou des enregistrements de diffusion.

Comparez l’ID de Page, le nom, l’URL, la catégorie, le pays, le type d’entité, l’image, la valeur de vérification et l’identité Instagram associée. Un nom courant ne suffit pas à établir qu’un candidat est l’annonceur recherché.

La recherche d’entreprise n’accepte pas results_limit et enregistre chaque ID de Page unique exposé pour la requête. Une tâche terminée peut tout de même paginer les enregistrements stockés avec next_cursor et has_more.

Un tableau items vide signifie que la recherche n’a renvoyé aucune Page publique candidate pour cette requête. Des différences de nom ou la disponibilité de la source publique peuvent expliquer un résultat vide, qui ne prouve donc pas que l’entreprise n’a aucune publicité.

Chaque entreprise candidate renvoyée coûte 0,5 crédit SocQ. L’estimation de la requête repose sur 10 candidats, et un jeu de résultats vide n’entraîne aucun frais de résultat dans la configuration de facturation actuelle.