xAPIs.dev
API Reference · v2
Free Tools{ }OpenAPI YAMLGet API key
API Reference / User / Search users

Search users

GET/twitter/user/search18 credits

Search for users by keyword. Returns matching public profiles. The sample response below is captured from the live API. List endpoints paginate with `has_next_page` and `next_cursor`.

Authentication required
Send your key in the x-api-key header. Requests without a valid key return 401.

Query parameters

query
stringrequired
Keyword or phrase to search user profiles for.

Response fields

usersarray
Array of user profile objects.
has_next_pageboolean
Whether another page of results is available.
next_cursorstring
Cursor for the next page; null or empty when exhausted.
Request
curl https://v2.xapis.dev/twitter/user/search \
  -G --data-urlencode "query=ai" \
  -H "x-api-key: $XAPIS_KEY"
Response200 OK
application/json
{
  "users": [
    {
      "id": "189534066",
      "name": "Julian Jewel's AI Bot",
      "screen_name": "jjaibot",
      "username": null,
      "location": "Julian, CA, USA",
      "url": "https://t.co/YhX9FWm5U0",
      "description": "Artificial Intelligence Bot+Human Physiology 🙈🙉🙊\nProtecting Environment, Conserving Wildlife\nCrea…",
      "email": null,
      "protected": false,
      "verified": false,
      "followers_count": 2918484,
      "following_count": 4,
      "friends_count": 4,
      "favourites_count": 21,
      "statuses_count": 499,
      "media_tweets_count": 12,
      "created_at": "Sat Sep 11 14:46:05 +0000 2010",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/189534066/1684898907",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/1661212539475353600/FRGP3c4G_normal.jpg",
      "can_dm": true,
      "isBlueVerified": true
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAAFCgABHMsWKwJ__z8LAAIAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRVkliUmtnWmV3QlJtUHJYSHBHd0FBRithb1NL…"
}
base url · https://v2.xapis.dev
Ready to call Search users?