获取 Twitter 用户列表

GET /api/open/twitter/users

该接口返回公开 Twitter 用户列表，按粉丝数降序。每条含 twitterCategory / categorySlugs，与 GET /api/open/categories?scope=twitter 及 GET /api/open/category-groups?module=twitter 联用，用于筛选与展示。

请求地址

GET /api/open/twitter/users

请求参数

参数	类型	是否必传	说明
`locale`	string	否	展示语言（若存在多语言字段）
`q`	string	否	名称、handle、简介搜索
`tag`	string	否	逗号分隔的分类 slug，用于筛选

返回体

200 OK，application/json：

字段	类型	说明
`users`	object[]	用户列表，每项为 `TwitterUser`

TwitterUser 结构

字段	类型	说明
`handle`	string	Twitter handle（@xxx）
`name`	string	显示名称
`description`	string \| undefined	简介
`twitterCategory`	string[]	分类标签（展示用）
`categorySlugs`	string[]	分类 slug 列表，与 categories 的 `key` 对齐
`followers_count`	number	粉丝数

错误码

HTTP 状态	场景
`429`	命中 open API 限流
`500`	服务器内部错误

请求示例

curl -s "https://www.web3base.ai/api/open/twitter/users?locale=zh-hans" | jq '.users[0]'
curl -s "https://www.web3base.ai/api/open/twitter/users?tag=defi,protocol" | jq '.users | length'

返回示例

{
  "users": [
    {
      "handle": "vitalikbuterin",
      "name": "Vitalik Buterin",
      "description": "Co-founder of Ethereum",
      "twitterCategory": ["协议"],
      "categorySlugs": ["protocol"],
      "followers_count": 5000000
    }
  ]
}

← 返回 API 总览