facebook/
company-reviews

Collectez les avis publics des Pages Facebook à partir d’URL /reviews et obtenez, en enregistrements normalisés, le texte des avis, les liens des auteurs, les notes, les mentions « J’aime », les horodatages et le contexte de l’entreprise.

Facebook Company Reviews API

Avis sur les Pages
Contexte de l’auteur de l’avis
Notes des entreprises
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 Company Reviews

Les avis sur les entreprises Facebook sont des recommandations ou des notes publiques laissées sur une Page, avec un commentaire écrit, l’identité de son auteur, la date de publication, les mentions « J’aime » visibles et des indicateurs d’avis au niveau de l’entreprise. Ces enregistrements servent à étudier les retours, à dresser des instantanés de réputation, à analyser le contexte des auteurs et à comparer des Pages connues.

Fonctionnalités de la Facebook Company Reviews API

  • Collecte à partir d’URL d’avis de PageAccepte une ou plusieurs URL /reviews de Pages Facebook prises en charge et collecte les avis publics disponibles pour chaque entrée.
  • Enregistrements d’avis et d’auteursRenvoie les ID d’avis, les URL sources, le texte, les noms et liens de profil des auteurs, les mentions « J’aime » visibles, les notes et les dates de publication dans une structure normalisée.
  • Contexte au niveau de l’entrepriseGarde le nom de l’entreprise, l’URL de la Page, les notes globales et le nombre total d’avis à côté de chaque avis, pour comparer les sources entre elles.

Paramètres de la Facebook Company Reviews API

ParamètresObligatoireDescription
urlsObligatoireURL d’avis de Pages Facebook sur facebook.com, www.facebook.com ou m.facebook.com dont le chemin contient /reviews, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’avis demandés par URL d’entrée, de 20 à 2 000 ; la valeur par défaut est 100, et les résultats publics disponibles peuvent être moins nombreux.

Comment utiliser la Facebook Company Reviews API

Envoyez des URL /reviews de Pages Facebook sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les avis normalisés grâce à la pagination par curseur.

  1. Préparez une ou plusieurs URL de Pages Facebook publiques dont le chemin contient /reviews.
  2. Envoyez urls, avec results_limit en option, en POST à /v1/facebook/company-reviews.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  4. Lisez /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor comme cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Cas d’usage de la Facebook Company Reviews API

  • Préparation d’un jeu de données de retours : Servez-vous du texte des avis, des notes, des dates de publication et des URL sources pour préparer des jeux de retours publics destinés à l’analyse thématique ou des sentiments.
  • Rapports d’instantanés de réputation : Associez les notes de chaque avis aux notes globales de l’entreprise et au nombre total d’avis pour documenter l’état visible de Pages sélectionnées.
  • Étude de l’engagement des auteurs d’avis : Exploitez les noms d’auteurs, les liens de profil et les mentions « J’aime » visibles pour voir qui a laissé un avis public et quels avis ont suscité de l’engagement.

Conseils d’expert pour la Facebook Company Reviews API

  • Utilisez une URL /reviews de Page Facebook valide plutôt que le nom d’une entreprise ou l’URL générale d’une Page.
  • Réglez results_limit pour chaque URL d’entrée selon la profondeur voulue, et attendez-vous à moins de lignes lorsque Facebook expose peu d’historique d’avis publics.
  • N’envoyez chaque URL de Page qu’une seule fois : les URL d’entrée en double sont supprimées avant la collecte.
  • Considérez les liens d’auteurs, les notes, les mentions « J’aime », les horodatages et les agrégats d’entreprise comme nullables lorsque Facebook n’expose pas la valeur.
  • Suivez results.next_cursor jusqu’à ce que results.has_more passe à false, afin de lire les grosses tâches terminées sans sauter d’enregistrement stocké.

En complément de la Facebook Company Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.

  • Facebook Pages API — Récupérez les profils de Pages publiques, leurs coordonnées, leurs images et les notes d’audience visibles.
  • 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 Video Transcript API — Extrayez le texte et le format des transcriptions disponibles à partir d’URL connues de publications vidéo ou de Reels publics.
  • Facebook Comment Replies API — Récupérez les réponses publiques à un commentaire connu à l’aide de son ID de feedback et de son jeton d’expansion, avec le texte, l’auteur, l’engagement et le contexte parent.
  • 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.

Explorer d’autres plateformes

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

Facebook Company Reviews API — FAQ

Facebook Company Reviews API est une interface programmatique qui rassemble les avis et recommandations d’une URL /reviews de Page Facebook publique dans un jeu de retours homogène. Elle offre aux équipes de réputation une base pour des instantanés, des analyses thématiques et des comparaisons entre Pages connues, tout en restant limitée aux contenus visibles sur les pages d’avis publiques.

Envoyez une ou plusieurs URL de Pages Facebook sur facebook.com, www.facebook.com ou m.facebook.com avec /reviews dans le chemin. Le nom d’une entreprise ou l’URL d’une Page sans rapport n’est pas un substitut valide.

Un enregistrement peut contenir l’ID et l’URL de l’avis, le texte, le nom et l’URL de profil de l’auteur, les mentions « J’aime » visibles, une note, created_at, collected_at, le nom et l’URL de l’entreprise, sa note globale et le nombre total d’avis.

results_limit vaut 100 par défaut et accepte des entiers de 20 à 2 000 pour chaque URL d’entrée. C’est un plafond : la visibilité publique et la disponibilité de la source peuvent donner moins d’avis.

Interrogez l’ID de tâche renvoyé jusqu’à ce que son statut soit succeeded, puis lisez les avis enregistrés depuis l’endpoint de résultats de la tâche.

Chaque avis réellement enregistré coûte 0,5 crédit, sans frais de base par tâche. Un résultat vide n’entraîne donc aucun frais de résultat.