instagram/
profiles

Öffentliche Instagram-Profile zu einem oder mehreren Benutzernamen abrufen – mit normalisierten Angaben zu Identität, Biografie, Links, Kontomerkmalen und den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen.

Instagram Profiles API

Abfrage bekannter Benutzernamen
Profil-Metadaten
Konto-Momentaufnahmen
0,6 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 Profiles

Instagram-Profile sind öffentliche Kontoseiten mit Benutzernamen, Anzeigenamen, Biografien, Profilbildern, externen Links, Kontokategorien, Signalen zu Verifizierung und Datenschutz sowie den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen. Diese Angaben zu Identität, Einordnung und Reichweite eignen sich für die Anreicherung von Profilen, den Vergleich von Konten, die Pflege von Verzeichnissen und die Beobachtung im Zeitverlauf.

Funktionen der Instagram Profiles API

  • Abfrage bekannter BenutzernamenLöst einen oder mehrere übergebene öffentliche Benutzernamen auf und liefert für jedes gefundene Konto höchstens einen normalisierten Profildatensatz.
  • Identität und Profil-LinksLiefert Konto-ID, Benutzername, Anzeigename, kanonische Profil-URL, Profilbild, Biografie, externe URL und die öffentlichen Links der Biografie.
  • Kontoeinordnung und StatusBehält den sichtbaren Verifizierungs- und Datenschutzstatus bei, zusammen mit den öffentlichen Signalen zu Kategorie, Business-Konto und professionellem Konto.
  • Sichtbare ProfilzahlenFasst die Zahlen zu Followern, Gefolgten und Beiträgen unter metrics zusammen und versieht den normalisierten Datensatz mit einem Zeitstempel in collected_at.

Parameter der Instagram Profiles API

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche, nicht leere Liste öffentlicher Instagram-Benutzernamen. Ein führendes @ wird akzeptiert und vor der Abfrage entfernt.

So verwenden Sie die Instagram Profiles API

Senden Sie bekannte Benutzernamen als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die aufgelösten öffentlichen Profildatensätze per Cursor-Paginierung aus.

  1. Bereiten Sie ein nicht leeres Array usernames mit den öffentlichen Konten vor, die Sie bereits kennen.
  2. Senden Sie das Array usernames per POST an /v1/instagram/profiles und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. Lesen Sie nach einem Erfolg data.results.items und übergeben Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Anwendungsfälle der Instagram Profiles API

  • Anreicherung bekannter Konten: Ergänzen Sie Datensätze, die bereits Instagram-Benutzernamen enthalten, um stabile IDs, Anzeigenamen, Biografien, Profilbilder, kanonische URLs und öffentliche Links.
  • Vergleich ausgewählter Konten: Vergleichen Sie sichtbare Verifizierung, Kategorie, Kontotyp-Signale sowie die Zahlen zu Followern, Gefolgten und Beiträgen über eine festgelegte Gruppe von Benutzernamen hinweg.
  • Beobachtung von Profil-Momentaufnahmen: Speichern Sie collected_at zusammen mit den sichtbaren Kontozahlen aus wiederholten Abrufen, um Profildatensätze zu verschiedenen Zeitpunkten zu vergleichen.

Profi-Tipps zur Instagram Profiles API

  • Senden Sie Benutzernamen statt Profil-URLs oder Suchbegriffen, denn dieser Endpunkt akzeptiert nur das Array usernames.
  • Entfernen Sie führende @-Zeichen und entfernen Sie Duplikate, bevor Sie die Namen senden, damit name und @name nicht zwei getrennte Abfragen auslösen.
  • Gleichen Sie die zurückgegebenen Benutzernamen mit Ihrer Eingabeliste ab, denn ein nicht verfügbares, umbenanntes oder nicht zugängliches Konto kann ohne Profildatensatz bleiben.
  • Behandeln Sie fehlende Zahlen und Kontomerkmale als unbekannte Werte und wandeln Sie sie nicht in 0 oder false um.
  • Speichern Sie collected_at neben metrics, wenn Sie wiederholte Profil-Momentaufnahmen vergleichen.

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

  • Instagram Followers Count API — Öffentliche Profilidentität sowie sichtbare Zahlen zu Followern, Gefolgten und Beiträgen abrufen.
  • 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 Followers List API — Öffentliche Follower-Profildatensätze mit Quellkonto und Beziehungskontext erfassen.
  • Instagram Following List API — Öffentliche Profile erfassen, denen Instagram-Konten folgen – mit Identität, Beziehungskontext und sichtbaren Kontozahlen.
  • Instagram Account Age Checker API — Nachschlagen, wann ein Konto Instagram beigetreten ist, in welchem Land es ansässig ist, wann es verifiziert wurde und wie oft es seinen Benutzernamen geändert hat.

Weitere Plattformen entdecken

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

Instagram Profiles API — FAQ

Instagram Profiles API liefert für jeden auflösbaren Benutzernamen im erforderlichen Array usernames ein normalisiertes öffentliches Profil. Enthalten sind Identität, Biografie und Links, Verifizierungs- und Datenschutzmerkmale, Kontokategorien sowie die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen.

Übergeben Sie in usernames eine oder mehrere nicht leere Zeichenfolgen; die Werte dürfen ein führendes @ enthalten. Profil-URLs, Stichwortabfragen, results_limit und Beitragsfilter werden nicht akzeptiert.

Ein Datensatz kann Konto-ID, Benutzername, Anzeigename, Profil-URL und Profilbild, Biografie, externe Links und Links der Biografie, Verifizierungs- und Datenschutzmerkmale, Kategorie, Business- und Profi-Signale, sichtbare Zahlen sowie collected_at enthalten.

Ein fehlendes, umbenanntes, nicht verfügbares oder nicht zugängliches Konto kann ohne Datensatz bleiben, und die Verfügbarkeit der öffentlichen Quelle kann einzelne Felder leer lassen. Andere gültige Benutzernamen derselben Aufgabe können trotzdem Profildatensätze liefern.

Nein. Er ruft Profildatensätze zu Benutzernamen ab, die Sie bereits kennen; für die Suche nutzen Sie Instagram Search, für die Mitglieder einer Beziehung die Endpunkte Followers oder Following.

Jedes zurückgegebene normalisierte Profilergebnis kostet 0,6 Credits; ein nicht aufgelöster Benutzername ohne Ergebnis fällt unter die konfigurierte Regel für leere Ergebnisse.