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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Nom 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.
- Préparez une requête non vide portant sur une entreprise, une marque ou le nom d’une Page publique.
- Envoyez query en POST à /v1/facebook-ad-library/company-search et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.