Search Users

Search for users by username, display name, or keywords in their bio. Returns matching user profiles with comprehensive data. Useful for finding accounts related to specific topics or interests.

GET /v1/twitter/users/search_users

Search users

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/twitter/users/search_users \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "created_at": "Tue Jun 02 20:12:29 +0000 2009",
      "description": "Mars & Cars, Chips & Dips",
      "location": "Mars",
      "url": "<string>",
      "profile_image_url": "<string>",
      "profile_banner_url": "<string>",
      "followers_count": 0,
      "following_count": 0,
      "tweet_count": 0,
      "listed_count": 0,
      "favourites_count": 123,
      "media_count": 123,
      "verified": false,
      "verified_type": "<string>",
      "is_blue_verified": true,
      "created_at_datetime": "<string>",
      "protected": true,
      "possibly_sensitive": true,
      "followed_by": true,
      "following": true,
      "can_dm": true,
      "professional_type": "<string>",
      "pinned_tweet_ids": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

x-api-key · string · header · required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Query Parameters

query · string · required

Search query to match against usernames, display names, and bios.

Example:

"machine learning"

cursor · string

Pagination cursor for fetching the next page of results.

Response

200

application/json

Successfully retrieved search results.

Paginated list of users.

data · object[] | null

Array of user objects.

Show child attributes

next_cursor · string | null

Cursor for fetching the next page. Null if no more results.