Skip to main content
GET
/
x
/
users
/
{id}
Get user
curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id} \
  --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.

1 credit per call · All plans from $0.00012/credit
curl https://xquik.com/api/v1/x/users/xquikcom \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
Use GET /x/users/{id} when a workflow needs one durable profile row for CRM enrichment, lead scoring, account monitoring, or support triage. Store user_id, username, display_name, bio, follower_count, following_count, verified, verified_type, profile_url, profile_image_url, created_at, and unavailable_reason instead of logging the full lookup response.

Profile row

Store id as user_id plus username, name, description, followers, following, verified, and verifiedType.

Lookup key

Use a numeric user ID for durable joins. Use username lookup when the workflow starts from a handle.

Availability

Store unavailable and unavailableReason when returned, so retries, support triage, and CRM syncs distinguish missing accounts from unavailable profiles.

Next action

Use the returned id for followers, following, timelines, media, DMs, follow checks, and monitor setup.

​
Path parameters

​
id
string
required
User ID or username (without @).

​
Which user endpoint?

User profile

Use GET /x/users/{id} for one profile row by username or numeric user ID.

Search users

Use GET /x/users/search when the workflow starts from a name, keyword, or partial handle.

Profile timeline

Use GET /x/users/{id}/tweets for posts from one profile.

Followers

Use GET /x/users/{id}/followers when the next step needs audience rows.

Follow check

Use GET /x/followers/check when the workflow only needs one source-target relationship.

Saved exports

Use Create extraction. Create saved CSV/JSON/XLSX jobs. Export followers, following, timelines, media, or search.

​
Headers

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

​
Response

​
id
string
User ID.
​
username
string
X username.
​
name
string
Display name.
​
description
string
Profile bio. Omitted if empty.
​
followers
number
Follower count. Omitted if unavailable.
​
following
number
Following count. Omitted if unavailable.
​
verified
boolean
Whether the user is verified. Omitted if unavailable.
​
profilePicture
string
Profile picture URL. Omitted if unavailable.
​
location
string
Profile location. Omitted if empty.
​
createdAt
string
ISO 8601 account creation timestamp. Omitted if unavailable.
​
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 (lists). Omitted if unavailable.
​
isTranslator
boolean
Whether the user is a Twitter 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 (suspended, deactivated). 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.
{
  "id": "987654321",
  "username": "xquikcom",
  "name": "Xquik",
  "description": "X real-time data platform",
  "followers": 10000,
  "following": 500,
  "verified": true,
  "profilePicture": "https://pbs.twimg.com/profile_images/xquik/photo.jpg",
  "coverPicture": "https://pbs.twimg.com/profile_banners/xquik/cover.jpg",
  "location": "San Francisco",
  "url": "https://xquik.com",
  "createdAt": "2020-01-15T00:00:00.000Z",
  "statusesCount": 5000,
  "mediaCount": 120,
  "favouritesCount": 430,
  "canDm": true,
  "isAutomated": false,
  "possiblySensitive": false,
  "hasCustomTimelines": false,
  "pinnedTweetIds": ["1234567890"]
}
Next steps: Check Follower to verify follow relationships, or Search Tweets to find tweets from this user.
Last modified on May 25, 2026