YepAPI
POST/v1/twitter/user

Twitter User API (X Profile API)

Get any X (Twitter) profile by username: followers, following, tweets, bio, and verification. $0.01 per call.

Look up an X (Twitter) account by username and get its profile: id, name, bio, location, website, join date, avatar, banner, follower, following, tweet, like, media, and listed counts, blue and legacy verification, verification type, protected status, and pinned tweet ids.

Try it live

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

POST/v1/twitter/user

NASA, @NASA, or an x.com / twitter.com profile URL.

Response
Example response — hit "Send Request" to see a live result
{
  "ok": true,
  "data": {
    "avatar": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
    "banner": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
    "created_at": "2007-12-19T20:20:32+00:00",
    "description": "Making the seemingly impossible, possible. ✨",
    "followers_count": 92298682,
    "following_count": 115,
    "id": "11348282",
    "is_blue_verified": true,
    "likes_count": 17049,
    "listed_count": 96844,
    "location": "Pale Blue Dot",
    "media_count": 28221,
    "name": "NASA",
    "pinned_tweet_ids": [
      "2116263878807998722"
    ],
    "protected": false,
    "tweet_count": 74477,
    "url": "https://x.com/NASA",
    "username": "NASA",
    "verified": false,
    "verified_type": "Government",
    "website": "http://www.nasa.gov/"
  }
}

Features

✓
Full public profile

id, username, name, description, location, website, created_at, avatar, banner, and profile url.

✓
All the counts

followers_count, following_count, tweet_count, likes_count, media_count, and listed_count.

✓
Verification details

is_blue_verified, verified, verified_type (for example Government or Business), and protected.

✓
Flexible input

Accepts NASA, @NASA, or an x.com or twitter.com profile URL.

✓
Cached for 1 hour

Profiles are cached for an hour. Missing or suspended accounts return a free 404.

Use cases

Influencer Vetting

Check follower counts and verification before a partnership.

CRM Enrichment

Add X profile data to leads and contacts.

Account Tracking

Record follower growth for accounts you care about.

Quick start

Copy this snippet and start making calls.

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

The Twitter User API (X Profile API) for public profiles

The YepAPI Twitter User API returns any public X profile. Send a username to /v1/twitter/user and get the account id, name, bio, location, website, join date, avatar, banner, follower and following counts, tweet count, and verification details, at $0.01 per call.

It is the call to make first: it resolves a handle to the numeric user id that timelines and follower lists use, and tells you whether the account is worth a closer look.

What does the X profile API return?

A User object with id, username, name, description, location, website, created_at, avatar, banner, url, followers_count, following_count, tweet_count, likes_count, media_count, listed_count, is_blue_verified, verified, verified_type, protected, and pinned_tweet_ids. Every Twitter endpoint on YepAPI uses this same User shape.

Build influencer and lead enrichment

Call /v1/twitter/user for each handle in your list, store follower counts over time, and flag verified or government accounts. Then pull recent tweets with the Tweet Scraper API or follower lists with the Twitter Followers API, all on the same key.

Twitter User 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. Profiles are cached for an hour, and a 404 for a missing or suspended account costs nothing.

Look up many accounts at once

If you already have numeric user ids, the Twitter Bulk Users API returns up to 100 profiles in one call for the same $0.01.

Try the Twitter User 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 User API on live X data before you spend anything. The same key covers timelines, followers, search, and trends.

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

Look up an X (Twitter) account by username and get its profile: id, name, bio, location, website, join date, avatar, banner, follower, following, tweet, like, media, and listed counts, blue and legacy verification, verification type, protected status, and pinned tweet ids.

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. 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