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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Ein oder mehrere öffentliche Instagram-Benutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale 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.
- Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne das führende @-Zeichen vor.
- Senden Sie usernames und optional ein results_limit von 1 bis 2.000 per POST an /v1/instagram/following-list.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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_cursorAnwendungsfä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.
Verwandte APIs
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.
- Instagram Reels API
- 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 Comment Replies API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API