Public Twitter user list with categories and follower count; search and filter by category.
Get Twitter users list
GET /api/open/twitter/users
Returns the public Twitter user list, ordered by follower count descending. Each item has twitterCategory / categorySlugs; use with GET /api/open/categories?scope=twitter and GET /api/open/category-groups?module=twitter for filtering and display.
Endpoint
GET /api/open/twitter/users
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
locale | string | No | Display language when i18n fields exist |
q | string | No | Search by name, handle, description |
tag | string | No | Comma-separated category slugs for filtering |
Response
200 OK, application/json:
| Field | Type | Description |
|---|---|---|
users | object[] | List of TwitterUser |
TwitterUser
| Field | Type | Description |
|---|---|---|
handle | string | Twitter handle (@xxx) |
name | string | Display name |
description | string | undefined | Bio |
twitterCategory | string[] | Category labels (display) |
categorySlugs | string[] | Category slugs, aligned with categories key |
followers_count | number | Follower count |
Errors
| HTTP status | When |
|---|---|
429 | Open API rate limit |
500 | Server error |
Example request
curl -s "https://www.web3base.ai/api/open/twitter/users?locale=en" | jq '.users[0]'
curl -s "https://www.web3base.ai/api/open/twitter/users?tag=defi,protocol" | jq '.users | length'Example response
{
"users": [
{
"handle": "vitalikbuterin",
"name": "Vitalik Buterin",
"description": "Co-founder of Ethereum",
"twitterCategory": ["Protocol"],
"categorySlugs": ["protocol"],
"followers_count": 5000000
}
]
}