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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL 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_limit | Facultatif | Nombre 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.
- Préparez une ou plusieurs URL de Pages Facebook publiques dont le chemin contient /reviews.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/company-reviews.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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é.
API associées
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.