instagram/
trending-reels

Die aktuelle Reel-Auswahl des Trend-Feeds ohne Selektoren erfassen – mit Bildunterschriften, Autoren, Medien, Zeitstempeln und sichtbarer Interaktion.

Instagram Trending Reels API

Keine Selektoren
Momentaufnahme des aktuellen Feeds
Normalisierte Reel-Datensätze
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

Instagram Trending Reels

Instagram Trending Reels sind öffentliche Kurzvideos, die in einem aktuellen Discovery-Feed ausgespielt werden, mit Bildunterschriften, Identität der Creator, Medien, Zeitstempeln und sichtbaren Interaktionssignalen. Diese Momentaufnahmen unterstützen die Prüfung von Kreativbeispielen, die Beobachtung von Entdeckungsfeeds, den Vergleich von Inhalten und weiterführende Reel-Recherche.

Funktionen der Instagram Trending Reels API

  • Feed-Momentaufnahme ohne SelektorErfassen Sie die aktuelle Reel-Auswahl des Trend-Feeds, ohne Suchbegriff, Konto, Hashtag, Region oder Datumsfilter anzugeben.
  • Normalisierte Reel-DatensätzeSie erhalten Reel-Identität, öffentliche URLs, Bildunterschriften, Autorenkontext, Medien-Metadaten, Zeitstempel und die sichtbaren Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben in einer einheitlichen Struktur.
  • Unterdrückung von DuplikatenWiederholte Feed-Zeilen werden nach Reel-ID, Primärschlüssel oder Shortcode zusammengeführt, bevor die normalisierten Datensätze gespeichert werden.

Parameter der Instagram Trending Reels API

Bereit zum Senden

Dieser Endpunkt benötigt keine Anfrageparameter. Senden Sie das leere JSON-Objekt unverändert.

{}

So verwenden Sie die Instagram Trending Reels API

Senden Sie ein leeres JSON-Objekt als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die gespeicherten Datensätze der Momentaufnahme per Cursor-Paginierung der Ergebnisse aus.

  1. Bereiten Sie ein leeres JSON-Objekt vor.
  2. Senden Sie den Anfragetext per POST an /v1/instagram/trending-reels.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Instagram Trending Reels API

  • Aktuelles Discovery-Inventar: Speichern Sie Reel-IDs, öffentliche URLs, Bildunterschriften, Identität der Creator und Erfassungszeiten als prüfbare Aufzeichnung der aktuellen Feed-Momentaufnahme.
  • Prüfung von Kurzvideo-Kreativen: Untersuchen Sie Text der Bildunterschriften, Autorenkontext, Vorschaubilder, Videoverweise, Abmessungen und Dauer, um die Kreativbeispiele einer Momentaufnahme zu prüfen.
  • Interaktionsvergleich innerhalb einer Momentaufnahme: Vergleichen Sie sichtbare Likes, Kommentare, Aufrufe, Wiedergaben und Erstellungszeiten der Reels, die dieselbe Erfassungsaufgabe zurückgibt.

Profi-Tipps zur Instagram Trending Reels API

  • Senden Sie ausschließlich ein leeres Objekt; die Felder query, region, username, hashtag, date und results_limit werden abgelehnt.
  • Behandeln Sie jede Antwort als die von der Quelle definierte Feed-Momentaufnahme zum Zeitpunkt der Erfassung, nicht als offizielle Ranking-Formel und nicht als Zusage einer globalen oder regionalen Abdeckung.
  • Fordern Sie keine weitere Seite beim vorgelagerten Dienst an; results.next_cursor setzt nur die bereits gespeicherten Datensätze der abgeschlossenen Aufgabe fort.
  • Wenn Sie wiederholte Momentaufnahmen aufbewahren, deduplizieren Sie aufgabenübergreifend mit stabilen Reel-IDs oder URLs, denn die Unterdrückung von Duplikaten gilt nur innerhalb der einzelnen Feed-Antwort.
  • Speichern Sie collected_at zu jedem Ergebnis, wenn Sie eine eigene Zeitreihe aufbauen, denn dieser Endpunkt bietet weder historische Momentaufnahmen noch Zeitplanung.
  • Behandeln Sie Bildunterschriften, Autorenfelder, Zähler, Medien, URLs und Erstellungszeiten als nullable öffentliche Felder.

Ergänzend zur Instagram Trending Reels API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Instagram-Daten benötigen.

  • Instagram Posts API — Öffentliche Beiträge, Medien, Hashtags, Erwähnungen, Zeitstempel und Interaktionen per Benutzername erfassen.
  • Instagram Reels API — Öffentliche Reels, Medien, Audio, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen.
  • Instagram Comments API — Öffentliche Kommentare, Autoren, Zeitstempel, Likes und Antworten aus Beitrags-URLs erfassen.
  • Instagram Tagged Posts API — Öffentliche Beiträge erfassen, in denen ausgewählte Profile markiert sind – mit Autoren, Medien, Erwähnungen, Kontext der markierten Nutzer und Interaktionen.
  • Instagram Transcript API — Transkripttext, Sprache, Format, Quell-URLs und Shortcodes aus öffentlichen Beitrags- oder Reel-URLs extrahieren.
  • Instagram Post Info API — Bekannte öffentliche Beitrags-, Reel- oder ältere IGTV-URLs nachschlagen – mit Bildunterschriften, Autorenidentität, Medien, Zeitstempeln, sichtbaren Interaktionen und Eingabekontext.

Weitere Plattformen entdecken

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

Instagram Trending Reels API — FAQ

Instagram Trending Reels API ist eine Schnittstelle, die die aktuelle öffentliche Reel-Auswahl des Trend-Feeds ohne Selektoren erfasst. Sie liefert normalisierte Reel-Identität, Bildunterschriften, Autoren, Medien, Zeitstempel und sichtbare Interaktion.

Die inhaltliche Eingabe ist ein leeres JSON-Objekt; die Felder query, region, username, hashtag, date und results_limit werden nicht akzeptiert.

„Im Trend“ bedeutet die aktuelle Reel-Auswahl, die der konfigurierte Discovery-Feed zum Zeitpunkt der Erfassung zurückgibt. Der Endpunkt veröffentlicht keine Ranking-Formel und verspricht weder globale Abdeckung noch regionale Personalisierung oder eine stabile Reihenfolge.

Ein normalisierter Datensatz kann Reel-ID und URL, Text der Bildunterschrift, Autor-ID, Benutzername, Name und Avatar, die sichtbaren Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben, Medien-Metadaten, created_at, collected_at und den Produkttyp enthalten.

Weder results_limit noch ein Parameter zur Fortsetzung beim vorgelagerten Dienst wird akzeptiert, und der Collector stellt eine einzige Feed-Anfrage. Der Endpunkt für Aufgabenergebnisse kann bereits gespeicherte Datensätze aber weiterhin mit limit und results.next_cursor paginieren.

Nein. Jede Aufgabe erfasst den Feed zum Zeitpunkt der Erfassung; bewahren Sie Ergebnisse mit collected_at auf, wenn Ihre Anwendung Vergleiche zwischen unabhängig erfassten Momentaufnahmen braucht.

Abgerechnet werden 0,5 Credits pro zurückgegebenem normalisiertem Datensatz, ohne Grundgebühr. Beim Senden gilt eine Schätzung von 20 Datensätzen, während die endgültige Nutzung den tatsächlich zurückgegebenen Datensätzen folgt.