Twitter Bulk Users API
Look up to 100 X (Twitter) profiles by user id in a single call. $0.01 per call.
Fetch up to 100 X (Twitter) user profiles in one request by numeric user id. Each profile includes name, bio, location, website, follower, following, and tweet counts, verification, and avatar. Pass ids as an array or a comma-separated string.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"users": [
{
"avatar": "https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_400x400.jpg",
"banner": "https://pbs.twimg.com/profile_banners/44196397/1774145451",
"created_at": "2009-06-02T20:12:29+00:00",
"description": "https://t.co/ZdBx5WABYx",
"followers_count": 241500263,
"following_count": 1422,
"id": "44196397",
"is_blue_verified": true,
"likes_count": 256477,
"listed_count": 171203,
"location": null,
"media_count": 4752,
"name": "Elon Musk",
"pinned_tweet_ids": [
"2116039632743702637"
],
"protected": false,
"tweet_count": 111332,
"url": "https://x.com/elonmusk",
"username": "elonmusk",
"verified": false,
"verified_type": null,
"website": null
}
]
}
}Features
One request, one $0.01 charge, up to 100 full User objects.
user_ids accepts ["44196397", "11348282"] or "44196397,11348282".
Identical fields to the Twitter User API: counts, bio, verification, avatar, banner, and pinned tweet ids.
Profiles are cached for an hour.
Use cases
Refreshing Stored Profiles
Update follower counts for a large list of accounts cheaply.
Hydrating Ids
Turn user ids from follower lists or datasets into full profiles.
Audience Analysis
Profile a sample of followers in a handful of calls.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/twitter/users', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"user_ids": [
"44196397",
"11348282"
]
}),
});
const data = await res.json();
console.log(data);The Twitter Bulk Users API for profile lookups at scale
The YepAPI Twitter Bulk Users API returns up to 100 X profiles per request. Send numeric user ids to /v1/twitter/users and get back full User objects with counts, bio, verification, and avatar, all for a single $0.01 call.
It is the cheapest way to keep a large list of accounts up to date: 10,000 profiles costs $1.
What does the Twitter Bulk Users API return?
A users array of User objects (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, pinned_tweet_ids).
Build a profile refresh job
Store user ids instead of handles (ids never change), then refresh them in batches of 100 with /v1/twitter/users. Use the Twitter User API to resolve a new handle to its id once, and this endpoint for everything after that.
Twitter Bulk Users 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. One call returns up to 100 profiles, so the effective price can be as low as $0.0001 per profile.
Input rules
user_ids takes between 1 and 100 numeric ids as a JSON array or a comma-separated string. Non-numeric values return a VALIDATION_ERROR and are not charged.
Try the Twitter Bulk Users 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 Bulk Users API on live X data before you spend anything. That is up to 50,000 profile lookups.
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.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Fetch up to 100 X (Twitter) user profiles in one request by numeric user id. Each profile includes name, bio, location, website, follower, following, and tweet counts, verification, and avatar. Pass ids as an array or a comma-separated string.
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/users. 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
Tweet Scraper API (User Tweets)
$0.01Get the latest tweets from any X (Twitter) account with full engagement metrics. A tweet scraper at $0.01 per call.
Twitter User Replies API
$0.01Get an X (Twitter) account's tweets and replies timeline with full metrics. $0.01 per call.
Twitter Media API
$0.01Get the photos and videos an X (Twitter) account has posted, with media URLs. $0.01 per call.
Twitter Followers API
$0.01List the followers of any X (Twitter) account with full profiles. $0.01 per call.
Twitter Following API
$0.01List the accounts any X (Twitter) user follows, with full profiles. $0.01 per call.
Twitter User API (X Profile API)
$0.01Get any X (Twitter) profile by username: followers, following, tweets, bio, and verification. $0.01 per call.