X Following List
X-Following-Listen sind öffentlich sichtbare Kontobeziehungen, die zeigen, welchen Profilen ein Quellkonto folgt, samt Identität, Biografien, Links, Bildern, Kontostatus, Zählern und Angaben zur Erstellung. Diese Datensätze unterstützen die Analyse von Interessennetzwerken, das Auffinden von Konten, die Abbildung von Beziehungen und die Anreicherung von Profildatensätzen.
Funktionen der X Following List API
- Following-Erfassung für mehrere KontenNimmt einen oder mehrere öffentliche X-Benutzernamen entgegen und wendet auf jedes Quellkonto eine eigene, begrenzte Erfassung der Following-Liste an.
- Profilidentität und KontextLiefert IDs der gefolgten Konten, Benutzernamen, Anzeigenamen, kanonische URLs, Biografien, Websites, Standorte, Avatare, Banner und Zeitpunkte der Kontoerstellung.
- Kontosignale und öffentliche ZählerVerbindet sichtbare Signale zu Verifizierung, Schutz, Nachrichten, angeheftetem Post und Automatisierung mit den Zahlen zu Followern, Gefolgten, Posts, Medien und Likes.
- Normalisierte Datensätze mit QuellbezugHält jedes gespeicherte Profil in einer einheitlichen öffentlichen Struktur mit collected_at und extra.input_username fest, damit sich die Quelle nachvollziehen lässt.
Parameter der X Following List API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliches Array nicht leerer öffentlicher X-Benutzernamen. Die Werte dürfen ein führendes @ enthalten oder weglassen. |
results_limit | Optional | Maximale Anzahl gefolgter Profile, die pro Benutzername angefordert werden. Standard ist 200; zulässig sind Vielfache von 200 von 200 bis 2.000. |
So verwenden Sie die X Following List API
Senden Sie öffentliche Quell-Benutzernamen und lesen Sie die normalisierten Datensätze der gefolgten Profile aus der abgeschlossenen asynchronen Aufgabe.
- Bereiten Sie einen oder mehrere öffentliche X-Benutzernamen vor, mit oder ohne führendes @, und wählen Sie ein results_limit pro Benutzername, das ein Vielfaches von 200 von 200 bis 2.000 ist.
- Senden Sie usernames und results_limit per POST an /v1/x/following-list und behalten Sie die zurückgegebene task_id.
- Fragen Sie GET /v1/tasks/{task_id} ab, solange die Aufgabe queued, running oder retrying ist, und hören Sie auf, wenn sie succeeded oder failed erreicht.
- Lesen Sie nach einem Erfolg data.results.items und fragen Sie die Aufgabe weiter mit next_cursor ab, solange data.results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueAnwendungsfälle der X Following List API
- Analyse von Interessennetzwerken: Verknüpfen Sie jeden beibehaltenen Quell-Benutzernamen mit Identitäten, Biografien, Links und Standorten der gefolgten Profile, um die öffentlichen Interessen rund um bekannte Konten zu untersuchen.
- Konten aus Ausgangsprofilen entdecken: Nutzen Sie Namen, Biografien, Bilder, Verifizierungssignale und sichtbare Zähler, um Kandidatenkonten zu prüfen, die über die öffentliche Following-Liste eines Quellprofils gefunden wurden.
- Anreicherung von Beziehungslisten: Ergänzen Sie bestehende Beziehungsdatensätze auf Basis von Benutzernamen um stabile IDs, kanonische Profil-URLs, öffentliche Kontometadaten, Zähler und Erfassungszeitpunkte.
Profi-Tipps zur X Following List API
- Entfernen Sie führende @-Zeichen und deduplizieren Sie die Quell-Benutzernamen vor dem Senden ohne Beachtung der Groß- und Kleinschreibung, damit gleichwertige Handles die Arbeit für ein Quellkonto nicht wiederholen.
- Legen Sie results_limit pro Benutzername in Schritten von 200 fest; bei mehreren Quellen planen Sie mit bis zu usernames × results_limit Datensätzen, bevor Listenenden und die Deduplizierung innerhalb der Aufgabe greifen.
- Gehen Sie beim Aufbau eines Many-to-many-Graphen nicht von einer gespeicherten Zeile pro Paar aus Quellprofil und gefolgtem Profil aus, denn ein mehrfach gefolgtes Profil kann dedupliziert werden und behält dann nur einen Wert in extra.input_username.
- Behandeln Sie eine leere oder kurze Liste als Ergebnis der öffentlichen Sichtbarkeit und lassen Sie optionale Bilder, Statussignale und Zähler in nachgelagerten Datensätzen als nullable zu.
- Deuten Sie die Reihenfolge der Ergebnisse nicht als Alter der Beziehung, Stärke der Interaktion oder Empfehlung, denn die Antwort gibt die Reihenfolge der Erfassung wieder und keine dieser Signale.
Verwandte APIs
Ergänzend zur X Following List API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.
- Twitter Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername abrufen.
- Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
- X Followers List API — Identitäten öffentlicher Follower-Konten und sichtbare Profilkennzahlen zu einem oder mehreren X-Benutzernamen erfassen.
- X Post Retweeters API — Eine auf Aufgabenebene eindeutige Menge normalisierter öffentlicher Profile von Konten erfassen, die bekannte X- oder Twitter-Status-URLs repostet haben.
- X Community API — Aus Community-Links Beschreibung, Mitgliederzahlen, Regeln und Beitrittsregeln auslesen.
- X Account Location API — Das Land, in dem ein Konto ansässig ist, die Art der Verbindung mit X, das Beitrittsdatum und Änderungen des Benutzernamens nachschlagen.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API