Twitter/X scraper API

Public X profiles, tweets, replies, followers, communities and search as JSON. No X developer account and no paid access tier.

15 endpoints · from 20 credits a call · 10 free calls · no credit card

curl "https://api.insightsocial.app/v1/twitter/profile?handle=nasa" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/profile",
"data": {
"author": {
"username": "NASA",
}
},
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

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. 3 are metered: they show a range and charge what the call actually read.

EndpointCreditsWhat it returns
/profile20Returns an X (Twitter) account's public profile: follower count, following count, tweet count, bio, profile and banner image URLs, and verification status.
/user/tweets20–100Returns an account's most recent tweets in descending order, with full text, like, retweet, reply, bookmark and view counts, media, and creation time.
/tweet20Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp.
/community20Returns an X (Twitter) community's details: name, description, member count, rules, and creation date.
/community/tweets20Returns recent tweets posted inside an X (Twitter) community, each with its text, engagement counts, and author info.
/tweet/transcript200Returns the transcript of a video attached to a tweet, including auto-generated captions.
/ai-search100Returns 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/tweets20–180Returns 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/replies20–100Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time.
/user/media20Returns the tweets on an account's Media tab, only those carrying a photo or video, with media URLs, engagement counts, and creation time.
/user/followers20Returns the accounts following an X (Twitter) user, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.
/user/following20Returns the accounts an X (Twitter) user follows, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.
/tweet/retweeters20Returns the accounts that retweeted a tweet, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.
/search/users20Returns 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/full100Returns an X account's profile, its recent tweets, and computed metrics in one call: engagement rate by views and by followers, posting cadence, top post, and format mix.

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 reading tweets at any real volume means a paid access tier.

InsightSocial APIOfficial Twitter/X API
SetupSign in and copy a keyDeveloper account, project and app
Reading tweetsEvery endpoint on one balancePaid tiers; the free tier is mostly for posting
CostA published price per endpoint, failures freeTiered plans that X has changed several times
Replies to a tweetPage by pageNeeds search access on a paid tier

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

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats are free

    Call the same thing again inside its window, 1 to 24 hours depending on the endpoint, and it costs 0.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

The free Twitter/X scraper for Chrome exports the same data to Excel, CSV or Google Sheets from your browser, on the same account.

Twitter/X scraper for Chrome

Twitter/X API: frequently asked questions

For reading public data, yes. You get profiles, tweets, replies, followers, communities and search without a developer account or a monthly tier. It does not post, like or send messages: it is read-only.