facebook/
pages

Öffentliche Facebook-Seitenprofile aus einer oder mehreren Seiten-URLs erfassen – mit normalisierter Identität, Kontaktdaten, Bildern, Follower- und Like-Zahlen, Bewertungen und Ratings.

Facebook Pages API

Seiten
Profile
Öffentliche Daten
2,4 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 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

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche Facebook-Seiten-URLs, durch Kommas oder Zeilenumbrüche getrennt.
results_limitOptionalMaximale 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.

  1. Bereiten Sie eine oder mehrere öffentliche Facebook-Seiten-URLs vor.
  2. Senden Sie urls und optional results_limit per POST an /v1/facebook/pages.
  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.
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.

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.

Weitere Plattformen entdecken

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

Facebook Pages API — FAQ

Facebook Pages API ruft öffentlich zugängliche Seitenprofile aus einer oder mehreren Facebook-Seiten-URLs ab. Sie liefert normalisierte Identität, Kategorien, Beschreibungen, Bilder, Kontaktdaten, Follower- und Like-Zahlen, Bewertungen und Ratings.

Die einfache Erfassung öffentlicher Seiten erfordert weder Zugangsdaten einer Facebook-App noch eine Facebook-Anmeldung. Gehen Sie nicht davon aus, dass die API Zugriff auf private, eingeschränkte oder nur mit Anmeldung sichtbare Inhalte bietet.

Zu den gängigen Feldern gehören Seiten-ID, Name, kanonische URL, Kategorie, Info-Text, Avatar, Titelbild, Follower- und Like-Zahlen, Bewertungen, Rating, Website, E-Mail, Telefon und Adresse.

Ja, sofern die öffentlichen Seitenergebnisse die URLs von Profil- und Titelbild preisgeben. Clients sollten Seiten berücksichtigen, die eines oder beide Bildfelder auslassen.

Das normalisierte Objekt metrics kann die sichtbare Follower-Zahl, die Zahl der Seiten-Likes, die Zahl der Bewertungen und das Rating enthalten, sofern das öffentliche Ergebnis sie preisgibt.

Facebook-Inhalte sind dynamisch, und die Struktur öffentlicher Ergebnisse kann sich ändern. Leere Felder, Zeitüberschreitungen, fehlende Kontaktdaten oder blockierte Anfragen sollten als normale Fälle von Verfügbarkeit und Ratenbegrenzung behandelt werden.

Verwenden Sie kleinere Limits, zurückhaltende Anfrageraten, Backoff nach Fehlern und längere Zeitlimits für die Verarbeitung großer Seiten. Vermeiden Sie umfangreiche, wiederholte Erfassungen derselben Seite.