InsightSocial APITwitter/X
Twitter/X API reference: 15 endpoints for profiles, tweets, replies, followers, communities and search. Per-endpoint credit prices and cURL examples.
Profiles, tweets, replies, retweeters, media, followers and following, communities and search on Twitter/X.
New to the API? Read the Twitter/X scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/twitter/...
Quickstart
curl "https://api.insightsocial.app/v1/twitter/profile?handle=elonmusk" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
1 of these are metered: the price depends on how much the call reads. See Credits.
2 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/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. | handle |
/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. | handle |
/tweet | 10 | Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp. | url |
/community | 10 | Returns an X (Twitter) community's details: name, description, member count, rules, and creation date. | url |
/community/tweets | 10 | Returns recent tweets posted inside an X (Twitter) community, each with its text, engagement counts, and author info. | url |
/tweet/transcript | 100 | Returns the transcript of a video attached to a tweet, including auto-generated captions. | url |
/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. Beta. | query |
/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. | query |
/tweet/replies | 10 | Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. | url |
/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. | handle |
/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. | handle |
/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. | handle |
/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. | url |
/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. | query |
/profile/full | 50 | Returns an X account's profile and its recent tweets in one call. Beta. | handle |