twit.sh

Endpoints (30 live)

• GET /tweets/replies (0.01 USDC on Base)
• GET /tweets/search — Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON. (6000 on Base)
• GET /users/by/username — Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON. (0.005 USDC on Base)
• GET /tweets/user — Fetches tweets from a specific user account. (0.01 USDC on Base)
• GET /users/following (0.01 USDC on Base)
• GET /users/search — Search for users on Twit by username or query. (0.01 USDC on Base)
• POST /tweets/retweet — Causes the authenticated user to repost a specific Post by its ID. Query params: id (string, required) - numeric tweet ID to retweet; auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie. Returns { retweeted: true } on success. (0.0075 USDC on Base)
• POST /tweets/bookmark — Adds a Post to the authenticated user's Bookmarks by its ID. Query params: id (string, required) - numeric tweet ID to bookmark; auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie. Returns { bookmarked: true } on success. (0.0025 USDC on Base)
• GET /lists/followers — Retrieves a list of Users who follow a specific Twitter/X List by its ID. Returns up to 20 user profiles per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/followers?id=84839422. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
• POST /users/following — Causes the authenticated user to follow a specific user by their ID or username. Query params: id (string, optional) - numeric user ID to follow; username (string, optional) - screen name to follow (one of id/username required); auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie. Returns { following: true } on success. (0.0075 USDC on Base)
• GET /tweets/by/id — Look up a single Twitter/X tweet by its numeric tweet ID. Returns full tweet data including text, author profile, creation date, engagement metrics (likes, retweets, replies, quotes, bookmarks), and referenced tweets. Query param: id (string, required) - numeric tweet ID, e.g. GET /tweets/by/id?id=1110302988. Returns X v2 API-compatible JSON. (0.0025 USDC on Base)
• GET /lists/by/id — Retrieve details of a specific Twitter/X List by its numeric ID. Returns name, description, mode, member count, subscriber count, creation date, banner image, and owner profile. Query param: id (string, required) - numeric List ID, e.g. GET /lists/by/id?id=84839422. Returns X v2 API-compatible JSON. (0.0025 USDC on Base)
• GET /tweets/retweeted_by — Get the list of Twitter/X users who reposted a specific tweet. Returns paginated user profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/retweeted_by?id=1110302988. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
• POST /tweets/like — Causes the authenticated user to Like a specific Post by its ID. Query params: id (string, required) - numeric tweet ID to like; auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie. Returns { liked: true } on success. (0.0075 USDC on Base)
• GET /users — Bulk look up multiple Twitter/X user profiles by their numeric user IDs in a single request. Returns an array of full user profiles. Query param: ids (string, required) - comma-separated numeric Twitter user IDs, max 50, e.g. GET /users?ids=44196397,12,783214. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
• POST /tweets/long — Creates a long-form Post (Note Tweet) for the authenticated user, supporting text beyond 280 characters. Requires Twitter/X session cookies (auth_token, ct0). Body params: text (required) - content, can exceed 280 chars; auth_token (required); ct0 (required); in_reply_to_tweet_id (optional) - tweet ID to reply to; quote_tweet_id (optional) - tweet ID to quote; medias (optional) - comma-separated media IDs. Returns the created tweet id and text. (0.0025 USDC on Base)
• GET /users/followers — Get the list of Twitter/X users who follow a specific user. Returns up to 50 follower profiles per page with pagination support. Query params: id (string, required) - numeric Twitter user ID; next_token (string, optional) - pagination cursor, e.g. GET /users/followers?id=44196397. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
• GET /tweets/quote_tweets — Get a list of tweets that quote a specific tweet. Returns paginated quote tweets with author profiles for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/quote_tweets?id=1110302988. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
• GET /users/by/id — Look up a single Twitter/X user profile by their numeric user ID. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, and verification status. Query param: id (string, required) - numeric Twitter user ID, e.g. GET /users/by/id?id=44196397. Returns X v2 API-compatible JSON. (0.005 USDC on Base)
• GET /tweets/mentions — Get the latest tweets that mention the authenticated user (the notifications timeline). Returns up to 20 tweets per page, most recent first, with pagination support. Query params: auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie; type (string, optional) - notifications timeline to read: All (default), Priority, or Mentions; next_token (string, optional) - pagination cursor. Returns X v2 API-compatible JSON. (0.006 USDC on Base)

+10 more endpoints.