public social platform アカウントの所在地・国を特定・判別する方法 (API 活用ガイド)

著者:TwexAPI チーム
JA
他の言語:
日本語
English中文
public social platform アカウント所在地
public social platform 国判別
インフルエンサー調査
public social data API Python
TwexAPI

public social platform アカウントの account_based_in や location_accurate シグナルを取得し、インフルエンサーの活動国や偽アカウントの所在地を判別する方法を解説。

Quick Answer

Account-based.in(アカウント由来の地域シグナル)は TwexAPI のユーザー API でプロフィールメタデータとして取得し、インフルエンサー審査や広告ターゲティングに使えます。Pro で約 $0.05/1K、大量スクリーニングが可能です。

FAQ

この用途で公式 public social data API ではなく TwexAPI を使う理由は?

account-based.in 取得 では https://docs.twexapi.io に記載された TwexAPI Bearer workflow を利用できます。通常の Post/Profile read は 5 Credits(約 $0.05/1K)で、対象プランは 20+ QPS を公開しています。新規アカウントには 20,000 starting Credits が付与されます。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

TwexAPI でこのワークフローのコストは?

通常の読み取りは約 5 Credits です。公開換算では 1,000 回で 5,000 Credits(約 $0.05)、10,000 回で約 50,000 Credits です。実際の cost は endpoint ごとに異なるため https://twexapi.io/pricing を確認してください。

X profile の location はユーザーが自由に編集でき、冗談やブランド文言であることもあります。クリエイター審査、提携先確認、地域キャンペーンの確認、不審アカウントの調査では、自由入力の location だけでは足りません。

TwexAPI の User About endpoint は、指定した screen name に対して account_based_in、location_accurate、関連する account metadata を返します。これらの fields は review evidence として扱い、live GPS location や完全な identity check とは見なさないでください。

このエンドポイントで分かること

Answer: このエンドポイントで分かることとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

次のような問いに向いています。

  • この X アカウントはどの国または地域を示しているか?
  • response は location signal を accurate としているか?
  • organization affiliation や verification label があるか?
  • username changes が多く、追加 review が必要か?

Influencer vetting、partner onboarding、regional campaign review、account-risk scoring、compliance triage で使いやすい endpoint です。

API エンドポイント

Answer: API エンドポイントは本ガイドの TwexAPI エンドポイントを Bearer で呼び出して実装します。バッチ/ページングで約 5 Credits/回・20+ QPS です。

GET https://api.twexapi.io/twitter/{screen_name}/about

Authorization: Bearer <your_token>

Path parameter:

Parameter説明
screen_name確認する X username。@ は含めません

Request example:

curl --request GET \
  --url https://api.twexapi.io/twitter/elonmusk/about \
  --header 'Authorization: Bearer <your_token>'

使うべきレスポンスフィールド

Answer: 使うべきレスポンスフィールドとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

Response は code、msg、data を含む standard object です。Account details は data に入ります。

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "user_id": "44196397",
6    "name": "Elon Musk",
7    "screen_name": "elonmusk",
8    "account_based_in": "United States",
9    "location_accurate": true,
10    "source": "United States App Store",
11    "username_changes_count": 0,
12    "is_blue_verified": true,
13    "userLabelType": "BusinessLabel",
14    "affiliate_username": "X"
15  }
16}
Field解釈
account_based_inアカウントの国または地域シグナル
location_accurateresponse が location signal を accurate としているか
source利用可能な場合に返る account source information
username_changes_counthandle changes が多い場合の review signal
userLabelType / affiliate_usernameorganization や affiliation context
is_blue_verified / verificationverification signal。単体では identity proof ではない

Python 例

Answer: Python 例とは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

次の例は 1 アカウントを取得し、review record として使いやすい形に整えます。Audit 用途では raw response も保存してください。

1import os
2import requests
3
4API_BASE = "https://api.twexapi.io"
5TOKEN = os.environ["TWEXAPI_TOKEN"]
6
7def get_account_location(screen_name: str) -> dict:
8    response = requests.get(
9        f"{API_BASE}/twitter/{screen_name}/about",
10        headers={"Authorization": f"Bearer {TOKEN}"},
11        timeout=30,
12    )
13    response.raise_for_status()
14
15    payload = response.json()
16    if payload.get("code") not in (None, 200):
17        raise RuntimeError(payload.get("msg", "TwexAPI request failed"))
18
19    data = payload.get("data") or {}
20    return {
21        "screen_name": data.get("screen_name") or screen_name,
22        "user_id": data.get("user_id"),
23        "account_based_in": data.get("account_based_in"),
24        "location_accurate": data.get("location_accurate"),
25        "source": data.get("source"),
26        "username_changes_count": data.get("username_changes_count"),
27        "is_blue_verified": data.get("is_blue_verified"),
28        "user_label_type": data.get("userLabelType"),
29        "affiliate_username": data.get("affiliate_username"),
30        "raw": data,
31    }
32
33if __name__ == "__main__":
34    result = get_account_location("elonmusk")
35    print(result)

実行方法:

TWEXAPI_TOKEN="your_twexapi_bearer_token" python check-account-based-in.py

バッチレビューの形

Answer: バッチレビューの形とは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

この endpoint は 1 request で 1 screen name を確認します。Batch job では list を loop し、result が返るたびに保存します。

Production では次を推奨します。

  • screen_name の input file または database table を使う
  • 各 result に checked_at を保存する
  • auditability のため raw data object を保存する
  • account_based_in を自社の country/region taxonomy に normalize する
  • missing、unexpected、low-confidence な location result を manual review に回す
  • この field だけで approve / reject を自動決定しない

よくある誤読

Answer: よくある誤読とは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

account_based_in は profile の free-form location field とは別です。また、account owner が今その国に物理的にいることを証明するものでもありません。

location_accurate: true でも、final verdict ではなく signal として扱います。High-impact decisions では、account age、username-change history、organization affiliation、post language、campaign records、manual review と組み合わせて判断してください。

使うべきワークフロー

Answer: 使うべきワークフローとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

次のような workflow に向いています。

  • creator / influencer onboarding
  • partner / affiliate review
  • regional campaign eligibility checks
  • suspicious account triage
  • market research segmentation
  • account geography が必要な compliance workflows

安全な pattern は、結果を保存し、context と一緒に reviewer へ見せることです。この field は decision を支援するものであり、decision 全体を代替するものではありません。

関連リソース

Answer: 関連リソースとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits(約 $0.05/1K)、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

public social platform アカウントの所在地・国を特定・判別する方法 (API 活用ガイド)