facebook/
profiles

Öffentliche Details von Facebook-Profilen und -Seiten aus bekannten URLs sammeln – mit Identität, Namen, Bios, Avataren, sichtbaren Zählern und höchstens einem normalisierten Datensatz pro Eingabe.

Facebook Profiles API

Profilabfrage
Seitenabfrage
Bekannte URLs
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 Profiles

Facebook-Profile und -Seiten sind öffentliche Identitätsflächen mit Namen, Bio- oder Info-Text, Avataren, kanonischen Links und sichtbaren Zählern zu Reichweite oder Aktivität. Diese Identitätsfelder und öffentlichen Signale eignen sich für die Anreicherung von URLs, den Abgleich von Entitäten, Metadaten-Momentaufnahmen und vergleichende Recherche.

Funktionen der Facebook Profiles API

  • Direkte Abfrage bekannter URLsÜbergeben Sie mehrere URLs öffentlicher Facebook-Profile oder -Seiten und erhalten Sie für jede Eingabe höchstens einen normalisierten Profildatensatz.
  • Normalisierte IdentitätsfelderLiefert Facebook-ID, kanonische URL, Anzeigenamen, Datensatztyp und die ursprüngliche Eingabe-URL in einer einheitlichen Struktur.
  • Öffentliche ProfildarstellungErfasst die öffentliche Bio, Vorstellung, Beschreibung oder den Info-Text zusammen mit dem verfügbaren Avatar des Profils oder der Seite.
  • Sichtbare ProfilzählerNormalisiert gängige öffentliche Zähler für Follower, Gefolgte, Beiträge, Likes, Kommentare, Aufrufe, Wiedergaben und Shares, die das Ziel bereitstellt.

Parameter der Facebook Profiles API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche URLs öffentlicher Facebook-Profile oder -Seiten. Zulässige Hosts sind facebook.com, www.facebook.com und m.facebook.com; trennen Sie mehrere Werte durch Kommas oder Zeilenumbrüche.

So verwenden Sie die Facebook Profiles API

Senden Sie URLs von Profilen oder Seiten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie anschließend die normalisierten Profildatensätze.

  1. Bereiten Sie eine oder mehrere URLs öffentlicher Profile oder Seiten auf facebook.com, www.facebook.com oder m.facebook.com vor.
  2. Senden Sie urls per POST an /v1/facebook/profiles.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
  4. Lesen Sie data.results.items aus /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"]}'

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

Anwendungsfälle der Facebook Profiles API

  • Anreicherung von Profil- und Seitenkatalogen: Ergänzen Sie einen Katalog bekannter Facebook-URLs um normalisierte IDs, Namen, kanonische Links, Bio-Texte, Avatare und sichtbare Zähler.
  • Identitätsabgleich bekannter URLs: Verknüpfen Sie übergebene Links mit bestehenden Entitätsdatensätzen, indem Sie die zurückgegebenen IDs, kanonischen URLs, Namen und extra.input_url nutzen.
  • Momentaufnahmen öffentlicher Metadaten: Speichern Sie collected_at zusammen mit dem verfügbaren Profiltext, Avatar und den Zählern, um öffentliche Metadaten über mehrere Erfassungsläufe hinweg zu vergleichen.

Profi-Tipps zur Facebook Profiles API

  • Prüfen Sie, ob jede URL auf das gewünschte Profil oder die gewünschte Seite verweist, denn die Anfragevalidierung prüft den Facebook-Host, aber nicht den Ressourcenpfad.
  • Behalten Sie extra.input_url bei, wenn Sie eine Aufgabe mit mehreren URLs abgleichen, denn doppelte oder nicht verfügbare Eingaben können weniger Datensätze ergeben als übergebene URLs.
  • Behandeln Sie Namen, Profiltext, Avatare und einzelne Kennzahlen als nullable, da persönliche Profile und Seiten unterschiedliche öffentliche Felder bereitstellen.
  • Nutzen Sie den passenden Facebook-Endpunkt für Inhalte, wenn Sie Beiträge, Fotos, Reels, Veranstaltungen oder Bewertungen statt Metadaten auf Profilebene benötigen.

Ergänzend zur Facebook Profiles 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 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 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 Profiles API — FAQ

Facebook Profiles API ist eine Schnittstelle zum Abrufen öffentlicher Identitätsdetails aus bekannten URLs von Facebook-Profilen oder -Seiten, damit sich Datensätze leichter anreichern und abgleichen lassen. Sie unterstützt die Anreicherung von URLs, den Abgleich von Entitäten und Profil-Momentaufnahmen; jede Eingabe liefert höchstens einen öffentlichen Datensatz, und der Endpunkt führt keine stichwortbasierte Profilsuche durch.

Übergeben Sie nicht leere URLs auf facebook.com, www.facebook.com oder m.facebook.com. Die Validierung prüft den Host, aber nicht, ob der Pfad ein Profil oder eine Seite bezeichnet; dieser Endpunkt führt also eine direkte Abfrage und keine Profilsuche durch.

Ein normalisierter Datensatz enthält id, platform, resource, type, url, name, text, avatar_url, metrics, created_at, collected_at und extra.input_url. created_at wird derzeit als null zurückgegeben.

Ja, die Abfrage ist für URLs öffentlicher Profile oder Seiten gedacht. Deren sichtbare Felder unterscheiden sich, daher sollten Clients nicht davon ausgehen, dass jeder Datensatz dieselbe Bio, denselben Avatar oder dieselben Zähler enthält.

Jede URL kann höchstens einen Datensatz ergeben, während doppelte, private, nur nach Anmeldung zugängliche, gelöschte, falsch geschriebene oder nicht verfügbare Ziele keinen ergeben können. Ordnen Sie die zurückgegebenen Datensätze mit extra.input_url der ursprünglichen Anfrage zu.

Die Nutzung kostet 1,2 Credits für jeden gespeicherten Profildatensatz, ohne Grundgebühr pro Aufgabe. Ein leeres Ergebnis verursacht keine ergebnisabhängigen Kosten.