facebook/
profile-photos

Öffentliche Fotos von Facebook-Profilen und -Seiten aus einer oder mehreren URLs sammeln – mit Bildunterschriften, Autorenkontext, Interaktion, Bildmetadaten und Quelllinks als normalisierte Datensätze.

Facebook Profile Photos API

Profilfotos
Bildmetadaten
Öffentliche Daten
0,5 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 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

ParameterErforderlichBeschreibung
urlsErforderlichURLs öffentlicher Facebook-Profile oder -Seiten, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale 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.

  1. Bereiten Sie eine oder mehrere URLs öffentlicher Facebook-Profile oder -Seiten vor.
  2. Senden Sie urls mit optionalem results_limit per POST an /v1/facebook/profile-photos.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
  4. 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.

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.

Weitere Plattformen entdecken

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

Facebook Profile Photos API — FAQ

Facebook Profile Photos API ist eine Schnittstelle, die den öffentlichen Foto-Feed eines angegebenen Facebook-Profils oder einer Seite zu einheitlichen Mediendatensätzen ordnet und so Massenbestandsaufnahmen und laufende Beobachtung vereinfacht. Diese Datensätze eignen sich für die Recherche zu visuellen Inhalten und die Profilbeobachtung, wobei die Abdeckung auf Inhalte beschränkt ist, die über den öffentlichen Foto-Feed des Ziels zugänglich sind.

Verwenden Sie öffentliche Profile oder Seiten auf facebook.com, www.facebook.com oder m.facebook.com. Die Validierung prüft den Host, daher kann eine andere Facebook-Ressource trotzdem keinen Foto-Feed liefern.

Ein Datensatz kann Foto-ID, kanonische URL, Text der Bildunterschrift, rohen öffentlichen Autorenkontext, sichtbare Kennzahlen, Medien-URLs und Abmessungen, created_at, collected_at sowie extra.input_url enthalten.

Setzen Sie results_limit auf einen Wert von 20 bis 2.000; standardmäßig gilt 100. Das Limit gilt für jede übergebene URL einzeln, und ein Feed kann enden, bevor es erreicht ist.

Private, eingeschränkte, gelöschte, nur nach Anmeldung sichtbare oder anderweitig nicht verfügbare Fotos werden nicht zurückgegeben. Albumstruktur, Kommentare, markierte Personen, vollständige Aufschlüsselungen der Reaktionen und Downloads der Originaldateien sind nicht garantiert.

Jeder gespeicherte Fotodatensatz kostet 0,5 Credits, ohne Grundgebühr pro Aufgabe. Schätzungen multiplizieren das Ergebnislimit pro URL mit der Anzahl der übergebenen URLs.