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行の「このアカウントについて」の情報を読み取ります。
- {"usernames": ["elonmusk", "BBCWorld"]} を /v1/x/user-about に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 で入力リストと照合してください。一部のアカウントが存在しない場合でも残りは返され、結果に含まれるのは見つかったアカウントの行だけです。
関連API
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 — プロフィールをフォローしている認証済みアカウントを、ユーザー名、表示名、アイコン、登録日とともに取得します。
- 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