Facebook Company Reviews
Facebook Company Reviews sind öffentliche Empfehlungen oder Ratings von Seiten mit schriftlichem Feedback, Identität der Verfasser, Veröffentlichungszeit, sichtbaren Likes und Bewertungssignalen auf Unternehmensebene. Diese Datensätze unterstützen die Feedback-Recherche, Reputations-Momentaufnahmen, die Analyse des Verfasserkontexts und den Vergleich bekannter Seiten.
Funktionen der Facebook Company Reviews API
- Erfassung über URLs von SeitenbewertungenAkzeptiert eine oder mehrere unterstützte /reviews-URLs von Facebook-Seiten und erfasst die öffentlichen Bewertungszeilen, die für jede Eingabe verfügbar sind.
- Bewertungs- und VerfasserdatensätzeLiefert Bewertungs-IDs, Quell-URLs, Text, Namen und Profil-Links der Verfasser, sichtbare Likes, Rating-Werte und Veröffentlichungszeiten in einer normalisierten Struktur.
- Kontext auf UnternehmensebeneBehält Unternehmensnamen, Seiten-URLs, aggregierte Ratings und die Gesamtzahl der Bewertungen neben den einzelnen Bewertungen für den Vergleich auf Quellebene bei.
Parameter der Facebook Company Reviews API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | URLs von Bewertungsseiten auf facebook.com, www.facebook.com oder m.facebook.com, deren Pfad /reviews enthält, durch Kommas oder Zeilenumbrüche getrennt. |
results_limit | Optional | Maximale Anzahl angeforderter Bewertungen pro Eingabe-URL, von 20 bis 2.000; der Standardwert ist 100, und die verfügbaren öffentlichen Ergebnisse können weniger sein. |
So verwenden Sie die Facebook Company Reviews API
Senden Sie /reviews-URLs von Facebook-Seiten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Bewertungsdatensätze per Cursor-Paginierung.
- Bereiten Sie eine oder mehrere öffentliche Facebook-Seiten-URLs vor, deren Pfad /reviews enthält.
- Senden Sie urls und optional results_limit per POST an /v1/facebook/company-reviews.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und übergeben Sie results.next_cursor als cursor, solange results.has_more den Wert true hat.
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}.Anwendungsfälle der Facebook Company Reviews API
- Aufbereitung von Feedback-Datensätzen: Nutzen Sie Bewertungstext, Rating-Werte, Veröffentlichungszeiten und Quell-URLs, um öffentliche Feedback-Datensätze für die nachgelagerte Themen- oder Stimmungsanalyse aufzubereiten.
- Berichte mit Reputations-Momentaufnahmen: Kombinieren Sie die Ratings einzelner Bewertungen mit Ratings auf Unternehmensebene und der Gesamtzahl der Bewertungen, um den sichtbaren Stand ausgewählter Seiten zu dokumentieren.
- Recherche zur Interaktion der Verfasser: Nutzen Sie Namen der Verfasser, Profil-Links und sichtbare Like-Zahlen, um zu untersuchen, wer öffentliches Feedback verfasst hat und welche Bewertungen Interaktion erzielt haben.
Profi-Tipps zur Facebook Company Reviews API
- Verwenden Sie eine auflösbare /reviews-URL einer Facebook-Seite statt eines Unternehmensnamens oder einer allgemeinen Seiten-URL.
- Legen Sie results_limit für jede Eingabe-URL passend zur gewünschten Tiefe fest und rechnen Sie mit weniger Zeilen, wenn Facebook weniger öffentlichen Bewertungsverlauf zeigt.
- Senden Sie jede Seiten-URL nur einmal, denn doppelte Eingabe-URLs werden vor der Erfassung entfernt.
- Behandeln Sie Links der Verfasser, Ratings, Likes, Zeitstempel und Aggregate des Unternehmens als nullbar, wenn Facebook einen Wert nicht preisgibt.
- Folgen Sie results.next_cursor, bis results.has_more den Wert false hat, damit große abgeschlossene Aufgaben ohne übersprungene gespeicherte Datensätze gelesen werden.
Verwandte APIs
Ergänzend zur Facebook Company Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook-Daten benötigen.
- Facebook Pages API — Öffentliche Seitenprofile, Kontaktdaten, Bilder und sichtbare Publikumsbewertungen abrufen.
- Facebook Posts API — Öffentliche Beiträge, Medien, Reaktionen, Kommentare und Shares aus unterstützten Facebook-URLs erfassen.
- Facebook Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Medien und Quell-Links aus Beitrags-URLs erfassen.
- Facebook Video Transcript API — Verfügbaren Transkripttext und das Format aus bekannten öffentlichen Video-Beitrags- oder Reel-URLs extrahieren.
- Facebook Comment Replies API — Öffentliche Antworten auf einen bekannten Kommentar über dessen Feedback-ID und Erweiterungs-Token abrufen – mit Text, Autorenidentität, Interaktionen und Kontext des übergeordneten Kommentars.
- Facebook Profiles API — Öffentliche Profile oder Seiten aus bekannten Facebook-URLs abrufen – mit Identität, Bio, Avatar, sichtbaren Zählern und Eingabekontext.