Twitter/X
15 Twitter/X endpoints on one API key.
Profiles, tweets, replies, retweeters, media, followers and following, communities and search on Twitter/X.
Base path: /v1/twitter/...
Quickstart
curl "https://api.insightsocial.app/v1/twitter/profile?handle=elonmusk" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
3 of these are metered: the price depends on how much the call reads. See Credits.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/profile | 20 | 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 | 20–100 | 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 | 20 | Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp. | url |
/community | 20 | Returns an X (Twitter) community's details: name, description, member count, rules, and creation date. | url |
/community/tweets | 20 | Returns recent tweets posted inside an X (Twitter) community, each with its text, engagement counts, and author info. | url |
/tweet/transcript | 200 | Returns the transcript of a video attached to a tweet, including auto-generated captions. | url |
/ai-search | 100 | 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. | query |
/search/tweets | 20–180 | 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 | 20–100 | Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. | url |
/user/media | 20 | 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 | 20 | 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 | 20 | 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 | 20 | 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 | 20 | 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 | 100 | Returns 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. | handle |