instagram/
following-list

Öffentliche Profile erfassen, denen Instagram-Konten folgen – mit normalisierten Benutzernamen, Profil-Links, Sichtbarkeitssignalen, Beziehungskontext und sichtbaren Zahlen.

Instagram Following List API

Folgebeziehungen
Öffentliche Profile
Benutzernamen im Stapel
0,3 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 Following List

Datensätze der Instagram Following List stehen für öffentliche Profile, denen ein Quell-Benutzername folgt, mit normalisierter Identität, Profil-URLs, Sichtbarkeitssignalen und Beziehungskontext. Wiederholte Erfassungen ermöglichen Beziehungs-Momentaufnahmen, während collected_at, source_username und position festhalten, wann und wo jeder Datensatz beobachtet wurde.

Funktionen der Instagram Following List API

  • Quell-Benutzernamen im StapelÜbergeben Sie einen oder mehrere öffentliche Instagram-Benutzernamen in einer einzigen Aufgabe, ohne das führende @-Zeichen.
  • Herkunft der BeziehungBehält source_username, relationship und position in extra bei, sodass sich jedes Profil auf sein Quellkonto zurückführen lässt.
  • Normalisierte ProfilidentitätLiefert Profil-ID, Benutzernamen, Anzeigenamen, kanonische Profil-URL, Avatar und, sofern verfügbar, öffentliche Signale zu Verifizierung oder Datenschutz.
  • Sichtbare KontokennzahlenNutzen Sie die zurückgegebenen Zahlen zu Followern, Gefolgten und Beiträgen, wenn diese öffentlichen Werte im erfassten Datensatz vorhanden sind.
  • Seitenweiser Abruf der ErgebnisseÜbergeben Sie die Erfassung außerhalb des Anfrage-Threads, fragen Sie den Status der Aufgabe ab und blättern Sie mit next_cursor durch die normalisierten Ergebnisse.

Parameter der Instagram Following List API

ParameterErforderlichBeschreibung
usernamesErforderlichEin oder mehrere öffentliche Instagram-Benutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Anzahl der angeforderten Profile der Gefolgten pro Quell-Benutzername; eine ganze Zahl von 1 bis 2.000, Standardwert 100.

So verwenden Sie die Instagram Following List API

Senden Sie öffentliche Benutzernamen als asynchrone Aufgabe, fragen Sie die zurückgegebene Aufgaben-ID ab und lesen Sie die normalisierten Profile der Gefolgten per Cursor-Paginierung aus.

  1. Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne das führende @-Zeichen vor.
  2. Senden Sie usernames und optional ein results_limit von 1 bis 2.000 per POST an /v1/instagram/following-list.
  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 fahren Sie mit results.next_cursor fort, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Anwendungsfälle der Instagram Following List API

  • Kartierung von Creator-Netzwerken: Erstellen Sie prüfbare Karten darüber, welchen öffentlichen Creators, Publishern und Organisationen ausgewählte Konten folgen.
  • Recherche zu Marken-Konten: Vergleichen Sie sichtbare Folgebeziehungen von Marken-, Kampagnen-, Regional- oder Wettbewerber-Konten.
  • Partnerschaften entdecken: Erkennen Sie öffentliche Profile, die in den Gefolgten-Listen von Konten auftauchen, die für ein Partnerprogramm relevant sind.
  • Anreicherung von Profilverzeichnissen: Ergänzen Sie interne Verzeichnisse um kanonische URLs, Anzeigenamen, Avatare, Kontosignale und die Herkunft der Beziehung.
  • Verfolgung von Beziehungsänderungen: Speichern Sie Momentaufnahmen mit Zeitstempel und vergleichen Sie stabile Profil-IDs über mehrere Läufe hinweg, um Zu- und Abgänge zu prüfen.

Profi-Tipps zur Instagram Following List API

  • Entfernen Sie vor dem Senden das führende @ von jedem Benutzernamen; die Eingabe des Providers wird auf reine Benutzernamen normalisiert.
  • Beginnen Sie mit einem gezielten results_limit und erhöhen Sie es nur, wenn der Workflow eine größere sichtbare Beziehungsmenge braucht.
  • Speichern Sie die Profil-ID zusammen mit extra.source_username, denn dasselbe gefolgte Profil kann bei mehreren Quellkonten vorkommen.
  • Behandeln Sie fehlende Avatare, Kontokennzahlen, Verifizierungssignale oder Positionen als normale Schwankung bei öffentlichen Ergebnissen.
  • Planen Sie leere oder unvollständige Ergebnisse ein, denn private, eingeschränkte, entfernte oder nur nach Anmeldung sichtbare Beziehungen liegen außerhalb der unterstützten Grenze.

Ergänzend zur Instagram Following List 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 Profiles API — Öffentliche Profilidentität, Bios, Links, Kontomerkmale, Kategorien und sichtbare Zahlen per Benutzername abrufen.
  • Instagram Followers List API — Öffentliche Follower-Profildatensätze mit Quellkonto und Beziehungskontext erfassen.
  • Instagram Similar Accounts API — Die Konten auflisten, die Instagram zu einem Benutzernamen als ähnlich vorschlägt – mit Benutzernamen, Namen, Avataren und Verifizierungsstatus.
  • Instagram Post Likers API — Konten aus der sichtbaren Liker-Liste einer Beitrags-URL auflisten – mit Benutzernamen, Namen, Avataren und Verifizierungsstatus.

Weitere Plattformen entdecken

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

Instagram Following List API — FAQ

Instagram Following List API ist eine Schnittstelle zum Abrufen öffentlicher Profildatensätze, die in den Listen der gefolgten Profile übergebener Instagram-Benutzernamen sichtbar sind. Sie liefert normalisierte Identität, Profil-URLs, Sichtbarkeitssignale, Kontext des Quellkontos, Listenposition und verfügbare Kontokennzahlen.

Following liefert einzelne öffentliche Profildatensätze aus einer sichtbaren Folgebeziehung, während Followers Count Gesamtzahlen zu Zielgruppe und Beiträgen auf Profilebene liefert, ohne Beziehungsliste.

Datensätze können ID, Benutzernamen, Anzeigenamen, Profil-URL, Avatar-URL, Verifizierungs- und Datenschutzsignale, sichtbare Kennzahlen, collected_at, source_username, relationship und position enthalten.

Ja. Übergeben Sie einen oder mehrere öffentliche Benutzernamen im Array usernames; source_username zeigt, welches Eingabekonto den jeweiligen Beziehungsdatensatz geliefert hat, sofern dieses Feld verfügbar ist.

Es lassen sich nur Beziehungen öffentlicher Profile zurückgeben, die sichtbar sind. Private, eingeschränkte, entfernte oder nur nach Anmeldung sichtbare Beziehungsdaten können zu unvollständigen oder leeren Ergebnissen führen.

Lesen Sie die abgeschlossene Aufgabe mit einem limit von bis zu 500 Datensätzen pro Seite und übergeben Sie in der nächsten Anfrage results.next_cursor, solange results.has_more den Wert true hat.

Erfolgreiche normalisierte Ergebnisse werden mit 0,3 Credits pro Datensatz abgerechnet, ohne Grundgebühr; ein leeres Ergebnis folgt der Regel „nur Grundgebühr“ und kostet daher null Credits.