facebook/
pages

Collectez les profils de Pages Facebook publiques à partir d’une ou plusieurs URL de Pages et obtenez identité normalisée, coordonnées, images, nombres d’abonnés et de mentions « J’aime », avis et notes.

Facebook Pages API

Pages
Profils
Données publiques
2,4 crédits 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 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ètresObligatoireDescription
urlsObligatoireURL de Pages Facebook publiques, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre 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.

  1. Préparez une ou plusieurs URL de Pages Facebook publiques.
  2. Envoyez urls, avec results_limit en option, en POST à /v1/facebook/pages.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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.

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.

Explorer d’autres plateformes

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

Facebook Pages API — FAQ

Facebook Pages API récupère les profils de Pages accessibles publiquement à partir d’une ou plusieurs URL de Pages Facebook. Elle renvoie l’identité normalisée, les catégories, les descriptions, les images, les coordonnées, les nombres d’abonnés et de mentions « J’aime », les avis et les notes.

La collecte de base de Pages publiques n’exige ni identifiants d’application Facebook ni connexion Facebook. L’API ne doit pas servir à supposer un accès à des contenus privés, restreints ou réservés aux utilisateurs connectés.

Les champs courants comprennent l’ID de la Page, le nom, l’URL canonique, la catégorie, le texte de présentation, l’avatar, l’image de couverture, les nombres d’abonnés et de mentions « J’aime », les avis, la note, le site web, l’e-mail, le téléphone et l’adresse.

Oui, lorsque les résultats publics de la Page exposent les URL de l’image de profil et de l’image de couverture. Les clients doivent gérer les Pages qui omettent l’un de ces champs d’image, ou les deux.

L’objet metrics normalisé peut contenir le nombre visible d’abonnés, le nombre de mentions « J’aime » de la Page, le nombre d’avis et la note, lorsque le résultat public les expose.

Le contenu de Facebook est dynamique et la structure des résultats publics peut changer. Champs vides, délais d’expiration, coordonnées manquantes ou requêtes bloquées sont à traiter comme des cas normaux de disponibilité et de pression sur les limites de débit.

Utilisez des limites plus basses, des cadences de requêtes prudentes, un recul progressif après les échecs et des délais de traitement plus longs pour les grandes Pages. Évitez les collectes répétées à haut volume sur la même Page.