Skip to main content
GET
/
x
/
users
/
search
Search users
curl --request GET \
  --url https://xquik.com/api/v1/x/users/search \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per result returned · All plans from $0.00012/credit
curl "https://xquik.com/api/v1/x/users/search?q=xquik" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
The Node.js and Python snippets shape durable search-result rows instead of printing full profile pages. Persist searchRows or search_rows with nextCursor or next_cursor before requesting the next page.

​
Direct user search handoff

Use GET /x/users/search when a CRM, enrichment, creator discovery, support, or agent workflow has a name, brand, or handle fragment and needs matching X profiles. Use Get User when you have one exact ID or username. Use Get Users (Batch) when you already have numeric user IDs. Store search_query, result_rank, user_id, username, display_name, profile metrics, verification state, profile_image_url, has_next_page, and next_cursor. Treat next_cursor as opaque and pass it back as cursor only when has_next_page is true. Zero affordable results return 402 insufficient_credits.

​
Query parameters

​
q
string
required
Search query string.
​
cursor
string
Pagination cursor from a previous response. Omit for the first page.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
users
object[]
Array of matching user profiles.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Cursor for the next page.
{
  "users": [
    {
      "id": "987654321",
      "username": "xquikcom",
      "name": "Xquik",
      "followers": 10000,
      "verified": true,
      "description": "All-in-one X automation platform"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}
Next steps: Get User to fetch full details, or Search Tweets to find tweets by query.
Last modified on May 17, 2026