Twitter user search, lookup & audience counts

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

GET

users

Twitter user search, lookup & audience counts

curl --request GET \
  --url https://xquik.com/api/v1/x/users/search

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "users": [
    {}
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

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_api_key_here" | jq

const query = "xquik";
const params = new URLSearchParams({ q: query });
const response = await fetch(`https://xquik.com/api/v1/x/users/search?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const nextCursor = data.has_next_page ? data.next_cursor : null;
const searchRows = data.users.map((user, index) => ({
  search_query: query,
  result_rank: index + 1,
  user_id: user.id,
  username: user.username,
  display_name: user.name,
  bio: user.description ?? null,
  follower_count: user.followers ?? null,
  following_count: user.following ?? null,
  verified: user.verified ?? false,
  profile_image_url: user.profilePicture ?? null,
  next_cursor: nextCursor,
}));

import requests

query = "xquik"
response = requests.get(
    "https://xquik.com/api/v1/x/users/search",
    params={"q": query},
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
next_cursor = data["next_cursor"] if data["has_next_page"] else None
search_rows = [
    {
        "search_query": query,
        "result_rank": index + 1,
        "user_id": user["id"],
        "username": user["username"],
        "display_name": user["name"],
        "bio": user.get("description"),
        "follower_count": user.get("followers"),
        "following_count": user.get("following"),
        "verified": user.get("verified", False),
        "profile_image_url": user.get("profilePicture"),
        "next_cursor": next_cursor,
    }
    for index, user in enumerate(data["users"])
]

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.

Resolve the intended X profile

Use user search when a workflow starts with a name or username fragment. Inspect several candidates before choosing a numeric user ID. Similar profile names can represent unrelated people or organizations. Show reviewers:

Username and profile name.
Biography and location.
Verification state.
Follower and following counts.
Profile image and numeric user ID.

Store the chosen user ID for later requests. Usernames can change. Numeric IDs remain the safer handoff for followers, following, timelines, and profile lookups. Search results can be empty without representing an API failure. Separate no matches from invalid authentication, rate limits, and insufficient credits. Do not use a result row number as identity. Ranking can change between searches. Always pass the selected user ID into the next workflow.

Query parameters

string

required

Search query string.

string

Pagination cursor from a previous response. Omit for the first page.

integer

Profiles per page. Range: 20-200. Defaults to 20.

User result filters

These filters apply before billing. Selective filters can return fewer rows.

integer

Require this minimum follower count. Filtering happens before billing.

integer

Allow this maximum follower count. Missing counts pass this filter.

integer

Require this minimum following count.

integer

Allow this maximum following count. Missing counts pass this filter.

integer

Require this minimum post count.

integer

Allow this maximum post count. Missing counts pass this filter.

integer

Require this minimum account age in days.

boolean

When true, only return verified profiles.

string

Match the exact verification type.

boolean

When true, require a profile website.

boolean

When true, require a profile location.

string

Require every comma-separated or line-separated bio term.

string

Require this text in the profile location.

string

Require this text in the username.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Array of matching user profiles. User object fields.

string

X user ID.

string

X username.

string

Display name.

string

Profile bio.

number

Follower count.

number

Following count.

boolean

Verified status.

string

Profile image URL.

string

Profile location.

string

Account creation date (ISO 8601).

number

Total number of tweets posted. Omitted if unavailable.

string

Cover/banner image URL. Omitted if unavailable.

number

Total number of media tweets posted. Omitted if unavailable.

string

Website URL from profile. Omitted if empty.

number

Total number of tweets liked. Omitted if unavailable.

boolean

Whether the user has custom timelines. Omitted if unavailable.

boolean

Whether the user is an X translator. Omitted if unavailable.

string[]

Country codes where the account is withheld. Omitted if empty.

boolean

Whether the account is flagged as possibly sensitive. Omitted if unavailable.

string[]

IDs of pinned tweets. Omitted if none.

boolean

Whether the account is marked as automated. Omitted if unavailable.

string

Username of the account operator if automated. Omitted if not automated.

boolean

Whether the account is unavailable. Omitted if available.

string

Reason the account is unavailable. Omitted if available.

string

Verification type (e.g. Business, Government). Omitted if not verified or standard blue check.

object

Structured profile bio with entity annotations. Omitted if unavailable.

boolean

Whether the account has X Premium verification. Omitted if unavailable.

boolean

Normalized verification status. Omitted if unavailable.

string

Profile banner URL. Omitted if unavailable.

boolean

Whether the account protects its posts. Omitted if unavailable.

string

Role within the requested community context. Omitted outside community results.

boolean

Whether more results are available.

string

Cursor for the next page.

{
  "users": [
    {
      "id": "987654321",
      "username": "username",
      "name": "Xquik",
      "followers": 10000,
      "verified": true,
      "description": "All-in-one X automation platform"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}

400 Missing query

{ "error": "missing_query" }

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

402 Payment required

Account keys get account options; guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

Your tier rate limit was exceeded. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Next steps. Get User to fetch full details, or Search Tweets to find tweets by query.

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

Twitter user search, lookup & audience counts

curl --request GET \
  --url https://xquik.com/api/v1/x/users/search

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "users": [
    {}
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter user search, lookup & audience counts

Direct user search handoff

Resolve the intended X profile

Query parameters

User result filters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed

​Direct user search handoff

​Resolve the intended X profile

​Query parameters

​User result filters

​Headers

​Response

​200 OK

​400 Missing query

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Direct user search handoff

Resolve the intended X profile

Query parameters

User result filters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed