X / Twitter API

X / Twitter Search users API

Search X (Twitter) accounts by keyword - the People tab of X search. Matches handles, display names, and profile bios, and returns normalized profile records with follower, following, and post counts plus cursor pagination. Use twitter.search for posts.

POST/v1/run/twitter.search_users
Uptime
93.75%
30d · 96 calls
Requests
96
30d · weekly, last 12 wks
Response
1.9s
median · 30d

Provider network

Providers ranked by traffic

Providers
CapybaraTried first77 served80.21% uptime1473ms p5085.6%$0.75/1k reqflatBadger13 served68.42% uptime348ms p5014.4%$0.105/1k resultsup to $0.0021 / request

Try it

Make your first request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "nextCursor": "example",
    "users": [
      {
        "avatarUrl": "https://example.com/image.jpg",
        "bio": "A short example description of this item.",
        "createdUtc": 12.5,
        "followers": 12500,
        "following": 12500,
        "id": "a1b2c3d4",
        "location": "example",
        "name": "Example title",
        "posts": 248,
        "profileUrl": "https://example.com/page",
        "username": "alex_rivera",
        "verified": true
      }
    ]
  },
  "found": true
}
Response interface
interface TwitterSearchUsersResponse {
  data: {
    nextCursor: string | null;
    users: {
      avatarUrl: string;
      bio: string;
      createdUtc: number;
      followers: number;
      following: number;
      id: string;
      location: string;
      name: string;
      posts: number;
      profileUrl: string;
      username: string;
      verified: boolean;
    }[];
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-16 · uptime and latency measured over 30d
POST /v1/run/twitter.search_users
curl -X POST https://api.getanyapi.com/v1/run/twitter.search_users \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"ai agents"}'
FieldTypeExample value
Request body
querystring"ai agents"Keyword to match against X (Twitter) handles, display names, and profile bios. This is the People tab of X search: pass a topic ('ai agents'), a name ('Elon Musk'), or a handle ('openai') and get back accounts, not posts. Use twitter.search for posts.
cursorstringOpaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of accounts.
Response
dataobjectThe page of matching accounts, or null when nothing was found.
data.nextCursorstringOpaque cursor for the next page of accounts, or null when this lane has no more. Pass it back as cursor to continue.
data.usersobject[]Matching X (Twitter) accounts, normalized to a compact profile record. Populated whenever the provider has data for the entity.
data.users[].avatarUrlstringURL of the account's profile image. Populated whenever the provider has data for the entity.
data.users[].biostringThe account's profile bio/description (may be empty).
data.users[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.users[].followersintegerHow many followers this account has.
data.users[].followingintegerHow many accounts this account follows.
data.users[].idstringThe account's numeric X user id. Populated whenever the provider has data for the entity.
data.users[].locationstringThe account's self-reported location (may be empty).
data.users[].namestringThe account's display name. Populated whenever the provider has data for the entity.
data.users[].postsintegerHow many posts this account has published.
data.users[].profileUrlstringCanonical URL of the account's X profile. Populated whenever the provider has data for the entity.
data.users[].usernamestringThe account's @ handle, without the @ prefix. Populated whenever the provider has data for the entity.
data.users[].verifiedbooleanWhether the account carries the blue verification check.
foundbooleanTrue when the search returned at least one account; false when nothing matched.
Price
Price per requestUSD$0.00075
Price /1k reqUSD$0.75

FAQ

About the X / Twitter Search users API

The AnyAPI X / Twitter Search users API returns X / Twitter search users data as normalized JSON from one POST call to /v1/run/twitter.search_users. Search X (Twitter) accounts by keyword - the People tab of X search. Matches handles, display names, and profile bios, and returns normalized profile records with follower, following, and post counts plus cursor pagination. Use twitter.search for posts. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $0.75 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 93.8% of X / Twitter search users calls through AnyAPI succeeded, with a median response time of 1.9 seconds across 96 measured calls.

It costs from $0.75 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Search X (Twitter) accounts by keyword - the People tab of X search. Matches handles, display names, and profile bios, and returns normalized profile records with follower, following, and post counts plus cursor pagination. Use twitter.search for posts. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 93.8% of X / Twitter search users calls through AnyAPI succeeded, with a median response time of 1.9 seconds across 96 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call

Other X / Twitter endpoints

Profilefrom $0.22 /1k reqUser tweetsfrom $0.50 /1k reqTweetfrom $0.22 /1k reqArticlefrom $0.75 /1k reqCommunityfrom $0.10 /1k reqCommunity tweetsfrom $0.50 /1k reqFollowersfrom $0.50 /1k reqFollowingfrom $0.50 /1k reqRepliesfrom $0.50 /1k reqSearchfrom $0.65 /1k reqSearch communitiesfrom $0.11 /1k resultsThreadfrom $5.00 /1k reqTrendsfrom $0.10 /1k reqTweet transcriptfrom $1.20 /1k reqUser postsfrom $0.50 /1k req