instagram/
reels-search

Öffentliche Instagram Reels per Textabfrage durchsuchen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, sichtbarer Interaktion und Abfragekontext in normalisierten Datensätzen.

Instagram Reels Search API

Recherche per Textabfrage
Reel-Datensätze
Veröffentlichungszeitraum
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

Instagram Reels Search

Instagram Reels sind öffentliche Kurzvideos mit Bildunterschriften, Creator-Identität, Medien, Veröffentlichungszeiten, Produkttypen der Quelle und sichtbarer Interaktion. Diese Inhalts- und Leistungssignale unterstützen Themenmonitoring, abfragespezifische Recherche, Creator-Mapping und vergleichende Prüfung.

Funktionen der Instagram Reels Search API

  • Reel-Recherche per TextabfrageFinden Sie öffentliche Reels zu einem aussagekräftigen Suchbegriff, ohne von einem bekannten Profil, Hashtag, einer Audio-ID oder einer Inhalts-URL auszugehen.
  • Steuerung des VeröffentlichungszeitraumsBeschränken Sie die Recherche auf die letzte Stunde, den letzten Tag, die letzte Woche, den letzten Monat oder das letzte Jahr, wenn die Aufgabe einen festen Aktualitätsbereich braucht.
  • Inhalts- und Creator-DatensätzeSie erhalten Reel-Identität, kanonische URLs, Bildunterschriften, Autorendetails, Medienverweise, Veröffentlichungszeiten und sichtbare Interaktion in einer einheitlichen Form.
  • Begrenzte, deduplizierte ErfassungLegen Sie pro Aufgabe 20 bis 2.000 Datensätze fest, während stabile Reel-Kennungen Duplikate entfernen und jedes gespeicherte Element die zugehörige Abfrage behält.

Parameter der Instagram Reels Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Text, mit dem die aktuelle öffentliche Reel-Oberfläche von Instagram durchsucht wird.
results_limitOptionalMaximal angeforderte Datensätze für die Abfrage; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000.
published_withinOptionalOptionaler Veröffentlichungszeitraum: hour, day, week, month oder year.

So verwenden Sie die Instagram Reels Search API

Senden Sie eine Reel-Suche als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Datensätze per Cursor-Paginierung aus.

  1. Bereiten Sie eine nicht leere Textabfrage vor und wählen Sie optional einen Veröffentlichungszeitraum; setzen Sie results_limit auf einen Wert von 20 bis 2.000.
  2. Senden Sie query mit den optionalen Feldern results_limit und published_within per POST an /v1/instagram/reels-search.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie data.results.items aus /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/reels-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Anwendungsfälle der Instagram Reels Search API

  • Reel-Datensätze zu einer Abfrage: Führen Sie Reel-IDs, URLs, Bildunterschriften, Medien, Autoren und extra.search_query zu einer nachvollziehbaren Sammlung für ein Thema zusammen.
  • Monitoring aktueller Themen: Nutzen Sie einen Veröffentlichungszeitraum mit created_at und sichtbarer Interaktion, um kürzlich aufgetauchte Reels zu einer wiederkehrenden Abfrage zu prüfen.
  • Creator-Recherche innerhalb eines Themas: Verwenden Sie normalisierte Autoren-IDs, Benutzernamen, Namen und Avatare, um die Creators abzubilden, die im passenden Reel-Satz vertreten sind.
  • Vergleich von Inhaltsformaten: Vergleichen Sie Bildunterschriften, Metadaten der Medien, Produkttypen der Quelle und sichtbare Kennzahlen über die Reels, die zur selben Abfrage zurückgegeben wurden.

Profi-Tipps zur Instagram Reels Search API

  • Verwenden Sie einen gezielten Suchbegriff ohne reine Leerzeichen, damit die Aufgabe nach dem Kürzen der Eingabe mit einem aussagekräftigen Suchausdruck startet.
  • Halten Sie query, published_within und results_limit konstant, wenn Sie wiederkehrende Läufe vergleichen, denn die aktuelle öffentliche Suchoberfläche kann sich ändern.
  • Behalten Sie extra.search_query und stabile Reel-IDs bei, wenn Sie Ergebnisseiten oder mehrere Aufgaben zusammenführen, damit Herkunft der Abfrage und Deduplizierung nachvollziehbar bleiben.
  • Behandeln Sie Bildunterschriften, Creator-Felder, Medien, Zeitstempel, Produkttypen und sichtbare Zähler im nachgelagerten Code als nullable.

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

  • Instagram Search API — Öffentliche Profile per Keyword oder Handle suchen – mit Identität und sichtbaren Kontosignalen.
  • Instagram Comments API — Öffentliche Kommentare, Autoren, Zeitstempel, Likes und Antworten aus Beitrags-URLs erfassen.
  • Instagram Hashtag Posts API — Öffentliche Beiträge per Hashtag finden – mit Kontext zum Quell-Hashtag, Medien, Creators, Zeitstempeln und sichtbaren 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.
  • Instagram Location Info API — Einen Ort über ID oder URL der Ortsseite nachschlagen – mit Name, Kategorie, Telefon, Koordinaten und Anzahl markierter Beiträge.

Weitere Plattformen entdecken

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

Instagram Reels Search API — FAQ

Instagram Reels Search API ist eine Schnittstelle zum Finden öffentlicher Instagram Reels anhand einer übermittelten Textabfrage. Sie liefert normalisierte Reel-Identität, Bildunterschriften, Creators, Medien, Zeitstempel, sichtbare Interaktion und Abfragekontext.

query ist erforderlich und muss Text mit mehr als Leerzeichen enthalten. results_limit akzeptiert 20 bis 2.000 und hat den Standardwert 100; published_within akzeptiert hour, day, week, month oder year.

Ein Ergebnis kann Reel-ID und URL, Bildunterschrift, Autorenidentität, die Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben, Medienverweise, created_at, collected_at, extra.search_query und den Produkttyp der Quelle enthalten.

results_limit ist ein Maximum und keine Garantie. Die verfügbare öffentliche Suchmenge kann sich zwischen Läufen ändern, und doppelte Reels mit derselben stabilen Kennung werden innerhalb einer Aufgabe entfernt.

Jedes gespeicherte normalisierte Ergebnis kostet 0,5 Credits, ohne Grundgebühr für die Aufgabe. Die erste Schätzung verwendet results_limit oder den Standardwert 100, die endgültige Nutzung richtet sich nach den tatsächlich gespeicherten Datensätzen; eine Aufgabe ohne gespeicherte Datensätze verursacht keine Ergebniskosten.