Facebook Reels
Facebook-Reels sind öffentliche Kurzvideos in den Feeds von Profilen oder Seiten, mit Bildunterschriften, Autorenkontext, Wiedergabemetadaten, Zeitstempeln und sichtbarer Interaktion. Diese Datensätze eignen sich für Inhaltsinventare, die Recherche zu Kurzvideos, die Beobachtung von Feeds und vergleichende Analysen.
Funktionen der Facebook Reels API
- Reel-Feeds mehrerer ProfileSammeln Sie öffentliche Reel-Datensätze aus einer oder mehreren URLs von Facebook-Profilen oder -Seiten, wobei das angeforderte Limit für jede Eingabe gilt und extra.input_url zur Zuordnung erhalten bleibt.
- Normalisierte VideomedienLiefert Video-URLs, Vorschaubilder, Abmessungen und Dauerangaben zusammen mit Reel-IDs und öffentlichen Quelllinks.
- Creator- und InteraktionskontextBehält Bildunterschriften, rohen öffentlichen Autorenkontext, sichtbare Likes, Kommentare, Aufrufe, Wiedergaben, Shares und Veröffentlichungszeiten für jedes normalisierte Reel bei.
- Stabiles Durchlaufen des FeedsFolgt profilspezifischen Cursorn und entfernt doppelte Reels anhand von ID, Beitrags-ID oder URL, bevor das Limit pro Eingabe erreicht ist.
Parameter der Facebook Reels API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | URLs öffentlicher Facebook-Profile oder -Seiten, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale Anzahl der Reels, die pro Eingabe-URL gesammelt werden, von 20 bis 2.000; Standardwert ist 100. |
So verwenden Sie die Facebook Reels API
Senden Sie URLs öffentlicher Profile oder Seiten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Reel-Datensätze per Cursor-Paginierung der Ergebnisse aus.
- Bereiten Sie eine oder mehrere URLs öffentlicher Facebook-Profile oder -Seiten vor, die Reel-Feeds bereitstellen.
- Senden Sie urls mit optionalem results_limit per POST an /v1/facebook/reels.
- 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 Reels vorhanden sind.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
-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 Reels API
- Reel-Inventar eines Profils: Ordnen Sie Reel-IDs, Quelllinks, Bildunterschriften, Videoverweise, Zeitstempel und extra.input_url zu einem profilbezogenen Inhaltsindex.
- Recherche zu Kurzvideo-Formaten: Vergleichen Sie Dauer, Abmessungen, Vorschaubilder, Bildunterschriften und sichtbare Interaktion, um zu untersuchen, wie öffentliche Reels aufgebaut sind und wie sie ankommen.
- Beobachtung von Reel-Feeds: Wiederholen Sie die Erfassung für ausgewählte URLs von Profilen oder Seiten und erkennen Sie mit stabiler Reel-Identität und Veröffentlichungszeit neu sichtbar gewordene Datensätze.
Profi-Tipps zur Facebook Reels API
- Verwenden Sie URLs von Profilen und Seiten auf facebook.com, www.facebook.com oder m.facebook.com, die einen öffentlichen Reel-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 wiederholter Läufe Duplikate anhand von Reel-ID, Beitrags-ID oder URL zusammen mit extra.input_url, damit das richtige Quellprofil erhalten bleibt.
- Behandeln Sie Bildunterschriften, Autorenfelder, Kennzahlen, Zeitstempel und Medienmetadaten als optional und prüfen Sie, ob ein Medium eine Video-URL enthält, bevor Sie es anzeigen oder herunterladen.
- Wenn Sie den gesprochenen Text benötigen, übergeben Sie die bekannte Reel-URL an die Facebook Video Transcript API, statt ein Transkript in den Reel-Datensätzen zu erwarten.
Verwandte APIs
Ergänzend zur Facebook Reels 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 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.