v1

latestOpenAPI 3.0.32026-07-213841124.9 KB
Search

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

next_cursorstring
querystring

Example request

{
  "next_cursor": "JKHSJFHADUYJKSDy2y3u123",
  "query": "elonmusk"
}

Response

OK

next_cursorstring