Facebook Profile Photos
Facebook-Profilfotos sind öffentliche Bilder im Feed eines Profils oder einer Seite, mit Bildunterschriften, Autorenkontext, sichtbarer Interaktion, Abmessungen und Quelllinks. Diese Datensätze eignen sich für Medieninventare, die Recherche zu visuellen Inhalten und die Beobachtung einzelner Profile.
Funktionen der Facebook Profile Photos API
- Foto-Feeds mehrerer ProfileSammeln Sie öffentliche Fotodatensätze aus einer oder mehreren URLs von Facebook-Profilen oder -Seiten, wobei das angeforderte Limit für jede Eingabe einzeln gilt.
- Normalisierte BildmetadatenLiefert Bild-URLs, Vorschaubilder, Breite, Höhe und Dauerangaben zusammen mit Foto-IDs und kanonischen Links.
- Foto- und QuellenkontextBehält Bildunterschriften, öffentliche Autorendaten, sichtbare Interaktion, Zeitstempel und extra.input_url für Analyse und Quellenzuordnung bei.
- Cursorbasiertes Durchlaufen des FeedsFolgt den Cursorn des öffentlichen Foto-Feeds und entfernt doppelte Datensätze anhand stabiler ID, URL oder Bildidentität, bevor das Limit pro Eingabe erreicht ist.
Parameter der Facebook Profile Photos API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | URLs öffentlicher Facebook-Profile oder -Seiten, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale Anzahl der Fotos, die pro Eingabe-URL gesammelt werden, von 20 bis 2.000; Standardwert ist 100. |
So verwenden Sie die Facebook Profile Photos API
Senden Sie URLs öffentlicher Profile oder Seiten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Fotodatensätze per Cursor-Paginierung der Ergebnisse aus.
- Bereiten Sie eine oder mehrere URLs öffentlicher Facebook-Profile oder -Seiten vor.
- Senden Sie urls mit optionalem results_limit per POST an /v1/facebook/profile-photos.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und übergeben Sie results.next_cursor, solange weitere gespeicherte Fotos vorhanden sind.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Anwendungsfälle der Facebook Profile Photos API
- Öffentliches Medieninventar: Ordnen Sie Foto-IDs, kanonische Links, Bild-URLs, Abmessungen, Bildunterschriften und Quelleingaben zu einem profilbezogenen Asset-Index.
- Recherche zu visuellen Inhalten: Vergleichen Sie Bildunterschriften, Bildmetadaten, Zeitstempel und sichtbare Interaktion, um Muster bei der Veröffentlichung öffentlicher Fotos zu untersuchen.
- Beobachtung von Profilfotos: Wiederholen Sie die Erfassung für ausgewählte URLs von Profilen oder Seiten und erkennen Sie mit Fotoidentität und extra.input_url neu sichtbar gewordene Datensätze.
Profi-Tipps zur Facebook Profile Photos API
- Verwenden Sie URLs von Profilen und Seiten auf facebook.com, www.facebook.com oder m.facebook.com, die einen öffentlichen Foto-Feed bereitstellen; die Prüfung des Hosts allein garantiert nicht, dass die Zielressource geeignet ist.
- Legen Sie results_limit im Hinblick auf die Zahl der Eingabe-URLs fest, denn das Limit von 20 bis 2.000 gilt für jede URL unabhängig.
- Entfernen Sie beim Zusammenführen mehrerer Läufe Duplikate anhand von Foto-ID, URL oder Bildidentität zusammen mit extra.input_url, damit das richtige Quellprofil erhalten bleibt.
- Behandeln Sie Bildunterschriften, Autorenfelder, Kennzahlen, Zeitstempel und Medienabmessungen als optional und prüfen Sie, ob ein Medium eine Bild-URL enthält, bevor Sie es anzeigen oder herunterladen.
Verwandte APIs
Ergänzend zur Facebook Profile Photos 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 Video Transcript API — Verfügbaren Transkripttext und das Format aus bekannten öffentlichen Video-Beitrags- oder Reel-URLs extrahieren.
- Facebook Group Posts API — Öffentliche Beiträge aus URLs von Facebook-Gruppen erfassen – mit wählbarer Sortierung, Limits pro Gruppe, Autorenkontext, Videomedien und sichtbaren Interaktionen.
- Facebook Ad Transcript API — Verfügbaren gesprochenen Text, Sprache, Format und Quellkontext aus URLs der Facebook Ad Library extrahieren.
- 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.