Instagram Search
Die Ergebnisse von Instagram Search sind öffentliche Profile, die zu einem Namen, Keyword oder Thema passen, samt Benutzernamen, Biografien, Profilbildern sowie Signalen zu Verifizierung, Datenschutz und sichtbaren Kontozahlen. Diese Datensätze unterstützen die Creator-Suche, die Markenrecherche, die Vorauswahl von Zielgruppen und die Anreicherung von Profilen.
Funktionen der Instagram Search API
- Profilsuche per KeywordDurchsuchen Sie öffentliche Instagram-Profile nach Keyword, Handle, Name oder Kontobegriff.
- Profilidentität und ZahlenLiefert zu jedem Profiltreffer Benutzernamen, Anzeigenamen, Biografie, Profil-URL, Avatar, Verifizierung, Datenschutz und die sichtbaren Zählerfelder.
- Einheitliches ProfilschemaLiefert dieselbe normalisierte Profilstruktur bei breiten Keywords, Namen und Suchen nach exakten Handles.
- Obergrenze für ErgebnisseLegen Sie mit results_limit die maximale Zahl der Profildatensätze fest, die für eine Suche angefordert werden.
- Grenze öffentlicher DatenPrivate, eingeschränkte, entfernte oder nur nach Anmeldung sichtbare Profildaten bleiben außerhalb der Antwort.
Parameter der Instagram Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Suchkeyword, Handle oder Profilbegriff. |
results_limit | Optional | Maximale Zahl der Datensätze, die die Erfassungsaufgabe anfordern soll. Muss eine positive ganze Zahl sein. |
So verwenden Sie die Instagram Search API
Senden Sie eine Profilsuche als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Profilergebnisse per Cursor-Paginierung aus.
- Bereiten Sie ein nicht leeres Profil-Keyword, einen Handle oder eine Suchphrase vor.
- Senden Sie query und optional results_limit per POST an /v1/instagram/search.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, wenn es weitere Profile gibt.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Anwendungsfälle der Instagram Search API
- Creator-Suche: Finden Sie öffentliche Profile zu einem Keyword, Handle, einer Kategorie oder Kampagnenphrase, bevor Sie sie genauer anreichern.
- Kontoanreicherung: Ermitteln Sie für ausgewählte Suchergebnisse öffentliche Profilidentität, Biografie, Verifizierung, Datenschutz und sichtbare Zählerfelder.
- Markensuche: Finden Sie öffentliche Profile von Marken und Organisationen zu einem Namen, einer Produktkategorie oder einem Marktbegriff.
- Recherche-Verzeichnisse: Erstellen Sie prüfbare Listen öffentlicher Instagram-Profile für Recherche, die Qualifizierung von Kontaktaufnahmen oder interne Analysen.
- Workflows zur Profilauswahl: Wählen Sie relevante Profile aus und rufen Sie dann die Endpunkte für Beiträge, Reels oder Follower-Zahlen auf, um tiefere öffentliche Datensätze zu erhalten.
Profi-Tipps zur Instagram Search API
- Behandeln Sie 429-Antworten in Such-Workflows als normales Belastungssignal; nutzen Sie Backoff und kleinere Ergebnisfenster, statt aggressiv zu wiederholen.
- Speichern Sie Aufgaben-IDs, stabile Profil-IDs, Benutzernamen und kanonische URLs, damit sich Suchen wiederholen und nachvollziehen lassen.
- Nutzen Sie die Suchergebnisse zum Entdecken von Profilen und rufen Sie anschließend die Endpunkte für Beiträge, Reels oder Follower-Zahlen auf, wenn Ihr Workflow tiefere Datensätze braucht.
- Gehen Sie in Ihrer Integration nicht von privaten, nur nach Anmeldung sichtbaren oder kontoeigenen Daten aus, solange die veröffentlichte API-Dokumentation sie nicht ausdrücklich unterstützt.
- Bereinigen Sie von Nutzern eingegebene Suchbegriffe, bevor Sie sie durch eine Produktions-Pipeline schicken.
Verwandte APIs
Ergänzend zur Instagram Search 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 Profiles API — Öffentliche Profilidentität, Bios, Links, Kontomerkmale, Kategorien und sichtbare Zahlen per Benutzername abrufen.
- Instagram Hashtag Posts API — Öffentliche Beiträge per Hashtag finden – mit Kontext zum Quell-Hashtag, Medien, Creators, Zeitstempeln und sichtbaren Interaktionen.
- Instagram Reels Search API — Öffentliche Reels per Textsuche finden – mit Bildunterschriften, Creators, Medien, Zeitstempeln, sichtbaren Interaktionen und Suchkontext.
- 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 Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info 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