InstagramReelsAPI-Anleitung

Instagram-Reels-Daten per API scrapen: Anleitung

Einen Produktions-Workflow zur Erfassung öffentlicher Instagram Reels per Benutzername aufbauen: Bildunterschriften, Medien, Audio, sichtbare Kennzahlen, Paginierung und Momentaufnahmen von Kennzahlen.

SocQAktualisiert am 19. Juli 20267 Min. Lesezeit

Ein einzelnes Instagram Reel manuell zu erfassen ist einfach. Einen wiederholbaren Datenbestand über Hunderte öffentlicher Creator aufzubauen ist schwieriger: Reels können verschwinden, Kennzahlen ändern sich, Medien-URLs laufen ab, und die sichtbaren Felder unterscheiden sich von Beitrag zu Beitrag.

Diese Anleitung zeigt, wie Sie öffentliche Reels per Benutzername mit der SocQ Instagram Reels API erfassen, die asynchrone Aufgabe abfragen, stabile Entitätsfelder getrennt von Momentaufnahmen der Kennzahlen speichern und die Daten für Monitoring oder Analyse aufbereiten.

Kurze Antwort: Senden Sie öffentliche Benutzernamen und ein results_limit pro Benutzername an POST /v1/instagram/reels. Speichern Sie die zurückgegebene task_id, fragen Sie den Endpunkt für Aufgaben ab und lesen Sie die normalisierten Reel-Datensätze aus data.results.items. Der aktuelle Endpunkt akzeptiert Benutzernamen, keine einzelnen Reel-URLs.

Offizielle Instagram API oder öffentliche Reels-API?

Die offiziellen Instagram-APIs von Meta sind die richtige Wahl, wenn ein Nutzer ein unterstütztes professionelles Konto autorisiert und Ihre Anwendung Veröffentlichung, Insights, Kommentarverwaltung oder andere berechtigungspflichtige Operationen braucht.

Sie sind kein allgemeiner Endpunkt, um beliebige öffentliche Verbraucherprofile zu erfassen. Der offizielle Zugriff hängt vom Kontotyp, von Berechtigungen, Tokens, der App-Prüfung und dem gewählten Instagram-Produkt ab. Lesen Sie die aktuelle Dokumentation der Instagram Platform, bevor Sie einen autorisierten Workflow entwerfen.

Nutzen Sie SocQ für einen unterstützten lesenden Workflow mit öffentlichen Daten. Nutzen Sie die offiziellen APIs von Meta für Kontoaktionen und berechtigungspflichtige Insights. Eine API für öffentliche Daten erlaubt es nicht, die Bedingungen von Instagram, Datenschutzrechte oder Regeln zum geistigen Eigentum zu ignorieren.

Eine Aufgabe für Instagram Reels übermitteln

Der aktuelle Endpunkt akzeptiert einen oder mehrere öffentliche Benutzernamen:

curl -X POST "https://api.socq.ai/v1/instagram/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["natgeo", "instagram"],
    "results_limit": 100
  }'

Normalisieren Sie Benutzernamen vor dem Senden:

  • Entfernen Sie ein führendes @.
  • Schneiden Sie Leerraum ab.
  • Wandeln Sie Profil-URLs in Ihrer Eingabeschicht in Benutzernamen um.
  • Entfernen Sie Duplikate ohne Beachtung der Groß- und Kleinschreibung.
  • Weisen Sie leere Werte zurück.

results_limit begrenzt die angeforderten Ergebnisse pro Benutzername; es garantiert nicht, dass jeder Creator so viele öffentlich verfügbare Reels hat.

Die asynchrone Aufgabe abfragen

Speichern Sie die zurückgegebene task_id und fragen Sie den Status ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Behandeln Sie queued und running als Normalfall. Nutzen Sie exponentielles Backoff, statt in einer engen Schleife abzufragen. Wenn die Aufgabe erfolgreich abgeschlossen ist, lesen Sie data.results.items. Ist has_more true, fordern Sie die nächste Seite mit next_cursor an.

Ein robuster Worker sollte Folgendes speichern:

  • Batch-ID.
  • SocQ-Aufgaben-ID.
  • Übermittelte Benutzernamen.
  • Zeitpunkte von Übermittlung und Abschluss.
  • Endstatus und Fehlerkategorie.
  • Zuletzt verarbeiteten Cursor der Ergebnisse.

Mit diesem Zustand kann der Worker fortsetzen, ohne eine abgeschlossene Erfassung erneut zu übermitteln.

Die Reel-Antwort verstehen

Ein normalisierter Reel-Datensatz sieht etwa so aus:

{
  "id": "3138424916027781494",
  "platform": "instagram",
  "resource": "reels",
  "type": "reel",
  "shortcode": "CtjoC2BNsB2",
  "url": "https://www.instagram.com/reel/CtjoC2BNsB2/",
  "caption": "A public Instagram Reel.",
  "author": {
    "id": "123",
    "username": "natgeo",
    "name": "National Geographic",
    "url": "https://www.instagram.com/natgeo"
  },
  "metrics": {
    "likes_count": 21904,
    "comments_count": 502,
    "views_count": 284110,
    "plays_count": 284110
  },
  "media": [],
  "duration_seconds": 42,
  "audio": {
    "title": "Original audio",
    "artist": "natgeo"
  },
  "hashtags": [],
  "mentions": [],
  "created_at": "2026-07-08T16:05:00",
  "collected_at": "2026-07-19T10:00:00",
  "extra": {}
}

