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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche, 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.
- Bereiten Sie ein nicht leeres Array usernames mit den öffentlichen Konten vor, die Sie bereits kennen.
- Senden Sie das Array usernames per POST an /v1/instagram/profiles und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search 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 Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API