Twitter Followers API | Export Account Followers

User Followers pages through every account that follows a user, returned as cursor-paginated full user objects. Use it to export or analyze a follower base. The follower graph keeps returning a non-null cursor even on the final page, so stop when the users array is empty. Each page is one $0.0008 read.

curl -X GET "https://example.com/user/followers?username=naval&user_id=44196397&count=20"

{  "users": [    {      "id": "9921",      "username": "devjane",      "name": "Jane",      "followers_count": 4200,      "verified": false    }  ],  "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

Each page is one $0.0008 read, so a 100,000-follower account costs roughly 5,000 calls. Budget large exports and stop at the depth you need.

When to use

Use it to export an account's followers, for example pulling a creator's full follower list to a CSV.

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.

Related endpoints

• User Following: Page through the accounts a user follows.
• User Info by Username: Fetch a full profile by @handle.
• Verified Followers: Page through only the verified accounts that follow a user.

FAQ

How do I know when I have read every follower?

Stop when the users array comes back empty. The follower graph returns a non-null cursor even on the last page, so the empty array is the only reliable stop.

What does a full follower export cost?

Each page is one $0.0008 read at about 20 users, so a 100,000-follower account is roughly 5,000 calls, about $4.

Is there a richer version?

Yes. User Followers v2 returns the same data with a more consistent cursor model and extra user fields. Prefer it for new builds.