X / Twitter User Search

Name: X (Twitter) X / Twitter User Search
Price: 0.00054 USD
Availability: InStock
Author: X (Twitter)

https://api.sandbase.ai/v1/api/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.

Try this API Get API key

Price: $0.0005USD / call
Method: POST
Response: JSON
Parameters: 1 required · 2 optional

Production route

Try the model

Playground

Open playground

Input

Query(string)

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.

Cursor(string)

Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of accounts.

RequireFields(array)

Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `location`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.0005 / run

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

query: string · required
cursor: string · optional
requireFields: array · optional

Access

Provider: X (Twitter)
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/twitter/search-users
Authentication: Bearer API key

API README

X / Twitter User Search API

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "twitter/search-users", "query": "ai agents"}'

The result is returned in outputs[0].data. Lookups that find nothing fail with a not-found error.

Parameters

Name	Type	Required	Description
`query`	string	Yes	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
`cursor`	string	No	Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of accounts.
`requireFields`	array	No	Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `location`, and it is served only by a source that returns every one o

Pricing

Billed at the actual cost of each call, usually $0.00054 per request. A call can cost more when the first data source fails and another one answers. Failed calls and lookups that find nothing are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/twitter/search-users

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/twitter/search-users" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "query": "ai agents"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
X / Twitter User SearchThis API `X (Twitter)`	From $0.0005 per call	JSON	Oct 31, 2026
X / Twitter Article `X (Twitter)`	From $0.0005 per call	JSON	Oct 31, 2026
X (Twitter) Twitter Community `X (Twitter)`	From $0.0001 per call	JSON	Oct 31, 2026
X (Twitter) Twitter Community Tweets `X (Twitter)`	From $0.0004 per call	JSON	Oct 31, 2026
Twitter Post Comments `Twitter`	$0.01 per call	JSON	Oct 29, 2026
Twitter Post Detail `Twitter`	$0.01 per call	JSON	Oct 29, 2026

Questions

FAQ

How do I use the X / Twitter User Search API?

Send a POST request to https://api.sandbase.ai/v1/api/twitter/search-users with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the X / Twitter User Search API cost?

From $0.0005 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the X / Twitter User Search API accept?

Required: query (string). Optional: cursor (string) and requireFields (array). The Parameters table and the Playground on this page list every field.

What does the X / Twitter User Search API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a X (Twitter) developer account or API key?

No. X / Twitter User Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for X (Twitter) API access separately.