GET
/user/search$0.0008 / callUser Search
Search the user directory by keyword. Matches against display name, handle, and bio. Useful for discovery, lead lists, and resolving partial handles into full profiles.
Request
curl "https://api.twitterapis.com/user/search?query=machine%20learning" \
-H "Authorization: Bearer $TWITTERAPIS_KEY"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Keyword or partial handle to search for. Example: |
cursor | string | optional | Pagination cursor from a previous response. |
Response
| Field | Type | Description |
|---|---|---|
users | array<User> | Matching user objects for this page. |
has_next_page | boolean | True when more results are available; pass next_cursor to fetch them. |
next_cursor | string | Opaque cursor token for the next page. Empty string on the final page. |
status | string | Request status, "success" on a normal response. |
Example response
{
"users": [
{
"id": "44196397",
"username": "elonmusk",
"name": "Elon Musk",
"description": "",
"followers_count": 211000000,
"is_blue_verified": true
}
],
"has_next_page": true,
"next_cursor": "DAABCgABF...",
"status": "success"
}Pricing for this endpoint
user/search costs $0.0008 per call and returns ~20 tweets, so roughly $0.04 per 1,000 tweets. No subscriptions or minimum spend.