v3

latestOpenAPI 3.0.32026-08-02415689.9 KB

Search Users

Searches for Twitter/X accounts by a keyword or phrase. Returns matching user profiles with basic info: handle, display name, bio, follower stats, and verification status. Supports pagination via next_cursor.

post/search-users

Request body

next_cursorstring

querystring

Example request

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

Response

next_cursorstring

Cursor for fetching the next page of results. Null or absent if no more pages.

Example response

{
  "users": [
    {
      "created_at": "2009-06-02T20:12:29Z",
      "description": "Bio text",
      "display_name": "Elon Musk",
      "favourites_count": 1200,
      "followers_count": 100000,
      "followings_count": 500,
      "id": "44196397",
      "location": "Austin, TX",
      "media_count": 300,
      "profile_background_image_url": "https://pbs.twimg.com/profile_banners/44196397/123",
      "profile_image_url": "https://pbs.twimg.com/profile_images/123/photo.jpg",
      "tweets_count": 5000,
      "username": "elonmusk",
      "verified": true
    }
  ]
}