instagram/
search

Öffentliche Instagram-Profile per Keyword oder Handle suchen – mit normalisierten Angaben zu Identität, Biografien, Profilbildern, Verifizierung, Datenschutz und den sichtbaren Kontozahlen.

Instagram Search API

Profilsuche
Entdecken
Öffentliche Daten
0,54 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 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

ParameterErforderlichBeschreibung
queryErforderlichSuchkeyword, Handle oder Profilbegriff.
results_limitOptionalMaximale 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.

  1. Bereiten Sie ein nicht leeres Profil-Keyword, einen Handle oder eine Suchphrase vor.
  2. Senden Sie query und optional results_limit per POST an /v1/instagram/search.
  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, 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.

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.

Weitere Plattformen entdecken

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

Instagram Search API — FAQ

Instagram Search API findet öffentlich sichtbare Instagram-Profile zu einem Keyword oder Handle. Sie liefert normalisierte Angaben zu Identität, Biografien, Profilbildern, Signalen zu Verifizierung und Datenschutz sowie die sichtbaren Kontozahlen.

Der Parameter query durchsucht öffentliche Profilergebnisse nach Keyword, Handle, Name oder Kontobegriff. Verwenden Sie einen konkreten Handle, wenn Sie eine engere Ergebnismenge wünschen.

Der aktuelle Endpunkt durchsucht nur öffentliche Nutzer- und Profilergebnisse. Beiträge, Reels, Stories und Hashtag-Datensätze liefert er nicht.

Üblich sind Profil-ID, Benutzername, Anzeigename, kanonische URL, Avatar, Biografie, Verifizierung, Datenschutz, die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen sowie der Erfassungszeitpunkt.

results_limit legt die maximale Zahl der angeforderten Profildatensätze fest. Es ist eine Obergrenze und keine Garantie, denn Suchranking und die Verfügbarkeit öffentlicher Daten können zu weniger Ergebnissen führen.

Suchranking, umbenannte Handles, private oder entfernte Profile und die vorübergehende Verfügbarkeit öffentlicher Ergebnisse können die zurückgegebene Menge verkleinern oder verändern. Versuchen Sie eine genauere Suchanfrage und behandeln Sie optionale Profilfelder als nullable.

Verwenden Sie den zurückgegebenen Benutzernamen mit Instagram Posts, Reels oder Followers Count API, wenn Sie öffentliche Inhaltsdatensätze oder aktualisierte Zahlen brauchen.