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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | X-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“.
- Senden Sie {"usernames": ["elonmusk", "BBCWorld"]} per POST an /v1/x/user-about.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- 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 API
- X Community Posts API
- X Thread Context 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