查询账号注册所在地

查询目标推特账号的创建国家/注册归属地信息。

返回 API 接口列表

/Twitter Account Based in Endpoints

TwexAPI REST

POST/twitter/account/based

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

请求体

必填application/json

Array of string

string

响应结果

200推特账号注册国家/地区归属地查询结果

codeinteger

HTTP 响应状态码（200 表示成功）

default: 200

msgstring

响应提示信息（例如 'success'）

default: "success"

dataTwitterUserAboutResponse[] | any

接口返回的核心业务数据载荷

展开属性

Any of:

TwitterUserAboutResponse[]

Array of TwitterUserAboutResponse

user_idstring必填

目标用户的推特唯一数字 ID

avatarstring必填

用户头像图片 URL 地址

namestring必填

用户昵称/显示名称

screen_namestring必填

推特用户名（Handle，即 @ 后的名称）

created_atstring必填

发布或创建时间（UTC 标准时间格式）

profile_image_shapestring必填

头像显示形状外观（如 Circle 圆形、Square 方形；企业官方多为方形）

verificationboolean必填

该用户账号是否已经通过推特实名认证

userLabelDisplayTypestring必填

用户官方身份标签展示外观类型（例如 Badge 徽章）

userLabelTypestring必填

用户官方身份标签类型（例如 BusinessLabel 企业认证标签）

is_blue_verifiedboolean必填

是否为推特蓝 V 认证用户（X Premium 会员）

privacy_policy_urlstring必填

账号隐私政策说明或官方认证详情链接 URL

account_based_instring必填

推特账号的注册归属国家/地区

location_accurateboolean必填

用户主页标注的所在地信息是否经过精准定位核验

affiliate_usernamestring必填

从属关联的企业/机构主账号用户名

sourcestring必填

发推来源客户端名称（如 'Twitter for iPhone', 'Web App'）

username_changes_countinteger必填

该账号历史上更改推特用户名的累计次数

override_verified_yearinteger必填

认证年份覆盖字段（负数值代表官方特殊情形标记）

verified_since_msecinteger必填

账号通过认证审核的毫秒级时间戳（负数值代表官方特定特殊豁免分类）

any

any

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

响应提示信息（例如 'success'）

typestring必填

inputany

ctxobject

⚡交互式测试 / Try APIPOST/twitter/account/based

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

📝请求体application/json

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X POST "https://api.twexapi.io/twitter/account/based" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "screen_name",
  "elonmusk"
]'

const response = await fetch("https://api.twexapi.io/twitter/account/based", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "screen_name",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/account/based",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "screen_name",
  "elonmusk"
],
)

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "user_id": "44196397",
      "avatar": "https://pbs.twimg.com/profile_images/1983681414370619392/oTT3nm5Z_normal.jpg",
      "name": "Elon Musk",
      "screen_name": "elonmusk",
      "created_at": "Tue Jun 02 20:12:29 +0000 2009",
      "profile_image_shape": "Circle",
      "verification": false,
      "userLabelDisplayType": "Badge",
      "userLabelType": "BusinessLabel",
      "is_blue_verified": true,
      "privacy_policy_url": "https://help.twitter.com/managing-your-account/about-twitter-verified-accounts",
      "account_based_in": "United States",
      "location_accurate": true,
      "affiliate_username": "X",
      "source": "United States App Store",
      "username_changes_count": 0,
      "override_verified_year": -3000,
      "verified_since_msec": -156836000000000
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}