Twitter/X scraper API
The Twitter/X scraper API for public profiles, tweets, replies, followers and search, as JSON. No X developer account and no paid access tier.
15 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/twitter/profile?handle=example_dev" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Twitter/X data can you get?
Public Twitter/X data only, returned in the same JSON envelope as every other platform.
Profiles
Bio, follower, following and tweet counts, and verification for any public account.
Tweets and replies
An account's timeline and media, one tweet in full, its replies, and the accounts that retweeted it.
Followers and communities
Follower and following lists, and the tweets inside an X Community.
Search
Tweets and accounts by keyword, plus the spoken text of video tweets.
Twitter/X API endpoints
All 15 Twitter/X endpoints and their price in credits. 1 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /profile | 10 | Returns an X (Twitter) account's public profile: follower count, following count, tweet count, bio, profile and banner image URLs, and verification status. |
| /user/tweets | 10 | Returns an account's most recent tweets in descending order, with full text, like, retweet, reply, bookmark and view counts, media, and creation time. |
| /tweet | 10 | Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp. |
| /community | 10 | Returns an X (Twitter) community's details: name, description, member count, rules, and creation date. |
| /community/tweets | 10 | Returns recent tweets posted inside an X (Twitter) community, each with its text, engagement counts, and author info. |
| /tweet/transcript | 100 | Returns the transcript of a video attached to a tweet, including auto-generated captions. |
| /ai-search | 50 | Returns a written answer to a plain-English question about X (Twitter), the X posts cited as sources, and how many searches the model ran. |
| /search/tweets | 10–50 | Returns tweets matching a keyword or phrase, each with the full text, like, retweet, reply, bookmark and view counts, media attachments, author info, and creation time. |
| /tweet/replies | 10 | Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. |
| /user/media | 10 | Returns the tweets on an account's Media tab, only those carrying a photo or video, with media URLs, engagement counts, and creation time. |
| /user/followers | 10 | Returns the accounts following an X (Twitter) user, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. |
| /user/following | 10 | Returns the accounts an X (Twitter) user follows, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. |
| /tweet/retweeters | 10 | Returns the accounts that retweeted a tweet, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. |
| /search/users | 10 | Returns X (Twitter) accounts matching a name, handle or keyword, with handle, display name, bio, avatar, follower, following and tweet counts, location, verification, join date, and a private flag. |
| /profile/full | 50 | Returns an X account's profile and its recent tweets in one call. |
Parameters, response fields and examples for each endpoint are in the Twitter/X API reference.
InsightSocial vs the official Twitter/X API
The official X API needs a developer account and bills every read from prepaid credits: $0.005 a post and $0.010 a user, with no free tier (docs.x.com, checked 2026-10-05).
| InsightSocial API | Official Twitter/X API | |
|---|---|---|
| Setup | Sign in and copy a key | Developer account, project and app |
| Reading tweets | Every endpoint on one balance | Pay-per-use credits; no free tier |
| Cost | A published price per endpoint, failures free | Per post and per user read, capped at 3 million post reads a month |
| Replies to a tweet | Page by page | Through search, billed per post read |
| Cost per call | 10 credits | Pay-per-use: $0.005 per post read, $0.010 per user read |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Twitter/X API cost?
Twitter/X calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 profiles at 10 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Retries are free
Resend a request with the same Idempotency-Key and the replay costs 0. Repeating a call without one is charged like the first time, because it can return newer data.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Twitter/X data in plain English. Same account, same credits.
Twitter/X API: frequently asked questions
For reading public data, yes. You get profiles, tweets, replies, followers, communities and search without an X developer account or prepaid X credits. It does not post, like or send messages: it is read-only.
/v1/twitter/tweet/replies returns replies page by page with a cursor. X decides how many replies it shows for a thread, so very long threads can end before the last reply.
Yes. /v1/twitter/search/tweets returns tweets matching a query, and /v1/twitter/search/users finds accounts.
A profile is 10 credits, and so is a page of a user's tweets or of a tweet's replies. Only tweet search is metered: it quotes 10 to 50 credits and charges what the page read. There is no monthly minimum, and calls that fail or find nothing are free.
No. There is no Twitter/X app, OAuth flow or review. One API key in the x-api-key header works for Twitter/X and the other 24 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. An answer served from the shared cache costs 2 credits. Repeating a call is charged like the first time, because it can return newer data.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Twitter/X's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
The same key works for 24 more platforms
- Instagram scraper API
- TikTok scraper API
- Facebook scraper API
- LinkedIn scraper API
- YouTube scraper API
- Reddit scraper API
- Threads scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API