Twitter User Following API

Endpoint

GET /v1/twitter/user/following

Parameters

username *

Twitter username (without @, max 50 characters)

pages

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

Response fields

following

Array of followed user profiles

username

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/following?username=elonmusk&pages=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

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

Example Response

{
  "following": [
    {
      "username": "SpaceX",
      "name": "SpaceX",
      "user_id": "34743251",
      "description": "SpaceX designs, manufactures and launches...",
      "followers_count": 35000000,
      "following_count": 50,
      "tweet_count": 5000,
      "verified": true,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "created_at": "2009-04-23 19:30:00",
      "url": "https://twitter.com/SpaceX"
    }
  ],
  "username": "elonmusk",
  "pages": 1,
  "count": 20
}

Frequently asked questions

How many results are returned per page?

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

Can I see who a private account follows?

No, following lists are only available for public accounts.

How does pricing work?

You only pay for successful requests. The Twitter User Following 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.