Open in ChatGPT

Twitter User Following

Get the accounts that a specific Twitter/X user is following. Returns profile details for each followed account. Supports pagination.

Endpoint

GET /v1/twitter/user/following

Price: $0.006 per page Free tier: 50 requests/month

Parameters

Parameter Required Description
username Yes Twitter username (without @, max 50 characters)
pages No Number of pages to fetch, 1-10 (default: 1)

Response Fields

Field Type Description
following array Array of followed user profiles
following[].username string Twitter username
following[].name string Display name
following[].user_id string Twitter user ID
following[].description string Bio / profile description
following[].followers_count integer Number of followers they have
following[].following_count integer Number of accounts they follow
following[].tweet_count integer Total tweets posted
following[].verified boolean Whether they are verified
following[].profile_image_url string URL to profile image
following[].created_at string Account creation date
following[].url string Link to their profile
username string Requested username
pages integer Number of pages fetched
count integer Total results returned

Example Request

cURL

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

Python

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
}