x/
user-about

Per Benutzername das Land oder die Region abrufen, die X für ein Konto angibt – dazu, wie es mit X verbunden ist, sein Beitrittsdatum, die Zahl der Namensänderungen und das Affiliate-Badge.

X Account Location API

Land laut X
Verbindungsweg zu X
Mehrere Benutzernamen
0,7 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 Account Location

Der Bereich „Über dieses Konto“ auf X ist ein kurzer Steckbrief, der zu jedem Profil gehört: das Land oder die Region, in der das Konto ansässig ist, der App Store, die App oder der Web-Client, über den es sich verbindet, das Beitrittsdatum, die Zahl der Änderungen des Benutzernamens und die Organisation, mit der es verbunden ist. Zusammen gelesen zeigen diese Angaben, ob ein Konto von dort aus betrieben wird, wo seine Inhalte es vermuten lassen, sie helfen bei der Prüfung von Creatorn vor einer Zusammenarbeit und machen Gruppen von Konten mit einer unerwarteten gemeinsamen Herkunft sichtbar.

Funktionen der X Account Location API

  • Das Land, das X für jedes Konto angibtcountry enthält den Wert, den X im Bereich „Über dieses Konto“ des Profils als Sitz des Kontos nennt, zum Beispiel United States oder United Kingdom.
  • Wie das Konto auf X zugreiftconnected_via nennt den Kanal, den X dem Konto zuordnet, zum Beispiel United States App Store, Android App oder Web, und lässt sich direkt neben country stellen.
  • Beitrittsdatum und Verlauf des Handlespublished_at enthält das Datum, an dem das Konto X beigetreten ist, und username_changes_count zählt seine Umbenennungen – zwei schnelle Hinweise darauf, wie etabliert ein Handle ist.
  • Zugehörigkeit und Identitätsprüfungaffiliate_username zeigt das Organisations-Badge im Profil, etwa X bei elonmusk oder BBCNews bei BBCWorld, neben is_identity_verified und dem Flag is_verified für das blaue Häkchen.
  • Eine Zeile pro Benutzername in einer AufgabeSenden Sie eine Liste von Benutzernamen, ein führendes @ ist optional, und jedes Konto kommt als eigene Zeile zurück, mit id, username, name, avatar_url und is_private neben den Standortangaben.

Parameter der X Account Location API

ParameterErforderlichBeschreibung
usernamesErforderlichX-Benutzernamen, die abgefragt werden sollen, mit oder ohne führendes @. Jedes Konto liefert eine eigene Zeile.

So verwenden Sie die X Account Location API

Senden Sie Benutzernamen und lesen Sie pro Konto eine Zeile aus „Über dieses Konto“.

  1. Senden Sie {"usernames": ["elonmusk", "BBCWorld"]} per POST an /v1/x/user-about.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie pro Konto eine Zeile aus results.items und geben Sie results.next_cursor zurück, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["elonmusk","BBCWorld"]}'

# An account that shows no country on X still returns a row, with country set to null.

Anwendungsfälle der X Account Location API

  • Prüfen, von wo aus politische Konten und Nachrichtenkonten agieren: Fragen Sie die Handles ab, die ein politisches Thema oder Nachrichtenthema vorantreiben, und markieren Sie die Konten, deren country oder connected_via auf eine andere Weltregion verweist als das Publikum, an das sie sich richten.
  • Einen Creator vor einer bezahlten Partnerschaft prüfen: Bestätigen Sie, dass country zu dem Markt passt, für dessen Reichweite Sie bezahlen, und achten Sie bei published_at und username_changes_count auf ein kürzlich erstelltes oder häufig umbenanntes Handle.
  • Möglicherweise koordinierte Konten gruppieren: Gruppieren Sie verdächtige Konten nach country, connected_via und Beitrittsmonat, um Gruppen sichtbar zu machen, die etwa zur selben Zeit am selben Ort erstellt wurden.
  • Die Länder hinter einer Diskussion zählen: Übergeben Sie die Benutzernamen, die auf einen Post geantwortet oder ihn repostet haben und die Sie mit anderen X-Endpunkten erfasst haben, und zählen Sie country aus, um zu sehen, aus welchen Regionen die Diskussion kommt.

Profi-Tipps zur X Account Location API

  • Bevor Sie ein Konto als aus dem Ausland betrieben einstufen, lesen Sie country zusammen mit connected_via und published_at; ein einzelnes Feld kann für sich genommen in die Irre führen.
  • Speichern Sie Konten anhand ihrer id, denn username_changes_count zeigt, wie oft sich ein Handle ändern kann.
  • Bewahren Sie collected_at zu jeder Zeile auf und fragen Sie dieselben Benutzernamen später erneut ab, um eine Änderung bei country, connected_via oder username_changes_count zu erkennen.
  • Ordnen Sie die zurückgegebenen Zeilen über username Ihrer Eingabeliste zu: Fehlen einzelne Konten, kommen die übrigen trotzdem zurück, und für die fehlenden gibt es einfach keine Zeile.

Ergänzend zur X Account Location 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 Following List API — Profile erfassen, denen öffentliche X-Konten folgen – mit Identität, Bios, Kontosignalen, sichtbaren Zählern und Quell-Benutzernamen.
  • 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 Verified Followers API — Die verifizierten Konten erfassen, die einem Profil folgen – mit Benutzername, Anzeigename, Profilbild und Beitrittsdatum.

Weitere Plattformen entdecken

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

X Account Location API — FAQ

X Account Location API ist eine Programmierschnittstelle, die die Angaben aus „Über dieses Konto“ für X-Konten anhand einer Liste von Benutzernamen ausliest. Sie liefert das Land oder die Region, in der jedes Konto ansässig ist, die Art der Verbindung zu X, das Beitrittsdatum, die Zahl der Namensänderungen, das Affiliate-Badge und die Verifizierungs-Flags.

X zeigt das Land im Bereich „Über dieses Konto“ des Profils als Sitz des Kontos an. Übergeben Sie hier den Benutzernamen, und derselbe Wert kommt in country an, sodass Sie viele Konten in einer Aufgabe prüfen können.

Die Angabe beschreibt, von wo aus sich das Konto mit X verbindet, etwa über den App Store eines Landes, die Android-App oder das Web. Der Endpunkt liefert sie in connected_via.

Bei manchen Konten zeigt X kein Land an, darunter viele Regierungskonten und Konten von öffentlichem Interesse wie NASA. Auch sie liefern eine Zeile mit den übrigen Feldern, und country ist auf null gesetzt.

Es ist der Wert, den X selbst im Bereich „Über dieses Konto“ anzeigt, unverändert übernommen. Er sagt Ihnen, wo X das Konto verortet – eine Kennzeichnung von X und keine Live-Position der Person dahinter.

Nein. Der frei eingegebene Standort, den Personen in ihr Profil schreiben, ist ein separates Feld; die Twitter Profile Scraper API liefert ihn in location.