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_limitpro Benutzername anPOST /v1/instagram/reels. Speichern Sie die zurückgegebenetask_id, fragen Sie den Endpunkt für Aufgaben ab und lesen Sie die normalisierten Reel-Datensätze ausdata.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:
- Erfassen Sie ein angemessenes aktuelles Zeitfenster.
- Sortieren Sie Datensätze nach
created_at, sofern verfügbar. - Behandeln Sie alte, wiederholt auftauchende Datensätze nicht mehr als neue Funde.
- Führen Sie ein Upsert nach Reel-ID durch.
- Hängen Sie eine Momentaufnahme nur an, wenn die Erfassung erfolgreich war.
- 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:
platformmussinstagramentsprechen.resourcemussreelsentsprechen.- Mindestens eines von
id,shortcodeoderurlmuss vorhanden sein. author.usernamesollte, sofern verfügbar, zum übermittelten Creator passen.- Zähler müssen nicht negative Zahlen oder null sein.
created_atundcollected_atmü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:
- Klären Sie, dass die Speicherung des Assets zulässig ist.
- Laden Sie nur die Medien herunter, die für den genannten Zweck nötig sind.
- Halten Sie die ursprüngliche URL und den Zeitpunkt der Erfassung fest.
- Wenden Sie Kontrollen für Aufbewahrung und Löschung an.
- 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
| Fall | Empfohlene Behandlung |
|---|---|
| Ungültiger Benutzername | Vor dem Senden zurückweisen |
| Privates Konto | Als nicht verfügbar markieren; nicht umgehen |
| Umbenanntes Konto | Manuell auflösen oder Registry aktualisieren |
| Keine öffentlichen Reels | Eine leere erfolgreiche Beobachtung speichern |
| Zeitüberschreitung bei der Aufgabe | Abfrage wiederholen, bevor erneut übermittelt wird |
| Fehlende Kennzahlen | null beibehalten |
| Doppeltes Reel | Upsert nach ID oder Shortcode |
| Abgelaufene Medien-URL | Nur 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