YepAPI
POST/v1/twitter/user-followers

Twitter Followers API

List the followers of any X (Twitter) account with full profiles. $0.01 per call.

Get the follower list of any public X (Twitter) account by username or user id. Each follower comes back as a full profile with bio, location, follower and following counts, tweet count, verification, and avatar, with cursor pagination to walk the list.

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/twitter/user-followers

NASA, @NASA, or an x.com / twitter.com profile URL. Or leave empty and use User ID.

Numeric X user id. Used when Username is empty.

Page size hint, 1 to 100. A page may hold a few more or fewer.

Pass the cursor from the previous response to get the next page.

Response
Example response — hit "Send Request" to see a live result
{
  "ok": true,
  "data": {
    "cursor": "1880524837318699245|2116337016386879417",
    "users": [
      {
        "avatar": "https://pbs.twimg.com/profile_images/1697749409851985920/HbrI04tM_400x400.jpg",
        "banner": "https://pbs.twimg.com/profile_banners/34743251/1681251194",
        "created_at": "2009-04-23T21:53:30+00:00",
        "description": "SpaceX designs, manufactures and launches the world’s most advanced rockets and spacecraft",
        "followers_count": 41941885,
        "following_count": 127,
        "id": "34743251",
        "is_blue_verified": true,
        "likes_count": 529,
        "listed_count": 45956,
        "location": "Earth",
        "media_count": 4751,
        "name": "SpaceX",
        "pinned_tweet_ids": [],
        "protected": false,
        "tweet_count": 11912,
        "url": "https://x.com/SpaceX",
        "username": "SpaceX",
        "verified": false,
        "verified_type": "Business",
        "website": "http://spacex.com"
      }
    ]
  }
}

Features

✓
Full profiles, not just ids

Each follower is a complete User object with counts, bio, location, website, and verification.

✓
Walk the whole list

Pass the cursor back page after page; count sets the page size (up to 100).

✓
Username or user id

Accepts NASA, @NASA, a profile URL, or a numeric user_id.

✓
Cached for 1 hour

Follower pages are cached for an hour.

Use cases

Audience Analysis

Profile who follows an account: locations, sizes, and bios.

Influencer Discovery

Find large or verified accounts inside a competitor's audience.

Lead Generation

Build prospect lists from the followers of niche accounts.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/twitter/user-followers', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "username": "NASA",
    "count": 20
  }),
});
const data = await res.json();
console.log(data);

The Twitter Followers API: an X follower scraper with full profiles

The YepAPI Twitter Followers API lists the followers of any public X account. Send a username to /v1/twitter/user-followers and get back followers as full profiles with bio, location, counts, and verification, plus a cursor for the next page, at $0.01 per call.

Because every follower arrives with their own counts and bio, you can analyze an audience without a second lookup per account.

What is a Twitter followers API?

A Twitter followers API returns the accounts that follow a given X user. YepAPI's version returns each follower as a User object (id, username, name, description, location, website, created_at, avatar, followers_count, following_count, tweet_count, verification, and more), so it doubles as a Twitter follower scraper that enriches as it goes.

Build audience analysis

Page through /v1/twitter/user-followers for an account, then group followers by location, bucket them by followers_count, and pull out verified accounts. Run it on competitors to find influencers inside their audience, and use the Twitter Following API to see who an account follows in return.

Twitter Followers API pricing: $0.01 per call

Every call costs a flat $0.01 and failed calls are free. There is no monthly tier to buy, no developer account to get approved, and no separate Twitter API key: one YepAPI key covers every endpoint. One page (around 20 followers by default, up to about 100 with count) is one call. Pages are cached for an hour.

Ordering and limits

Followers come back in the order X lists them. Very large accounts have millions of followers; plan how many pages you need before walking the whole list.

Try the Twitter Followers API free

Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Twitter Followers API on live X data before you spend anything. Profiles, timelines, and search are on the same key.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”

Marcus T.

SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”

Priya S.

Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”

Jake R.

Indie Hacker

Frequently asked questions

Get the follower list of any public X (Twitter) account by username or user id. Each follower comes back as a full profile with bio, location, follower and following counts, tweet count, verification, and avatar, with cursor pagination to walk the list.

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/twitter/user-followers. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.

Ready to integrate?

Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.

More Twitter / X API endpoints