Zurück zu den APIs
Öffentliche Facebook-Daten

Facebook Public Data API

Erfassen Sie öffentliche Facebook-Seitenprofile, Beiträge, Gruppenbeiträge, Kommentare, per Stichwort gefundene Events und verfügbare Videotranskripte – mit normalisierten Feldern zu Identität, Inhalt, Quelle, Format, Ort, Medien, Reaktionen, Teilnahme und Engagement.

Verfügbare Facebook-APIs

Verwenden Sie Pages für öffentliche Profilfelder, Posts für allgemeine Inhalte, Group Posts für Datensätze zu Gruppen-URLs, Comments für Diskussionen, Events Search für per Stichwort gefundene Events und Video Transcripts für verfügbaren gesprochenen Text aus bekannten Videobeitrags- oder Reel-URLs. Alle sechs nutzen dieselbe Authentifizierung und dasselbe Muster für Aufgabenergebnisse.

Welche Facebook-Daten können Sie abrufen?

SocQ wandelt unterstützte öffentliche Facebook-Ergebnisse in einheitliche JSON-Datensätze für Anreicherung, Monitoring, Recherche und Reporting um.

Öffentliche Seitenprofile

Erfasst Seitennamen, Kategorien, Beschreibungen, kanonische URLs, Profilbilder und Titelbilder, sofern öffentlich verfügbar.

Kontakt- und Zielgruppenfelder

Liefert öffentliche Websites, E-Mail-Adressen, Telefonnummern, Standorte, Follower-Zahlen, Seiten-Likes, Bewertungen und Anzahl der Bewertungen, sofern sie sichtbar sind.

Öffentliche Beitragsinhalte

Erfasst Beitragstexte, Autoren, Zeitstempel, Links, Bilder, Videoverweise und normalisierte Beitragskennungen.

Öffentliche Kommentare und Engagement

Erfasst öffentliche Kommentartexte, Autorenfelder, Zeitstempel, Likes, Anzahl der Antworten, Shares und Reaktionssignale, sofern verfügbar.

Öffentliche Event-Suche

Sucht per Stichwort nach Eventnamen, Terminen, Orten, Teilnahmesignalen, Titelbildern und dem Status online oder vergangen.

Verfügbare Videotranskripte

Extrahiert den quellenverknüpften Transkripttext samt Format (Klartext oder WebVTT) aus bekannten öffentlichen Videobeitrags- oder Reel-URLs.

SocQ vs Facebook Graph API

SocQ konzentriert sich auf die unterstützte Erfassung öffentlicher Daten. Die Graph API von Meta ist die richtige Wahl, um Assets zu verwalten, die ein Nutzer oder Unternehmen ausdrücklich autorisiert hat.

FunktionSocQFacebook Graph API
HauptzweckErfassung öffentlicher Daten zu Seiten, Beiträgen, Gruppenbeiträgen, Kommentaren, Events und TranskriptenVerwaltung autorisierter Seiten, Apps und Assets
OAuth beim KundenSocQ-API-Schlüssel; kein Facebook-OAuth des KundenMeta-App-Prüfung, Berechtigungen und Zugriffstoken
Beiträge erstellen oder bearbeitenNicht unterstütztUnterstützt mit passenden Seitenberechtigungen
Private oder eingeschränkte DatenNicht unterstütztNur Daten, die über autorisierte Berechtigungen freigegeben sind
AntwortformatNormalisierte SocQ-DatensätzeNative Graph-API-Objekte

So funktioniert die Facebook API

Die Erfassung läuft asynchron, damit Ihre Anwendung Aufgaben senden, ihren Status überwachen und Ergebnisseiten unabhängig voneinander verarbeiten kann.

  1. 1. Eingabe senden

    Senden Sie per POST unterstützte öffentliche URLs von Seiten, Beiträgen, Gruppen, Videobeiträgen oder Reels oder eine Stichwortabfrage für die Event-Suche – jeweils mit den dokumentierten Feldern des gewählten Endpunkts.

  2. 2. Aufgabe abfragen

    Fragen Sie die Aufgabe mit der zurückgegebenen Aufgaben-ID ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt. Warten Sie nach Antworten, die auf vorübergehende Überlastung hinweisen, mit zunehmendem Abstand.

  3. 3. Lesen und paginieren

    Rufen Sie die normalisierten Ergebniselemente ab und folgen Sie next_cursor, wenn die Aufgabe weitere Datensätze enthält.

