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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | URLs öffentlicher Facebook-Seiten, -Profile, -Gruppen oder einzelner Beiträge, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere URLs öffentlicher Facebook-Seiten, -Profile, -Gruppen oder einzelner Beiträge vor.
- Senden Sie urls und optional results_limit per POST an /v1/facebook/posts.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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.
Verwandte APIs
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.