v1
latestOpenAPI 3.0.32026-07-213841124.9 KBSearch
Search users by Keyword
Searches for Twitter/X users by a keyword or phrase. You pass a query, and the endpoint returns a list of matching accounts with basic profile info like handle, user id, name, avatar, bio, follower stats, and verification or protected status. If there are more results, you will also receive a next_cursor for pagination.
Use cases:
SaaS products letting users find accounts inside an app; analysts researching people, projects, or brands by name keywords; marketing teams building lists of relevant creators or company accounts; CRM or enrichment tools turning a keyword into a set of candidate profiles; developers implementing autocomplete or “search people” with cursor paging./
post/search-users
Request body
Example request
{
"next_cursor": "JKHSJFHADUYJKSDy2y3u123",
"query": "elonmusk"
}Response
OK