facebook/
company-reviews

Öffentliche Bewertungen von Facebook-Seiten über /reviews-URLs erfassen – mit Bewertungstext, Profil-Links der Verfasser, Ratings, Likes, Zeitstempeln und Unternehmenskontext als normalisierte Datensätze.

Facebook Company Reviews API

Seitenbewertungen
Kontext der Verfasser
Unternehmens-Ratings
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichURLs von Bewertungsseiten auf facebook.com, www.facebook.com oder m.facebook.com, deren Pfad /reviews enthält, durch Kommas oder Zeilenumbrüche getrennt.
results_limitOptionalMaximale 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.

  1. Bereiten Sie eine oder mehrere öffentliche Facebook-Seiten-URLs vor, deren Pfad /reviews enthält.
  2. Senden Sie urls und optional results_limit per POST an /v1/facebook/company-reviews.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
  4. 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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Facebook-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Facebook Company Reviews API — FAQ

Facebook Company Reviews API ist eine Schnittstelle, die Bewertungen und Empfehlungen von einer öffentlichen Facebook-Seiten-URL mit /reviews zu einem einheitlichen Feedback-Datensatz zusammenführt. Reputationsteams erhalten so eine Grundlage für Momentaufnahmen, Themenanalysen und den Vergleich bekannter Seiten, wobei die Abfrage auf Inhalte beschränkt bleibt, die auf öffentlichen Bewertungsseiten sichtbar sind.

Senden Sie eine oder mehrere Facebook-Seiten-URLs auf facebook.com, www.facebook.com oder m.facebook.com mit /reviews im Pfad. Ein Unternehmensname oder die URL einer fremden Seite ist kein gültiger Ersatz.

Ein Datensatz kann Bewertungs-ID und URL, Text, Namen und Profil-URL des Verfassers, sichtbare Likes, einen Rating-Wert, created_at, collected_at, Unternehmensnamen und URL, das Rating des Unternehmens und die Gesamtzahl der Bewertungen enthalten.

results_limit hat den Standardwert 100 und akzeptiert für jede Eingabe-URL ganze Zahlen von 20 bis 2.000. Es ist eine Obergrenze, sodass öffentliche Sichtbarkeit und Verfügbarkeit der Quelle zu weniger Bewertungen führen können.

Fragen Sie die zurückgegebene Aufgaben-ID ab, bis der Status succeeded lautet, und lesen Sie dann die gespeicherten Bewertungsdatensätze vom Endpunkt der Aufgabenergebnisse.

Jeder tatsächlich gespeicherte Bewertungsdatensatz kostet 0,5 Credits, ohne Grundgebühr pro Aufgabe. Ein leeres Ergebnis verursacht daher keine Ergebnisgebühr.