Twitter User Followers API

Endpoint

GET /v1/twitter/user/followers

Parameters

username *

Twitter username (without @, max 50 characters)

pages

Number of pages to fetch, 1-10 (default: 1)

Response fields

followers

Array of follower profiles

username

Follower's Twitter username

name

Display name

user_id

Twitter user ID

description

Bio / profile description

followers_count

Number of followers they have

following_count

Number of accounts they follow

tweet_count

Total tweets posted

verified

Whether they are verified

profile_image_url

URL to profile image

created_at

Account creation date

url

Link to their profile

username

Requested username

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/twitter/user/followers?username=elonmusk&pages=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/twitter/user/followers",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "elonmusk", "pages": 1}
)
print(response.json())

Example Response

{
  "followers": [
    {
      "username": "user123",
      "name": "Example User",
      "user_id": "123456789",
      "description": "Tech enthusiast",
      "followers_count": 5000,
      "following_count": 200,
      "tweet_count": 1500,
      "verified": false,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "created_at": "2020-01-15 10:30:00",
      "url": "https://twitter.com/user123"
    }
  ],
  "username": "elonmusk",
  "pages": 1,
  "count": 20
}

Frequently asked questions

How many followers are returned per page?

Each page returns approximately 20 follower profiles. You can fetch up to 10 pages (200 followers) in a single API call.

Are followers returned in any particular order?

Followers are returned in reverse chronological order (most recent followers first).

How does pricing work?

You only pay for successful requests. The Twitter User Followers API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.