Facebook Pages
Facebook-Seiten sind öffentliche Profile von Unternehmen, Organisationen, Creator und Personen des öffentlichen Lebens, mit Identität, Kategorien, Beschreibungen, Bildern, Kontaktdaten und Publikumssignalen. Diese Profil- und Publikumsfelder unterstützen die Markenentdeckung, die Anreicherung von Verzeichnissen, die Marktforschung und den Vergleich von Konten.
Funktionen der Facebook Pages API
- Stapelerfassung von SeitenErfassen Sie eine oder mehrere öffentliche Facebook-Seiten über ihre Seiten-URLs.
- Identität und Bilder der SeiteLiefert Seitenname, Kategorie, Info-Text, kanonische URL, Avatar und Titelbild als normalisierte Profilfelder.
- Sichtbare PublikumskennzahlenEnthält die sichtbaren Kennzahlen zu Followern, Seiten-Likes, Bewertungen und Ratings in einem einheitlichen Objekt metrics.
- Öffentliche KontaktdatenLiefert öffentliche Felder für Website, E-Mail, Telefon und Adresse zur Anreicherung von Kontakten und Verzeichnissen.
- Grenze der öffentlichen DatenBeschränkt die Ergebnisse auf öffentlich zugängliche Seitendaten; private, eingeschränkte und nur mit Anmeldung sichtbare Inhalte bleiben außerhalb der Antwort.
Parameter der Facebook Pages API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche Facebook-Seiten-URLs, durch Kommas oder Zeilenumbrüche getrennt. |
results_limit | Optional | Maximale Anzahl an Datensätzen, die die Erfassungsaufgabe anfordern soll. Muss eine positive ganze Zahl sein. |
So verwenden Sie die Facebook Pages API
Senden Sie eine Erfassungsaufgabe, fragen Sie die Aufgaben-ID ab, bis die Verarbeitung abgeschlossen ist, und lesen Sie anschließend die normalisierten Seitendatensätze per Cursor-Paginierung.
- Bereiten Sie eine oder mehrere öffentliche Facebook-Seiten-URLs vor.
- Senden Sie urls und optional results_limit per POST an /v1/facebook/pages.
- 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.
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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Anwendungsfälle der Facebook Pages API
- Beobachtung von Markenseiten: Erfassen Sie öffentliche Identität, Kategorie, Kontaktdaten und Publikumskennzahlen von Seiten, um eigene oder konkurrierende Seiten zu verfolgen.
- Benchmark-Datensätze zu Seiten: Vergleichen Sie Kategorien, Beschreibungen, Umfang der Kontaktdaten, Follower-Zahlen, Ratings und weitere sichtbare Publikumssignale über ausgewählte Seiten hinweg.
- Reporting- und BI-Pipelines: Leiten Sie normalisierte öffentliche Seitendatensätze an Dashboards, Tabellen, Data Warehouses oder interne Prüfwerkzeuge weiter.
- Workflows für Medienarchive: Speichern Sie Seiten-URLs, Bilder, Beschreibungen, Kontaktfelder und sichtbare Kennzahlen für spätere Prüfung oder Berichte.
- Öffentliches Social Listening: Nutzen Sie öffentliche Seitenidentität und Publikumssignale, um Kataloge von Social-Media-Konten und Markendatensätze anzureichern.
Profi-Tipps zur Facebook Pages API
- Prüfen Sie vor dem Start eines großen Stapels, dass jede gesendete URL auf eine öffentliche Facebook-Seite führt.
- Rechnen Sie damit, dass manche öffentlichen Seiten je nach Verfügbarkeit der Ergebnisse Kontaktfelder, Bilder, Ratings oder Publikumszähler auslassen.
- Bewahren Sie stabile Seiten-IDs und kanonische URLs auf, damit Aufgaben wiederholt, geprüft und dedupliziert werden können.
- Nutzen Sie die Facebook Posts API, wenn Ihr Workflow öffentliche Beitragsdatensätze einer Seite oder einer anderen unterstützten URL benötigt.
- Vermeiden Sie Workflows rund um private Seiten, eingeschränkte Beiträge, Oberflächen mit Anmeldung oder kontoeigene Daten, sofern separat veröffentlichte Dokumentation sie nicht ausdrücklich unterstützt.
Verwandte APIs
Ergänzend zur Facebook Pages API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook-Daten benötigen.
- 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 Profile Events API — Öffentliche Veranstaltungen zu Profil- oder Seiten-URLs erfassen, einschließlich Namen, Terminen, Orten, Medien, sichtbaren Kennzahlen und Quellkontext.
- Facebook Profile Photos API — Öffentliche Fotos aus Profil- oder Seiten-URLs mit Bildunterschriften, Autorenkontext, Interaktionen, Bildmetadaten und Quellverweisen erfassen.
- Facebook Profiles API — Öffentliche Profile oder Seiten aus bekannten Facebook-URLs abrufen – mit Identität, Bio, Avatar, sichtbaren Zählern und Eingabekontext.
- Facebook Reels API — Öffentliche Reels aus Profil- oder Seiten-URLs mit Bildunterschriften, Autorenkontext, Videometadaten, sichtbaren Interaktionen und Quellverweisen erfassen.