Get verified followers

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 · Accepts MPP

Get verified followers returns verified profiles that follow one X account by username or numeric user ID. It is also useful as a verified followers API, X verified followers API, or Twitter verified followers API. The canonical endpoint remains GET /api/v1/x/users/{id}/verified-followers.

curl "https://xquik.com/api/v1/x/users/xquikcom/verified-followers" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The Node.js and Python snippets shape durable verified follower rows instead of printing the full response page. Persist verifiedRows or verified_rows with the checkpoint so a worker can resume pagination with next_cursor without duplicating already imported profiles.

Direct verified followers handoff

Use GET /x/users/{id}/verified-followers when a CRM, warehouse, scoring, enrichment, or agent workflow needs one JSON page of verified followers now. The endpoint accepts either a username or numeric user ID and returns verified follower profile rows with cursor fields. Use verified_follower_explorer when you need an estimated job, saved extraction, or CSV/JSON/XLSX file export.

Verified rows

Store users[] as the verified follower profile rows returned on this page.

Stable upserts

Store users[].id as x_user_id for CRM, warehouse, scoring, and agent dedupe.

Readable labels

Store users[].username and users[].name for handles, labels, enrichment, and review queues.

Verification signals

Store users[].verified and verifiedType to segment standard, business, and government accounts.

Audience signals

Store users[].followers, users[].following, and statusesCount for scoring and prioritization.

Profile enrichment

Store users[].description, location, url, profilePicture, and coverPicture when returned.

Store has_next_page and next_cursor; pass next_cursor back as cursor only when has_next_page is true.

Direct verified followers cost 1 credit per user returned. Low credit balances can return fewer users than a full page; zero affordable results return 402 insufficient_credits. For MPP callers, this endpoint is billed as a session at USD 0.00015 per user returned.

Path parameters

string

required

User ID (numeric) or username.

Query parameters

cursor

string

Pagination cursor from next_cursor in a previous response. Omit for the first page. Pass a cursor only when has_next_page is true.

Which verified follower endpoint?

Verified followers

Use GET /x/users/{id}/verified-followers for verified accounts that follow one profile.

All followers

Use GET /x/users/{id}/followers when you need all followers, not only verified accounts.

Following list

Use GET /x/users/{id}/following for accounts the profile follows.

Saved exports

Use verified_follower_explorer for a saved verified follower extraction with CSV, JSON, or XLSX download handoff.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

users

object[]

Array of verified follower profiles.

Show User object fields

string

X user ID.

username

string

X username.

name

string

Display name.

description

string

Profile bio. Omitted if empty.

followers

number

Follower count.

following

number

Following count.

verified

boolean

Whether the user is verified. Always true for this endpoint.

verifiedType

string

Verification type (e.g. Business, Government). Omitted for standard blue check.

profilePicture

string

Profile picture URL.

location

string

Profile location. Omitted if empty.

createdAt

string

ISO 8601 account creation timestamp.

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.

profile_bio

object

Structured profile bio with entity annotations. Omitted if unavailable.

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,
      "verifiedType": "Business"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}

{ "error": "invalid_user_id", "message": "User not found or invalid user ID. Check the username or ID." }

{ "error": "user_not_found", "message": "X user not found. Check the username." }

{ "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: Create extraction with verified_follower_explorer for saved verified follower jobs, Export extraction for CSV, JSON, or XLSX downloads, Get followers, Get following, and Get followers you know.

Documentation Index

​Direct verified followers handoff

Verified rows

Stable upserts

Readable labels

Verification signals

Audience signals

Profile enrichment

Next page

​Path parameters

​Query parameters

​Which verified follower endpoint?

Verified followers

All followers

Following list

Saved exports

​Headers

​Response

Direct verified followers handoff

Path parameters

Query parameters

Which verified follower endpoint?

Headers

Response