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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Text, mit dem die aktuelle öffentliche Reel-Oberfläche von Instagram durchsucht wird. |
results_limit | Optional | Maximal angeforderte Datensätze für die Abfrage; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000. |
published_within | Optional | Optionaler 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.
- 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.
- Senden Sie query mit den optionalen Feldern results_limit und published_within per POST an /v1/instagram/reels-search.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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.
Verwandte APIs
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API