twit.sh
activeX/Twitter Data API
Payment-gated Twitter/X user and tweet lookup API. Pay per request in USDC on Base via x402.
Settled via Coinbase, OpenFacilitator, Dexter.
- Transactions · 30d
- 14.9K
- Volume · 30d
- $88.00
- Unique buyers · 30d
- 93
- Uptime · 30d
- 85.7%
- Latency p50
- 120ms
- Reported calls · 30d
- 9,202
Endpoints (36 live)
GET/workflows/userInsights(0.5 USDC on Base)GET/lists/by/id— Fetches X/Twitter list details by list ID. (0.0025 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/following— Get the list of Twitter/X users that a specific user follows. Returns up to 50 following 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/following?id=44196397. 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/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)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)GET/tweets/replies— Fetches replies for a tweet on X/Twitter. (0.01 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— Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON. (0.01 USDC on Base)GET/articles/by/id— Retrieve the full content of an X Article by the tweet ID of the post that hosts it. Returns article title, preview text, cover image, publish date, and full article_content as Markdown (headings, bold, italic, lists, images). Not available in the official X API. Query param: id (string, required) - numeric tweet ID of the article post, e.g. GET /articles/by/id?id=2010751592346030461. (0.01 USDC on Base)GET/users/search— Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON. (0.01 USDC on Base)GET/lists/tweets— Get the latest tweets from a Twitter/X List by its numeric List ID. Returns ~100 tweets per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/tweets?id=84839422. Returns X v2 API-compatible JSON. (0.01 USDC on Base)GET/tweets/user— Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON. (0.01 USDC 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/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/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. (0.006 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)POST/tweets/mediaUpload— Uploads an image to Twitter/X for the authenticated user and returns a media_id to attach to a tweet. Send the file as multipart/form-data field "file" (e.g. -F "file=@photo.jpeg"); pass auth_token and ct0 as query params. Returns media_id, media_id_string, media_key, size, expires_after_secs, and image metadata. (0.006 USDC on Base)GET/lists/members— Get the members of a Twitter/X List by its numeric List ID. Returns up to 100 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/members?id=84839422. Returns X v2 API-compatible JSON. (0.01 USDC on Base)
+16 more endpoints.
First seen · last seen · last active