TwitterAPIs Docs
API ReferenceFollower Graph

Twitter Verified Followers API | Blue Followers

Fetch only the Verified (Blue) accounts that follow a user, cursor-paginated. A fast way to filter a large follower base down to higher-signal accounts. Cost: $0.0008 per call.

Verified Followers pages through only the verified (Blue) accounts that follow a user, returned as cursor-paginated full user objects. It is a fast way to filter a large follower base down to higher-signal accounts. The cursor stays non-null on the final page, so stop when the users array is empty. Each page is one $0.0008 read.

GET
/user/verified_followers

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

username*string

Handle without the leading @.

user_id?string

Numeric user ID; provide either username or user_id.

cursor?string

Pagination cursor from a previous response.

count?integer

Max items to return for this page. Default 20; clamped to 1-100.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/user/verified_followers?username=naval&user_id=44196397&count=20"
{  "users": [    {      "id": "2178758961",      "username": "balajis",      "name": "Balaji",      "verified": true,      "followers_count": 1000000    }  ],  "next_cursor": "DAABCgABF..."}
{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}
{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}
{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}
{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}
{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}
{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

UnitPrice
Per call$0.0008
Per 1,000 calls$0.80
Per 1,000 records (~20 per call)~$0.04

Each page is one $0.0008 read, so a large verified-follower base still pages one call at a time. Stop at the sample you need.

When to use

Use it to filter followers to verified accounts, for example finding the Blue-verified accounts that follow a competitor.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

FAQ

Which accounts count as verified here?

Verified (Blue) accounts. The endpoint returns only the followers carrying a verified badge, filtering out the rest of the follower base.

Why use this over User Followers?

It narrows a large follower base to higher-signal verified accounts in fewer rows, so you spend less paging to reach the accounts you care about.

How does paging stop?

Stop when the users array comes back empty. The follower graph cursor stays non-null even on the last page.