Search Users

Search for X users by name, bio keywords, or username. Returns user profiles with follower counts, tweet counts, and verification status.

POST/v2/search/usersSearch users with keyword matching. Up to 1,000 per request (same on every plan; paginate for more).

Parameter	Type	Required	Default	Description
query	string	required	—	Search query: matches against username, display name, and bio
count	integer	optional	20	Results per page (up to 1,000 per request; same on every plan; paginate for more). Also accepts "limit"
sort	string	optional	default	Sort: default (X native order), followers (most followers first), name (alphabetical)
cursor	string	optional	—	Pagination cursor from previous response

Example Request

BASH

curl -X POST https://xcrop.io/api/v2/search/users \
  -H "Authorization: Bearer $XCROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "crypto trader", "count": 10}'

Example Response

200 OKJSON

{
  "data": [
    {
      "id": "900001",
      "username": "cryptotrader_x",
      "name": "Crypto Trader X",
      "description": "Full-time crypto trader since 2017",
      "followers": 142000,
      "following": 890,
      "tweets_count": 28400,
      "verified": true,
      "verified_type": null,
      "profile_image": "https://pbs.twimg.com/profile_images/...",
      "created_at": "Thu Jan 12 08:30:00 +0000 2017"
    }
  ],
  "meta": {
    "total": 10,
    "has_next_page": true,
    "next_cursor": "eyJvZmZzZXQiOjEwfQ==",
    "query": "crypto trader",
    "latency_ms": 2180
  }
}

More in REST API

Full documentation with search: xcrop.io/docs