Mit einer API-Anfrage starten

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel. Dieses Beispiel startet eine Aufgabe für eine öffentliche Facebook-Seite; verwenden Sie /v1/facebook/posts für allgemeine Beiträge, /v1/facebook/group-posts für Gruppenbeiträge, /v1/facebook/comments für Kommentare, /v1/facebook/events-search für die Event-Suche oder /v1/facebook/video-transcript für bekannte Videobeitrags- und Reel-URLs.

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}
# Read GET /v1/tasks/{task_id}?limit=50

Typische Anwendungsfälle der Facebook API

Markenbeobachtung

Verfolgen Sie öffentliche Signale zu Identität, Kontakt, Zielgruppe und Beiträgen von Seiten eigener Marken oder Wettbewerber.

Recherche zu Inhalten und Reaktionen

Analysieren Sie öffentliche Beiträge, Kommentartexte, Autoren, Zeitstempel, Medien und sichtbares Engagement für Reportings oder redaktionelle Recherche.

Anreicherung von Seiten

Ergänzen Sie CRM-, Verzeichnis- oder Kontodatensätze um öffentliche Facebook-Felder zu Identität, Kategorie, Kontakt und Zielgruppe.

Event-Suche und -Beobachtung

Nutzen Sie per Stichwort gefundene Felder zu Event-Identität, Termin, Ort, Teilnahme, Titelbild und Status, um öffentliche Event-Datensätze zu ordnen.

Reporting-Pipelines

Leiten Sie normalisierte öffentliche Seiten- und Beitragsdatensätze an Dashboards, Data Warehouses und interne Prüfwerkzeuge weiter.

Indexierung gesprochener Inhalte

Indexieren Sie verfügbaren Transkripttext samt Quell-URL und Format für ausgewählte öffentliche Videobeiträge und Reels.

Grenzen und Richtlinie für öffentliche Daten

Öffentliche Facebook-Ergebnisse ändern sich laufend. Ein Feld, das bei einer Seite, einem Beitrag, einem Kommentar, einem Event oder einer Transkriptquelle sichtbar ist, kann in einem anderen Datensatz fehlen oder sich im Zeitverlauf ändern.

  • Private Gruppen, eingeschränkte Profile, entfernte Beiträge und Inhalte, die eine Anmeldung erfordern, werden nicht unterstützt.
  • Öffentliche Datensätze können Kontaktfelder, Kommentarautoren, Medien, Zähler, Zeitstempel, Antworten oder Aufschlüsselungen der Reaktionen auslassen.
  • Für eine gesendete öffentliche Video-URL entsteht kein Transkriptdatensatz, wenn kein nicht leerer Transkripttext verfügbar ist.
  • Verwenden Sie kleinere Stapel, zurückhaltende Anfrageraten und zunehmende Wartezeiten nach vorübergehenden Sperren oder bei Ratenbegrenzung.
  • Diese Endpunkte erstellen, ändern, moderieren oder löschen keine Facebook-Inhalte.

Häufige Fragen zur Facebook API

Ist das die offizielle Facebook Graph API?

Nein. SocQ normalisiert unterstützte öffentliche Facebook-Ergebnisse. Für autorisierte Seitenverwaltung, Veröffentlichung und Moderation verwenden Sie die Graph API von Meta.

Müssen Nutzer Facebook-Konten verbinden?

Für die unterstützten Endpunkte mit öffentlichen Daten ist kein Facebook-OAuth des Kunden erforderlich. Anfragen werden mit einem SocQ-API-Schlüssel authentifiziert.

Kann SocQ private Gruppen oder Profile erfassen?

Nein. Private, eingeschränkte und nur nach Anmeldung zugängliche Facebook-Inhalte liegen außerhalb des unterstützten Bereichs.

Wie wird die Nutzung abgerechnet?

Die Karte jedes Endpunkts zeigt den aktuellen Credit-Preis pro Ergebnis. Aufgaben werden anhand der normalisierten Datensätze abgerechnet, die sie zurückgeben.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.