Twitter User Profile API

Endpoint

GET /v1/twitter/user

Parameters

username *

Twitter username (without @, max 50 characters)

Response fields

user

User profile data object

username

Twitter username

name

Display name

user_id

Twitter user ID (rest_id)

description

Bio / profile description

url

Link to the profile

followers_count

Number of followers

following_count

Number of accounts followed

tweet_count

Total tweets posted

favourites_count

Total tweets liked

listed_count

Number of lists the user is on

media_count

Number of media posts

verified

Whether the user is verified

protected

Whether the account is private

profile_image_url

URL to profile image (400x400)

profile_banner_url

URL to profile banner

created_at

Account creation date

pinned_tweet_ids

IDs of pinned tweets

account_based_in

Country the account is based in

username_changes

Number of username changes

Example Request

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

import requests

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

Example Response

{
  "user": {
    "username": "elonmusk",
    "name": "Elon Musk",
    "user_id": "44196397",
    "description": "",
    "url": "https://twitter.com/elonmusk",
    "followers_count": 235918920,
    "following_count": 1292,
    "tweet_count": 98359,
    "favourites_count": 214306,
    "listed_count": 167743,
    "media_count": 4372,
    "verified": true,
    "protected": false,
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo_400x400.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/...",
    "created_at": "2009-06-02 20:12:29",
    "pinned_tweet_ids": ["2028500984977330453"],
    "account_based_in": "United States",
    "username_changes": 0
  }
}

Frequently asked questions

What profile data is included?

You get the full public profile: username, display name, bio, follower/following counts, tweet count, verification status, profile images, account creation date, and more.

Can I get data for private accounts?

You can get basic profile data (username, name, bio, follower counts) for private accounts, but their tweets and followers are not accessible.

What is account_based_in?

This is the country where Twitter identifies the account as being based, shown on the account's About page.

How does pricing work?

You only pay for successful requests. The Twitter User Profile API costs $0.006 per request. 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.