TwitterAPIs Docs
API ReferenceSearch

User 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. Cost: $0.0008 per call.

GET
/user/search

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

query*string

Keyword or partial handle to search for.

cursor?string

Pagination cursor from a previous response.

Response Body

application/json

curl -X GET "https://example.com/user/search?query=machine+learning"
{  "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"}