x/
user-about

ユーザー名から、Xがアカウントに表示している国や地域を調べられます。あわせて、Xへの接続元、利用開始日、ユーザー名の変更回数、所属バッジも返します。

X Account Location API

アカウントの所在地
接続元
複数ユーザー名を一括照会
結果1件あたり0.7クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

X Account Location

Xの「このアカウントについて」パネルは、すべてのプロフィールに付いている短い記録で、アカウントの所在地となる国や地域、接続に使っているアプリストア・アプリ・Web、利用開始日、ユーザー名の変更回数、所属している組織が記載されています。これらをあわせて読むと、アカウントが発信内容から想像される場所で運営されているかを確かめたり、契約前にクリエイターを審査したり、意外な共通の出自を持つアカウント群を見つけたりできます。

X Account Location API の主な機能

  • Xが各アカウントに表示する国United States や United Kingdom など、プロフィールの「このアカウントについて」パネルにある「アカウントの所在地」の値が country に入ります。
  • アカウントがXに接続する経路connected_via には、United States App Store、Android App、Web など、Xがアカウントに関連付けている接続元が入り、country と並べて確認できます。
  • 利用開始日とハンドルの変更履歴published_at はアカウントがXの利用を始めた日、username_changes_count はユーザー名の変更回数で、どちらもハンドルがどれだけ定着しているかを素早く判断する手がかりになります。
  • 所属組織と本人確認affiliate_username はプロフィールに表示される組織のバッジで、elonmusk なら X、BBCWorld なら BBCNews のように返ります。本人確認済みを示す is_identity_verified と、青いチェックマークのフラグ is_verified も並んで返ります。
  • 1つのタスクでユーザー名ごとに1行ユーザー名のリストを送信すると(先頭の @ は任意)、各アカウントが1行ずつ返り、所在地の情報に加えて id、username、name、avatar_url、is_private も含まれます。

X Account Location API のパラメータ

パラメータ必須説明
usernames必須照会するXのユーザー名です。先頭の @ は付けても付けなくてもかまいません。アカウントごとに1行が返ります。

X Account Location API の使い方

ユーザー名を送信し、アカウントごとに1行の「このアカウントについて」の情報を読み取ります。

  1. {"usernames": ["elonmusk", "BBCWorld"]} を /v1/x/user-about に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からアカウントごとに1行ずつ読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
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.

X Account Location API の主なユースケース

  • 政治・ニュース系アカウントの運営地を確認: 政治やニュースの話題を動かしているハンドルをまとめて照会し、country や connected_via が、呼びかけている相手とは世界の別の地域を示しているアカウントにフラグを付けます。
  • 有償タイアップ前のクリエイター審査: country が費用をかけてリーチしたい市場と一致しているかを確認し、published_at と username_changes_count を見て、最近作られたハンドルや何度も名前を変えているハンドルを見極めます。
  • 連携している可能性のあるアカウントのグループ化: 疑わしいアカウント群を country、connected_via、利用開始月でクラスタリングし、同じ時期に同じ場所からまとめて作られたアカウントの塊を浮かび上がらせます。
  • 会話の背後にある国の集計: 他のXエンドポイントで集めた、あるポストに返信またはリポストしたユーザー名を渡し、country を集計して、議論がどの地域から来ているかを把握します。

X Account Location API 活用のヒント

  • アカウントを海外運営と判断する前に、country を connected_via や published_at とあわせて読んでください。1つのフィールドだけでは誤解を招くことがあります。
  • username_changes_count からもわかるようにハンドルは変わることがあるため、アカウントは id をキーにして保存してください。
  • 各行に collected_at を残しておき、後日同じユーザー名で再実行すると、country、connected_via、username_changes_count の変化を捉えられます。
  • 返された行は username で入力リストと照合してください。一部のアカウントが存在しない場合でも残りは返され、結果に含まれるのは見つかったアカウントの行だけです。

X Account Location API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
  • X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
  • X Verified Followers API — プロフィールをフォローしている認証済みアカウントを、ユーザー名、表示名、アイコン、登録日とともに取得します。

他のプラットフォームを見る

Xのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

X Account Location API — よくある質問

X Account Location APIは、ユーザー名のリストからXアカウントの「このアカウントについて」の情報を読み取るためのプログラムインターフェースです。各アカウントの所在地となる国や地域、Xへの接続元、利用開始日、ユーザー名の変更回数、所属バッジ、認証フラグを返します。

Xではプロフィールの「このアカウントについて」パネルに「アカウントの所在地」として表示されます。ここでユーザー名を送信すると同じ値が country に返るため、1つのタスクで多数のアカウントを確認できます。

アカウントがどこからXに接続しているかを表し、国ごとの App Store、Android アプリ、Web などがあります。このエンドポイントでは connected_via に返ります。

X自体が国を表示していないアカウントがあり、NASA のような政府機関や公共性の高いアカウントの多くがこれに該当します。こうしたアカウントも1行として返り、他のフィールドは埋まったうえで country が null になります。

Xが「このアカウントについて」パネルに表示している値を、そのまま返したものです。Xがそのアカウントの拠点とみなしている場所を示すXのラベルであり、アカウントの背後にいる人物のリアルタイムの位置ではありません。

いいえ。ユーザーがプロフィールに自由に入力する場所は別のフィールドで、Twitter Profile Scraper API の location で取得できます。