Get users (batch)

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 user returned · All plans from $0.00012/credit

curl "https://xquik.com/api/v1/x/users/batch?ids=44196397,987654321" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The Node.js and Python snippets shape durable profile rows instead of printing full profile objects. Persist profileRows or profile_rows and missingIds or missing_ids with the original ID list so retries only request missing profiles.

Direct batch user handoff

Use GET /x/users/batch when a CRM, warehouse, enrichment, lead scoring, or agent workflow already has numeric X user IDs and needs profile details in one JSON response. Use Get User when you have one ID or username to resolve. Store requested_ids, user_id, username, display_name, profile metrics, verification state, profile_image_url, has_next_page, and next_cursor. Join returned users by user_id instead of relying on response order. Send at most 100 IDs per request. Batch requests always return has_next_page: false and next_cursor: ""; zero affordable results return 402 insufficient_credits.

Query parameters

ids

string

required

Comma-separated user IDs. Maximum 100 per request.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

users

object[]

Array of user profiles matching the requested IDs.

Show User object fields

string

X user ID.

username

string

X username.

name

string

Display name.

description

string

Profile bio.

followers

number

Follower count.

following

number

Following count.

verified

boolean

Verified status.

profilePicture

string

Profile image URL.

location

string

Profile location.

createdAt

string

Account creation date (ISO 8601).

statusesCount

number

Total number of tweets posted. Omitted if unavailable.

coverPicture

string

Cover/banner image URL. Omitted if unavailable.

mediaCount

number

Total number of media tweets posted. Omitted if unavailable.

canDm

boolean

Whether the user accepts direct messages. Omitted if unavailable.

url

string

Website URL from profile. Omitted if empty.

favouritesCount

number

Total number of tweets liked. Omitted if unavailable.

hasCustomTimelines

boolean

Whether the user has custom timelines. Omitted if unavailable.

isTranslator

boolean

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

withheldInCountries

string[]

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

possiblySensitive

boolean

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

pinnedTweetIds

string[]

IDs of pinned tweets. Omitted if none.

isAutomated

boolean

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

automatedBy

string

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

unavailable

boolean

Whether the account is unavailable. Omitted if available.

unavailableReason

string

Reason the account is unavailable. Omitted if available.

verifiedType

string

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

profile_bio

object

Structured profile bio with entity annotations. Omitted if unavailable.

has_next_page

boolean

Always false for batch requests.

next_cursor

string

Always empty for batch requests.

{
  "users": [
    {
      "id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "followers": 200000000,
      "verified": true
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{ "error": "missing_ids", "message": "ids parameter required" }

{ "error": "too_many_ids", "message": "Max 100 IDs per request" }

{ "error": "unauthenticated" }

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits.

{ "error": "x_api_unavailable" }

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

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

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

{ "error": "x_api_unavailable" }

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

Related: Batch Tweets · Get User

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Get users (batch)

Direct batch user handoff

Query parameters

Headers

Response

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Documentation Index

​Direct batch user handoff

​Query parameters

​Headers

​Response

Direct batch user handoff

Query parameters

Headers

Response