x/
following-list

Öffentliche X-Profile erfassen, denen ein oder mehrere Benutzernamen folgen – mit Identität, Biografien, Kontosignalen, sichtbaren Zählern und Kontext zum Quellkonto.

X Following List API

Folgebeziehungen
Profilkontext
Limits pro Konto
0,5 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

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

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliches Array nicht leerer öffentlicher X-Benutzernamen. Die Werte dürfen ein führendes @ enthalten oder weglassen.
results_limitOptionalMaximale 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.

  1. 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.
  2. Senden Sie usernames und results_limit per POST an /v1/x/following-list und behalten Sie die zurückgegebene task_id.
  3. 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.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

X Following List API — FAQ

X Following List API ist eine Schnittstelle zum Erfassen öffentlicher Profile, denen ein oder mehrere X-Benutzernamen folgen. Sie liefert normalisierte Identität, Biografien, Links, Bildmaterial, Kontosignale, sichtbare Zähler, Zeitstempel und Quellkontext.

Übergeben Sie ein nicht leeres Array usernames. Jedes öffentliche Handle darf ein führendes @ enthalten oder weglassen, und gleichwertige Quell-Benutzernamen werden vor der Erfassung beim Anbieter ohne Beachtung der Groß- und Kleinschreibung normalisiert.

results_limit ist standardmäßig 200, akzeptiert Vielfache von 200 bis 2.000 und gilt getrennt für jeden Quell-Benutzernamen. Eine sichtbare Liste kann vor dem angeforderten Limit enden.

Ein Datensatz kann Profil-ID, Benutzername, Anzeigename, kanonische URL, Biografie, Website, Standort, Avatar, Banner, Signale zu Verifizierung und Schutz, öffentliche Zähler, Zeitpunkt der Kontoerstellung, Erfassungszeitpunkt und extra.input_username enthalten.

Nicht unbedingt. Stabile Profilidentitäten werden beim Speichern der Ergebnisse dedupliziert, sodass ein Profil, dem mehrere übergebene Konten folgen, einmal erscheinen kann, wobei der Quellkontext an diesem gespeicherten Datensatz erhalten bleibt.

Geschützte oder eingeschränkte Konten, Grenzen der öffentlichen Sichtbarkeit, nicht verfügbare Listenseiten oder das Ende der sichtbaren Following-Liste können die gespeicherten Datensätze verringern. Prüfen Sie die öffentliche Zugänglichkeit des Quellkontos, bevor Sie es erneut versuchen.

Nein. Betrachten Sie die Reihenfolge nur als Reihenfolge der Erfassung; sie belegt weder, seit wann eine Beziehung besteht, noch wie oft Konten interagieren, noch ob die Quelle ein gefolgtes Profil empfiehlt.

Jeder gespeicherte normalisierte Profildatensatz kostet 0,5 Credits. Die Abrechnung richtet sich nach der tatsächlichen Zahl gespeicherter Datensätze, sodass für ein leeres Ergebnis keine Gebühr pro Ergebniseinheit anfällt.