Twitter followers API

A Twitter followers API that returns the list, not just the count.

Read who follows a public X (Twitter) account, and who it follows, as JSON profiles with follower counts, bios and verification. One call per page, no X developer app, and you pay per profile returned.

Start free Read the quickstart

5,000 free credits every month · no card needed

How do I get a list of Twitter followers through an API?

There are two routes. X's official API has follower endpoints (GET /2/users/:id/followers) on pay-per-use pricing, at $0.010 per user read, and needs a developer app. A data API returns the same public list without one: on Weir, GET /v1/x/users/{user}/followers returns about 70 profiles a page with a cursor for the next, at 1 credit per profile. Two limits apply on every route: a protected account's followers cannot be read, and X rate-limits follower lists harder than search.

Updated November 2026.

Why follower lists are hard to get

A profile shows the follower count, not the list. X's website shows the list only to signed-in visitors and loads it a screen at a time. The official endpoints return it, at $0.010 for each user read, so the first 100,000 followers of one account cost $1,000. Scripts that read the website instead sign in with a real account's cookies, and that account can be locked.

Source: X API pricing, docs.x.com (checked November 2026).

Full profiles, not ids

Each follower comes back as a profile: id, username, name, description, followersCount, followingCount, statusesCount, verified and createdAt. There is no second call to turn ids into people.

Followers and following

Two endpoints with the same shape: /followers for who follows the account, /following for who it follows. Compare the two lists to find mutuals.

Pages you can resume

X chooses the page size, about 70. Each page carries meta.nextCursor, which is null after the last page. If X is busy and a call is refused, wait for the Retry-After header and carry on from the same cursor.

Pay per profile

1 credit for each account returned and 1 per call, plus 2 on the first page to look up the account you asked about. A call that fails or is refused costs nothing, and 5,000 credits are free every month.

The first page of an account's followers, then the next page

curl "https://api.weirapp.io/v1/x/users/XDevelopers/followers" \
  -H "Authorization: Bearer $WEIR_KEY"
# The response ends with "meta": {"nextCursor": "..."}. Pass it back unchanged:
curl "https://api.weirapp.io/v1/x/users/XDevelopers/followers?cursor=PASTE_NEXT_CURSOR" \
  -H "Authorization: Bearer $WEIR_KEY"

Every endpoint and its parameters are in the docs.

What it costs

Result	Credits	Per 1,000 results
X post	1	$0.10–$0.20
X profile	2	$0.20–$0.40
X follower / user in a list	1	$0.10–$0.20
Reddit post or comment	3	$0.30–$0.60

Plus one credit per request. 5,000 credits free every month; prepaid packs from $5 that never expire; failed calls are free. Full pricing

Questions

Can I export a Twitter account's followers to CSV?

Yes. Page through the endpoint until meta.nextCursor is null and write each profile as a row. The guide on exporting Twitter followers to CSV has a short Python script that does it and stops at a page cap you choose.

In what order do followers come back?

In the order X lists them: mostly the most recent followers first, though X can place some accounts out of that order. The API does not sort or filter the list.

Can I read a private account's followers?

No. A protected account's followers and following are visible only to accounts it approved, so the endpoint returns 404 for it, at no charge. It also returns 404 for an account that does not exist or is suspended.

How many followers can I fetch?

There is no limit on Weir's side, but X rate-limits follower lists more tightly than search, so a very long list takes time: expect some calls to be refused with a Retry-After header, wait, then continue from the same cursor. For a count only, read followersCount on the profile, which costs 2 credits.

How fresh is the list?

Follower and following pages are cached for up to 30 minutes. A follow or unfollow can take that long to show.

What does it cost?

1,000 followers cost about 1,020 credits: 1 per profile, 1 per call, and 2 for the first lookup. That is about $0.10 to $0.20, depending on the pack. X's official API charges $10 for the same 1,000.

Guides

Start free