Facebook Pages
Les Pages Facebook sont des profils publics d’entreprises, d’organisations, de créateurs et de personnalités, avec identité, catégories, descriptions, images, coordonnées et signaux d’audience. Ces champs de profil et d’audience servent à repérer des marques, à enrichir des annuaires, à mener des études de marché et à comparer des comptes.
Fonctionnalités de la Facebook Pages API
- Collecte de Pages par lotCollecte une ou plusieurs Pages Facebook publiques à partir de leurs URL.
- Identité et visuels de la PageRenvoie le nom de la Page, sa catégorie, son texte de présentation, son URL canonique, son avatar et son image de couverture sous forme de champs de profil normalisés.
- Indicateurs d’audience visiblesRegroupe dans un objet metrics cohérent les nombres visibles d’abonnés, de mentions « J’aime » de la Page, d’avis et de notes.
- Coordonnées publiquesRenvoie le site web, l’e-mail, le téléphone et l’adresse publics, pour l’enrichissement de contacts et d’annuaires.
- Limite des données publiquesLes résultats se bornent aux données de Page accessibles publiquement ; les contenus privés, restreints ou réservés aux utilisateurs connectés restent hors du périmètre de la réponse.
Paramètres de la Facebook Pages API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de Pages Facebook publiques, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal d’enregistrements que la tâche de collecte doit demander. Doit être un entier positif. |
Comment utiliser la Facebook Pages API
Envoyez une tâche de collecte, interrogez son ID de tâche jusqu’à la fin du traitement, puis lisez les Pages normalisées grâce à la pagination par curseur.
- Préparez une ou plusieurs URL de Pages Facebook publiques.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/pages.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor.
curl -X POST "https://api.socq.ai/v1/facebook/pages" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Cas d’usage de la Facebook Pages API
- Suivi des Pages de marques : Collectez l’identité, la catégorie, les coordonnées et les indicateurs d’audience publics pour suivre vos propres Pages ou celles de concurrents.
- Jeux de données de benchmark de Pages : Comparez catégories, descriptions, couverture des coordonnées, nombres d’abonnés, notes et autres signaux d’audience visibles sur une sélection de Pages.
- Reporting et pipelines BI : Envoyez les enregistrements de Pages publiques normalisés vers des tableaux de bord, des tableurs, des entrepôts de données ou des outils internes de revue.
- Workflows d’archivage média : Stockez les URL de Pages, les images, les descriptions, les coordonnées et les indicateurs visibles pour une revue ou un rapport ultérieur.
- Écoute sociale publique : Appuyez-vous sur l’identité publique des Pages et sur les signaux d’audience pour enrichir des catalogues de comptes sociaux et des jeux de données de marques.
Conseils d’expert pour la Facebook Pages API
- Avant de lancer un gros lot, vérifiez que chaque URL envoyée mène bien à une Page Facebook publique.
- Attendez-vous à ce que certaines Pages publiques omettent coordonnées, images, notes ou compteurs d’audience, selon la disponibilité des résultats.
- Gardez les ID de Pages stables et les URL canoniques, afin de pouvoir relancer, auditer et dédoublonner les tâches.
- Utilisez Facebook Posts API lorsque votre workflow a besoin des publications publiques d’une Page ou d’une autre URL prise en charge.
- Évitez de bâtir des workflows autour de Pages privées, de publications restreintes, de surfaces connectées ou de données de compte, sauf si une documentation distincte les prend explicitement en charge.
API associées
En complément de la Facebook Pages API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.
- Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
- Facebook Comments API — Collectez les commentaires publics, leurs auteurs, l’engagement, les médias et les liens sources à partir d’URL de publications.
- Facebook Profile Events API — Collectez les événements publics associés à des URL de profils ou de Pages, avec noms, programmes, lieux, médias, indicateurs visibles et contexte source.
- Facebook Profile Photos API — Collectez les photos publiques à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, engagement, métadonnées d’image et références sources.
- Facebook Profiles API — Consultez des profils ou Pages publics à partir d’URL Facebook connues avec identité, bio, avatar, compteurs visibles et contexte de la saisie.
- Facebook Reels API — Collectez les Reels publics à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, métadonnées vidéo, engagement visible et références sources.