Verwenden Sie id als bevorzugten Entitätsschlüssel und shortcode als Ausweichwert. Behalten Sie url zur Nachvollziehbarkeit. Kennzahlen, Medien, Audio und manche Profilfelder können fehlen; modellieren Sie sie als nullbar, statt fehlende Werte in null oder leere Zeichenfolgen umzuwandeln.

Entitäten und Momentaufnahmen von Kennzahlen getrennt speichern

Die Identität eines Reels und seine Kennzahlen ändern sich unterschiedlich schnell.

Eine Entitätstabelle kann Folgendes speichern:

reel_id
shortcode
canonical_url
author_id
caption
created_at
duration_seconds
audio
first_seen_at
last_seen_at

Eine Tabelle für Momentaufnahmen kann Folgendes speichern:

reel_id
collected_at
likes_count
comments_count
views_count
plays_count

So erzeugt tägliches Monitoring keine doppelten Reel-Entitäten, und das Wachstum über die Zeit bleibt erhalten.

Berechnen Sie kein Wachstum, wenn in einer der beiden Momentaufnahmen die Kennzahl fehlt. Ein verborgener Wert ist nicht null. Vermeiden Sie außerdem, views_count und plays_count so zu vergleichen, als würde jede Quelle sie gleich definieren.

Einen inkrementellen Reels-Monitor aufbauen

Der einfachste zuverlässige Monitor:

Creator registry
      ↓
Daily or hourly collection schedule
      ↓
Async task polling
      ↓
Schema validation
      ↓
Upsert Reel entity by id
      ↓
Append metric snapshot
      ↓
Alerts and reports

Für jeden Creator:

  1. Erfassen Sie ein angemessenes aktuelles Zeitfenster.
  2. Sortieren Sie Datensätze nach created_at, sofern verfügbar.
  3. Behandeln Sie alte, wiederholt auftauchende Datensätze nicht mehr als neue Funde.
  4. Führen Sie ein Upsert nach Reel-ID durch.
  5. Hängen Sie eine Momentaufnahme nur an, wenn die Erfassung erfolgreich war.
  6. Verfolgen Sie den letzten erfolgreichen Lauf des Creators getrennt von der Übermittlung der Aufgabe.

Instagram-Feeds sind gerankt, und die Verfügbarkeit der Quelle kann sich ändern. Der Endpunkt sollte nicht als garantiert vollständiges historisches Archiv betrachtet werden.

Python-Beispiel mit Paginierung

import time
import requests

BASE = "https://api.socq.ai/v1"
HEADERS = {
    "Authorization": f"Bearer {SOCQ_API_KEY}",
    "Content-Type": "application/json",
}

