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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche 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.
- Bereiten Sie eine oder mehrere URLs öffentlicher Profile oder Seiten auf facebook.com, www.facebook.com oder m.facebook.com vor.
- Senden Sie urls per POST an /v1/facebook/profiles.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- 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.
Verwandte APIs
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.