Instagram Followers List
Instagram-Follower sind öffentliche Beziehungsdatensätze zu Profilen, die in der Follower-Liste eines übergebenen Benutzernamens sichtbar sind, mit Identität, Profilbild, Verifizierungs- und Datenschutzmerkmalen, Quellkontext, Position und Erfassungszeit. Diese Felder eignen sich für Zielgruppen-Stichproben, Überschneidungsprüfungen zwischen Konten, die Profilauswahl und die Recherche in Beziehungslisten.
Funktionen der Instagram Followers List API
- Follower-Erfassung über mehrere KontenÜbergeben Sie einen oder mehrere Instagram-Benutzernamen und fordern Sie in einer asynchronen Aufgabe die Follower-Profile für jedes Quellkonto an.
- Normalisierte Follower-IdentitätLiefert für jede Follower-Zeile die verfügbare Profil-ID, den Benutzernamen, den Anzeigenamen, die abgeleitete Profil-URL und das öffentliche Profilbild.
- Sichtbarkeits- und QuellsignaleBehält die Merkmale zu Verifizierung und privatem Konto sowie den Quell-Benutzernamen und die Follower-Beziehung bei, sofern diese Werte verfügbar sind.
- Kontext der beobachteten ListeBehält die Position in der Quelle und den Scrape-Zeitpunkt des Actors bei, sofern vorhanden, mit der SocQ-Erfassungszeit als Ersatz-Zeitstempel.
- Ergebnissteuerung pro BenutzernameWendet results_limit getrennt auf jeden übergebenen Benutzernamen an, mit dem Standardwert 100 und einem zulässigen Bereich von 1 bis 2.000.
Parameter der Instagram Followers List API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche, nicht leere Liste von Instagram-Benutzernamen. Jeder Eintrag muss eine nicht leere Zeichenfolge sein; führende @-Zeichen werden vor der Erfassung entfernt. |
results_limit | Optional | Maximal angeforderte Follower-Profile pro Benutzername; Standardwert 100, zulässig sind ganze Zahlen von 1 bis 2.000. |
So verwenden Sie die Instagram Followers List API
Senden Sie öffentliche Instagram-Benutzernamen, verfolgen Sie die asynchrone Aufgabe und blättern Sie nach erfolgreicher Erfassung durch die normalisierten Follower-Profildatensätze.
- Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen vor; ein führendes @ wird akzeptiert und vor der Erfassung entfernt.
- Senden Sie usernames und optional ein results_limit per POST an /v1/instagram/followers-list und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/followers-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 data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Instagram Followers List API
- Stichproben öffentlicher Zielgruppen: Erstellen Sie für ein ausgewähltes öffentliches Konto eine begrenzte Stichprobe aus Follower-Benutzernamen, Anzeigenamen, Profil-Links, Sichtbarkeitsmerkmalen und beobachteten Positionen.
- Überschneidungsprüfungen zwischen Konten: Gruppieren Sie die Zeilen nach extra.source_username und vergleichen Sie Follower-IDs oder Benutzernamen, um Profile zu erkennen, die bei mehr als einem übergebenen Konto vorkommen.
- Warteschlangen zur Profilanreicherung: Wählen Sie zurückgegebene Benutzernamen aus und übergeben Sie sie an Instagram Profiles, wenn ein Workflow Biografie oder sichtbare Profilzahlen braucht.
- Momentaufnahmen von Beziehungslisten: Speichern Sie Follower-Identität, Quell-Benutzernamen, beobachtete Position und collected_at, damit sich spätere Stichproben öffentlicher Listen unterscheiden lassen.
Profi-Tipps zur Instagram Followers List API
- Schätzen Sie bei mehreren Benutzernamen die angeforderte Tiefe als Anzahl der Benutzernamen mal results_limit, denn Obergrenze und Credit-Schätzung gelten pro Quellkonto.
- Beginnt ein Quell-Benutzername mit @, können Sie ihn unverändert senden; der Provider-Mapper entfernt führende @-Zeichen vor dem Actor-Lauf.
- Behalten Sie beim Vergleich von Konten extra.source_username bei, denn dasselbe Follower-Profil kann in mehr als einer Quellliste vorkommen und eine quellenübergreifende Deduplizierung wird nicht zugesichert.
- Behandeln Sie position, falls vorhanden, als beobachteten Listenwert und nicht als stabilen Rang oder Maß für die Stärke einer Beziehung.
- Liefert eine öffentliche Quelle weniger Zeilen als angefordert, behalten Sie das Teilergebnis und halten Sie collected_at fest; Datenschutz, Verfügbarkeit des Kontos, Paginierung der Quelle und Grenzen des Actors können die Ausgabe verringern.
Verwandte APIs
Ergänzend zur Instagram Followers 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 Following List API — Öffentliche Profile erfassen, denen Instagram-Konten folgen – mit Identität, Beziehungskontext und sichtbaren Kontozahlen.
- 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