Skip to content

Twitter followers API

List the followers and following of any public X account, search them by keyword, and audit how many look real. Each profile comes back as JSON with its bio, counts and link.

Export followers now, no signupThen call the same data from code.

The job

Follower data answers who follows a competitor, who follows you that you do not follow back, and how much of an audience is real. The calls page through a public account's followers and following, and search within them.

Need a follower count rather than a list? The profile call returns the follower and following counts, so a Twitter follower count API is one request, and calling it daily gives you a follower tracker. It is read-only: follows, likes and other actions are separate tools that run from an account you connect, not from this data.

How it works

  1. List followers

    Call x.followers with a username and page through the results.

  2. List who they follow

    Call x.following with a username.

  3. Search followers

    Call x.follower_search to find followers whose bio matches a keyword.

  4. Audit quality

    Call x.follower_audit to see how many followers look real.

Endpoints that do it

EndpointWhat it's forCredits
List followersGET /v1/x/users/{handle}/followersAn account's followers.2 credits per page (20 rows by default)
List followingGET /v1/x/users/{handle}/followingThe accounts it follows.2 credits per page (20 rows by default)
Search followersGET /v1/x/users/{handle}/followers/searchFollowers matching a keyword.2 credits per page (20 rows by default)
Audit followersGET /v1/x/users/{handle}/follower-auditHow many followers look real.3 credits per call (up to 40 followers sampled)

Free tools for the same job

Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.

Listing followers

Call the followers endpoint with a username. Each follower has a bio and counts.

curl "https://api.chatterapi.com/v1/x/users/levelsio/followers" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": [
    {
      "id": "197785542",
      "handle": "dannypostma",
      "name": "Danny Postma",
      "bio": "Founder of HeadshotPro, a Singapore-based AI photography company.",
      "followers": 187346,
      "following": 739,
      "tweets": 29627,
      "verified": false,
      "blueVerified": true,
      "canDm": true,
      "protected": null,
      "location": null,
      "url": null,
      "avatarUrl": "https://pbs.twimg.com/profile_images/1587046912490090496/kuBUqNkb_normal.jpg",
      "createdAt": "2010-10-02T13:11:54.000Z",
      "profileUrl": "https://x.com/dannypostma",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/197785542/1762514596",
      "likesGiven": null,
      "mediaCount": null,
      "pinnedTweetIds": null
    },
    {
      "id": "24179991",
      "handle": "dvassallo",
      "name": "Daniel Vassallo",
      "bio": "🚀 https://t.co/X5QMm3wlHe \n🏭 https://t.co/ZvHZp55zso \n🕹️ https://t.co/vHWIhHxTv6",
      "followers": 205470,
      "following": 2449,
      "tweets": 55084,
      "verified": false,
      "blueVerified": true,
      "canDm": false,
      "protected": null,
      "location": "WA, USA",
      "url": null,
      "avatarUrl": "https://pbs.twimg.com/profile_images/2008284492210085888/-aEKwo9U_normal.jpg",
      "createdAt": "2009-03-13T14:34:10.000Z",
      "profileUrl": "https://x.com/dvassallo",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/24179991/1604969845",
      "likesGiven": null,
      "mediaCount": null,
      "pinnedTweetIds": null
    }
  ],
  "page": {
    "nextCursor": "AcPt…",
    "hasMore": true
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits per page (20 rows by default) for this call. A test key returns this same sample for 0 credits.

What it won't do

  • It is read-only. It cannot follow or unfollow accounts.
  • Private accounts do not return their followers.
  • X's rules apply to what you do with the data.

Questions

Is there a Twitter follower count API?
Yes. The user profile call returns the follower and following counts for any public handle. Store the number each day to chart growth, or use the free account analytics tool.
How do I get all followers of an account?
Call x.followers and keep passing the cursor until the response has no more pages. How far back the list goes is whatever X returns. The free follower exporter does it in the browser.
How do I download a Twitter following list for free?
Use the free following exporter: enter a handle and download the accounts it follows. From code, call x.following.
Can I monitor Twitter followers or build a follower tracker app?
Yes, by polling. Call the followers or profile endpoint on a schedule and compare it with the last run to see new followers and changes in the count. There is no streaming or push alert.
Can I export a competitor's followers?
Yes, for public accounts. Use the free follower exporter or call the followers endpoint.
Can I find followers by keyword?
Yes. Follower search matches bios, so you can find, for example, founders among an account's followers.
Does this need an X developer account?
No. You use one key from here. See the X API key guide.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.