facebook/
posts

Öffentliche Facebook-Beiträge aus URLs von Seiten, Profilen, Gruppen oder einzelnen Beiträgen sammeln – mit normalisiertem Text, Autorenkontext, Medien, Reaktionen, Kommentarzahlen und Shares.

Facebook Posts API

Beiträge
Reaktionen
Öffentliche Daten
1 Credit 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 Posts

Facebook-Beiträge sind öffentliche Veröffentlichungen von Seiten, Profilen oder Gruppen mit Text, Links, Medien, Autorenkontext, Zeitstempeln und sichtbarer Interaktion. Diese Inhalts- und Interaktionssignale eignen sich für Kampagnenbeobachtung, redaktionelle Recherche, Zielgruppenanalyse und Berichte.

Funktionen der Facebook Posts API

  • Unterstützte öffentliche URLsSammeln Sie Beiträge aus öffentlichen URLs von Facebook-Seiten, -Profilen, -Gruppen oder einzelnen Beiträgen in einem einheitlichen, normalisierten Antwortformat.
  • Inhalts- und MedienfelderLiefert Beitragstext, Beitrags-IDs, Autorenkontext, Zeitstempel, Links, Medien, Shares, Kommentarzahlen und sichtbare Reaktionszahlen in normalisierten Feldern.
  • Aufschlüsselung der ReaktionenStellt die sichtbare Aufschlüsselung der Reaktionen nach like, love, wow, care, sad, angry und haha bereit.
  • Begrenzung der angeforderten ErgebnisseNimmt eine oder mehrere unterstützte URLs entgegen und begrenzt die angeforderten Beitragsdatensätze über results_limit.
  • Grenze der öffentlichen DatenPrivate, eingeschränkte, nur nach Anmeldung sichtbare oder entfernte Inhalte bleiben außerhalb der Antwort.

Parameter der Facebook Posts API

ParameterErforderlichBeschreibung
urlsErforderlichURLs öffentlicher Facebook-Seiten, -Profile, -Gruppen oder einzelner Beiträge, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Anzahl von Datensätzen, die die Sammelaufgabe anfordern soll. Muss eine positive ganze Zahl sein.

So verwenden Sie die Facebook Posts API

Senden Sie eine asynchrone Sammelaufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten öffentlichen Beitragsdatensätze per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere URLs öffentlicher Facebook-Seiten, -Profile, -Gruppen oder einzelner Beiträge vor.
  2. Senden Sie urls und optional results_limit per POST an /v1/facebook/posts.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange weitere Datensätze vorhanden sind.
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Anwendungsfälle der Facebook Posts API

  • Beobachtung öffentlicher Seiten: Sammeln Sie öffentliche Beiträge, Zeitstempel, Links, Medienverweise und sichtbare Zähler von Facebook-Seiten, die Ihr Produkt verfolgt.
  • Kampagnen- und Markenberichte: Normalisieren Sie Beitragstext, Reaktionen, Kommentare, Shares und Medienfelder, bevor Sie Kampagnendaten an Dashboards oder BI-Tools übergeben.
  • Content-Recherche: Analysieren Sie öffentliche Bildunterschriften, Beitragsthemen, Links, Bilder, Videos und Interaktionsmuster rund um eine Marke, ein Ereignis oder ein Thema.
  • Social-Listening-Workflows: Leiten Sie öffentliche Beitragssignale in Prüfwarteschlangen, Alarmsysteme oder interne Recherchetools weiter, ohne fehleranfällige Seitenparser zu pflegen.
  • Beitragsarchiv und Prüfspuren: Speichern Sie normalisierte Beitrags-IDs, Quell-URLs, Zeitstempel, sichtbare Zähler und Erfassungszeiten für nachvollziehbare Archive und Berichte.

Profi-Tipps zur Facebook Posts API

  • Beginnen Sie mit kleinen Stapeln öffentlicher Seiten und erhöhen Sie das Limit erst, wenn Ihre Wiederholungs- und Backoff-Logik zuverlässig funktioniert.
  • Speichern Sie normalisierte Beitrags-IDs, URLs, Aufgaben-IDs und next_cursor, damit die Beitragserfassung nach Fehlern fortgesetzt werden kann.
  • Rechnen Sie damit, dass bei einigen öffentlichen Beiträgen je nach Verfügbarkeit der Quelle Kommentare, Medien, Reaktionsdetails oder Zeitstempel fehlen.
  • Nutzen Sie die Comments API, wenn Sie tiefere öffentliche Kommentarverläufe benötigen, die über die schlanken Vorschaufelder hinausgehen.
  • Gehen Sie in Ihrer Integration nicht von privaten, eingeschränkten, nur nach Anmeldung sichtbaren oder kontoeigenen Daten aus, sofern die veröffentlichte API-Dokumentation sie nicht ausdrücklich unterstützt.

Ergänzend zur Facebook Posts 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 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 Group Posts API — Öffentliche Beiträge aus URLs von Facebook-Gruppen erfassen – mit wählbarer Sortierung, Limits pro Gruppe, Autorenkontext, Videomedien und sichtbaren Interaktionen.
  • Facebook Ad Transcript API — Verfügbaren gesprochenen Text, Sprache, Format und Quellkontext aus URLs der Facebook Ad Library extrahieren.
  • 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 Posts API — FAQ

Facebook Posts API sammelt öffentlich zugängliche Beiträge aus URLs von Facebook-Seiten, -Profilen, -Gruppen oder einzelnen Beiträgen. Sie liefert normalisierten Text, Autorenkontext, Medienverweise, Zeitstempel, Reaktionen, Kommentarzahlen und Shares.

Übergeben Sie URLs öffentlicher Facebook-Seiten, -Profile, offener Gruppen oder einzelner Beiträge. Bei privaten Gruppen, eingeschränkten Profilen, entfernten Beiträgen und nur nach Anmeldung sichtbaren Bereichen können eingeschränkte Daten oder kein Datensatz zurückkommen.

Übliche Ergebnisfelder sind id, url, message, author, metrics, reactions, media, created_at, collected_at und extra. Metadaten zu Aufgabe und Paginierung liefern die umgebenden API-Antworten.

Für die Erfassung öffentlicher Beiträge sind keine vom Kunden bereitgestellten Facebook-Cookies erforderlich. Inhalte, die erst nach einer Anmeldung erscheinen, liegen außerhalb der Grenze der öffentlichen Daten.

Bilder, Videos, Reaktionsdetails und sichtbare Kommentarzahlen werden zurückgegeben, sofern der öffentliche Beitrag sie preisgibt. Nutzen Sie die Facebook Comments API, wenn Sie einzelne Kommentardatensätze benötigen, und behandeln Sie optionale Medien- oder Reaktionsfelder als nullable.

Wählen Sie vorsichtige Seitengrößen, gehen Sie nach 429 oder ähnlichen Belastungsantworten in den Backoff und vermeiden Sie enge Wiederholungsschleifen. Sammeln Sie große Aufträge in kleineren Stapeln und setzen Sie von gespeicherten Cursorn aus fort.

Prüfen Sie, ob das Ziel öffentlich erreichbar ist, der Beitrag nicht entfernt oder eingeschränkt wurde und die angeforderten optionalen Felder öffentlich sichtbar sind. Facebook ändert die Struktur öffentlicher Seiten häufig, daher sollten Clients fehlende Felder als normalen Verfügbarkeitsfall behandeln.