created = requests.post(
    f"{BASE}/instagram/reels",
    headers=HEADERS,
    json={"usernames": ["natgeo"], "results_limit": 200},
    timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"]["task_id"]

delay = 2
while True:
    response = requests.get(
        f"{BASE}/tasks/{task_id}",
        headers=HEADERS,
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()["data"]

    if task["status"] == "succeeded":
        break
    if task["status"] in {"failed", "cancelled"}:
        raise RuntimeError(task)

    time.sleep(delay)
    delay = min(delay * 1.5, 15)

items = task["results"]["items"]
cursor = task["results"].get("next_cursor")

while cursor:
    page = requests.get(
        f"{BASE}/tasks/{task_id}",
        headers=HEADERS,
        params={"limit": 100, "cursor": cursor},
        timeout=30,
    )
    page.raise_for_status()
    results = page.json()["data"]["results"]
    items.extend(results["items"])
    cursor = results.get("next_cursor")

Ergänzen Sie im Produktivbetrieb begrenzte Wiederholungen bei Zeitüberschreitungen, 429 und wiederholbaren 5xx-Antworten. Übermitteln Sie fehlgeschlagene Eingaben nicht automatisch erneut, ohne die Fehlerkategorie zu prüfen.

Reel-Daten vor dem Speichern validieren

Empfohlene Prüfungen:

  • platform muss instagram entsprechen.
  • resource muss reels entsprechen.
  • Mindestens eines von id, shortcode oder url muss vorhanden sein.
  • author.username sollte, sofern verfügbar, zum übermittelten Creator passen.
  • Zähler müssen nicht negative Zahlen oder null sein.
  • created_at und collected_at müssen sich als Zeitstempel parsen lassen.
  • Medieneinträge sind als Quellverweise zu behandeln, nicht als dauerhafte Assets.

Halten Sie ungültige Datensätze in einer Quarantänetabelle mit der rohen Aufgabe und dem Validierungsfehler fest. Stilles Umwandeln von Feldern verdeckt Änderungen der Quelle.

Medien-URLs sind kein dauerhafter Speicher

URLs für Reel-Videos, Bilder, Cover und Avatare können signiert, umgewandelt, ratenbegrenzt oder verändert sein. Gehen Sie nicht davon aus, dass eine heute erfasste URL für immer funktioniert.

Wenn das Produkt Medien langfristig aufbewahren muss:

  1. Klären Sie, dass die Speicherung des Assets zulässig ist.
  2. Laden Sie nur die Medien herunter, die für den genannten Zweck nötig sind.
  3. Halten Sie die ursprüngliche URL und den Zeitpunkt der Erfassung fest.
  4. Wenden Sie Kontrollen für Aufbewahrung und Löschung an.
  5. Liefern Sie gespeicherte Medien sicher aus.

Wenn die Analyse nur Bildunterschriften und Kennzahlen braucht, kann die Speicherung großer Mediendateien Kosten und Risiko erhöhen, ohne Nutzen zu stiften.

Reel-Performance sorgfältig messen

Nützliche abgeleitete Kennzahlen sind unter anderem:

engagement_per_play =
  (likes + comments) / plays

daily_play_growth =
  (current_plays - previous_plays) / elapsed_days

Berechnen Sie eine Kennzahl nur, wenn ihre Eingaben vorhanden sind. Vergleichen Sie Creator mit einheitlichen Fenstern und Erfassungsplänen. Ein Reel, das vor zwei Stunden veröffentlicht wurde, sollte nicht ohne Normalisierung der Zeit gegen eines gerankt werden, das zwei Wochen lang beobachtet wurde.

Öffentliche Zähler sind sichtbare Momentaufnahmen, keine geprüften Analysen. Für eigene professionelle Konten sind die offiziellen Instagram Insights die bessere Quelle für berechtigungspflichtige Performance-Daten.

Typische Fehlerfälle behandeln

FallEmpfohlene Behandlung
Ungültiger BenutzernameVor dem Senden zurückweisen
Privates KontoAls nicht verfügbar markieren; nicht umgehen
Umbenanntes KontoManuell auflösen oder Registry aktualisieren
Keine öffentlichen ReelsEine leere erfolgreiche Beobachtung speichern
Zeitüberschreitung bei der AufgabeAbfrage wiederholen, bevor erneut übermittelt wird
Fehlende Kennzahlennull beibehalten
Doppeltes ReelUpsert nach ID oder Shortcode
Abgelaufene Medien-URLNur aktualisieren, wenn der Anwendungsfall es erlaubt

Ein leeres erfolgreiches Ergebnis und eine fehlgeschlagene Aufgabe sind unterschiedliche Betriebszustände.

Verantwortungsvolle Nutzung

  • Erfassen Sie nur öffentliche Daten, die für einen legitimen Zweck nötig sind.
  • Greifen Sie nicht auf private Profile zu und umgehen Sie keine Schutzmaßnahmen.
  • Vermeiden Sie das Profiling sensibler Einzelpersonen.
  • Beachten Sie Anfragen zu Löschung, Datenschutz und geistigem Eigentum.
  • Sichern Sie API-Schlüssel, Exporte und Medien.
  • Prüfen Sie die Bedingungen von Instagram und Ihren Vertrag mit dem Anbieter.
  • Nutzen Sie für Kontoaktionen die offizielle Autorisierung von Meta.

SocQ stellt einen technischen Erfassungs-Workflow bereit, keine zusätzlichen Rechte an Inhalten.

Instagram Reels API: Häufig gestellte Fragen (FAQ)

Kann SocQ eine einzelne Reel-URL direkt scrapen?

Der aktuelle Reels-Endpunkt akzeptiert öffentliche Benutzernamen, keine einzelnen Reel-URLs. Er liefert die verfügbaren öffentlichen Reels dieser Creator.

Liefert der Endpunkt Videodateien?

Er liefert normalisierte öffentliche Medienverweise, sofern verfügbar. Behandeln Sie URLs als temporäre Quellverweise, nicht als dauerhafte Downloads.

Sind Aufruf- und Wiedergabezahlen immer vorhanden?

Nein. Instagram kann Kennzahlen verbergen oder auslassen. Behalten Sie fehlende Werte als null bei.

Kann ich Reels aus privaten Konten erfassen?

Nein. Ein Workflow mit öffentlichen Daten sollte die Schutzmaßnahmen privater Konten nicht umgehen.

Wie vermeide ich doppelte Reels?

Verwenden Sie die öffentliche Reel-ID als bevorzugten Schlüssel und den Shortcode als Ausweichwert. Speichern Sie Kennzahlen in einer separaten Tabelle für Momentaufnahmen.

Sollte ich stattdessen die offizielle Instagram API von Meta nutzen?

Nutzen Sie die offizielle API für autorisierte professionelle Konten, Veröffentlichung, Insights und Kontoaktionen. Nutzen Sie SocQ für den unterstützten lesenden Workflow mit öffentlichen Daten.

INSTAGRAM API

Workflow mit einer öffentlichen Instagram-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

Instagram-APIs ansehen