facebook/
group-posts

Öffentliche Facebook-Gruppenbeiträge über Gruppen-URLs mit wählbarer Sortierung erfassen – mit Text, Autoren, Zeitstempeln, Videos und sichtbarer Interaktion als normalisierte Datensätze.

Facebook Group Posts API

Öffentliche Gruppenbeiträge
Vier Sortiermodi
Ergebnislimit pro Gruppe
1,2 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 Group Posts

Facebook Group Posts sind öffentliche Gruppenbeiträge mit Nachrichtentext, Identität des Autors, Veröffentlichungszeit, Quelllinks, sichtbaren Reaktionen, Kommentaren, Aufrufen und Videomedien. Diese Datensätze unterstützen die Beobachtung der Gruppenaktivität, die Recherche zu Diskussionen, den Vergleich der Interaktion und das Reporting öffentlicher Inhalte.

Funktionen der Facebook Group Posts API

  • Stapel öffentlicher Gruppen-URLsAkzeptiert eine oder mehrere öffentliche Facebook-Gruppen-URLs und bewahrt die ursprüngliche Gruppen-URL bei jedem normalisierten Beitragsdatensatz.
  • Vier Sortiermodi für GruppenWählen Sie mit top_posts, recent_activity, chronological oder chronological_listings die Sortierung, die auf alle gesendeten Gruppen angewendet wird.
  • Erfassungstiefe pro GruppeWendet results_limit separat auf jede Gruppen-URL an, mit dem Standardwert 100 und einem zulässigen Bereich von 3 bis 2.000.
  • Beitrags- und AutorenkontextLiefert Beitrags-IDs, Quell-URLs, Nachrichtentext, Autoren-IDs und -Namen, Veröffentlichungszeiten und Erfassungszeiten in einer einheitlichen Struktur.
  • Sichtbare Interaktion und VideoEnthält die sichtbaren Zahlen zu Reaktionen, Kommentaren und Videoaufrufen sowie normalisierte Video- und Vorschaubild-URLs, sofern ein öffentlicher Beitrag sie preisgibt.

Parameter der Facebook Group Posts API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche öffentliche Facebook-Gruppen-URLs, durch Kommas oder Zeilenumbrüche getrennt.
results_limitOptionalMaximale Anzahl angeforderter Beiträge für jede Gruppen-URL; der Standardwert ist 100, zulässig sind ganze Zahlen von 3 bis 2.000.
sort_byOptionalOptionale Sortierung, die auf jede gesendete Gruppe angewendet wird: top_posts, recent_activity, chronological oder chronological_listings.

So verwenden Sie die Facebook Group Posts API

Senden Sie öffentliche Gruppen-URLs mit optionaler Sortierung und einem Ergebnislimit pro Gruppe und lesen Sie anschließend die Ergebnisse der asynchronen Aufgabe per Cursor-Paginierung.

  1. Bereiten Sie eine oder mehrere öffentliche Facebook-Gruppen-URLs vor.
  2. Senden Sie urls mit optionalem results_limit und sort_by per POST an /v1/facebook/group-posts und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie den zurückgegebenen next_cursor an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Facebook Group Posts API

  • Prüfung der Aktivität öffentlicher Gruppen: Nutzen Sie die Sortierung recent_activity oder chronological mit den Feldern message, author, created_at und group_url, um öffentliche Beiträge ausgewählter Gruppen zu prüfen.
  • Archive von Gruppendiskussionen: Speichern Sie Beitrags-IDs, Nachrichtentext, Autorenkontext, Quell-URLs, Veröffentlichungszeiten und Erfassungszeiten als zuordenbare öffentliche Gruppendatensätze.
  • Abgestimmter Vergleich der Interaktion: Wenden Sie dasselbe sort_by auf alle Gruppen-URLs an und vergleichen Sie reactions_count, comments_count und views_count unter einer einheitlichen Sortierung.

Profi-Tipps zur Facebook Group Posts API

  • Senden Sie direkte öffentliche Gruppen-URLs statt eines Gruppennamens, damit jede Eingabe einer eindeutigen Quelle zugeordnet bleibt.
  • Berechnen Sie die angeforderte Tiefe als Anzahl der urls multipliziert mit results_limit, denn das Limit gilt separat für jede Gruppe.
  • Führen Sie getrennte Aufgaben aus, wenn Sie Sortiermodi vergleichen, denn ein sort_by-Wert gilt für jede Gruppen-URL einer Anfrage.
  • Behalten Sie id und extra.group_url zusammen bei, damit nachgelagerte Datensätze zuordenbar bleiben und innerhalb jeder Gruppe dedupliziert werden können.
  • Behandeln Sie Autor, Nachricht, Veröffentlichungszeit, Videomedien und Videoaufrufe als optional, wenn ein öffentlicher Beitrag sie nicht preisgibt.
  • Folgen Sie results.next_cursor, bis has_more den Wert false hat, wenn die abgeschlossene Aufgabe mehr als eine Ergebnisseite enthält.

Ergänzend zur Facebook Group 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 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 Ad Transcript API — Verfügbaren gesprochenen Text, Sprache, Format und Quellkontext aus URLs der Facebook Ad Library extrahieren.
  • Facebook Profile Photos API — Öffentliche Fotos aus Profil- oder Seiten-URLs mit Bildunterschriften, Autorenkontext, Interaktionen, Bildmetadaten und Quellverweisen erfassen.

Weitere Plattformen entdecken

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

Facebook Group Posts API — FAQ

Facebook Group Posts API ist eine Schnittstelle zum Abrufen öffentlicher Beiträge aus einer oder mehreren Facebook-Gruppen-URLs, optional mit Sortierung. Sie liefert normalisierten Beitragstext, Autorendetails, Zeitstempel, Videomedien, sichtbare Interaktion und die URL der Quellgruppe.

Senden Sie in urls eine oder mehrere öffentliche Facebook-Gruppen-URLs. Leere Eingabelisten werden abgelehnt, und Inhalte, die die öffentliche Gruppenoberfläche nicht preisgibt, können nicht in den Ergebnissen erscheinen.

sort_by akzeptiert top_posts, recent_activity, chronological oder chronological_listings. Der gewählte Wert gilt für jede Gruppen-URL der Anfrage.

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 3 bis 2.000 und gilt separat für jede Gruppen-URL. Zwei URLs mit results_limit 30 fordern bis zu 60 Beiträge an.

Ein normalisierter Datensatz kann id, url, message, author, reactions_count, comments_count, views_count, Videomedien, created_at, collected_at und extra.group_url enthalten. Felder, die im öffentlichen Beitrag fehlen, bleiben je nach normalisiertem Typ null, 0 oder leer.

Lesen Sie data.results.items aus GET /v1/tasks/{task_id}. Hat has_more den Wert true, übergeben Sie results.next_cursor bei der nächsten Aufgabenanfrage als cursor; jede Seite akzeptiert ein limit von 1 bis 500.

Jeder zurückgegebene Gruppenbeitragsdatensatz kostet 1,2 SocQ-Credits. Die Kostenschätzung der Anfrage ergibt sich aus urls multipliziert mit results_limit, und eine leere Ergebnismenge verursacht keine Ergebnisgebühr.