Users

Search users

GET /v1/users/search reads 2 credits

People search: accounts matching a name, handle or bio words, best matches first.

Query parameters

Query parameter	Type	Meaning
`q` *	string	Name, handle or bio words
`count`	int 1–100 = 20	Requested page size; X treats it as a hint
`cursor`	string	From the previous page's `next_cursor`

response

The query, a page of full user records, and a cursor (null at the end). Field by field: User.

Status: 200, 400, 429, 502

request

curl https://api.xsignalfeed.com/v1/users/search?q=reuters&count=20 \
  -H "Authorization: Bearer xsf_your_key"

response · 200 / 400

{
  "query": "reuters",
  "users": [
    {
      "id": "1652541",
      "screen_name": "Reuters",
      "name": "Reuters",
      "bio": "Top and breaking news, pictures and videos from Reuters…",
      "avatar": "https://pbs.twimg.com/profile_images/…",
      "banner": "https://pbs.twimg.com/profile_banners/1652541/…",
      "followers": 26367698,
      "following": 1195,
      "tweets": 1395836,
      "location": "Around the world",
      "url": "https://t.co/…",
      "verified": true,
      "verified_type": "Business",
      "protected": false,
      "created_at": "2007-03-20T17:46:05Z",
      "category": "Media & News Company"
    },
    {
      "…": "…"
    }
  ],
  "next_cursor": "DAAFCgABHSYySrM__6MLAAIAAACIRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUFvQUFBQUFFLzZsVWd…"
}