x402.twit.sh

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.

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.

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.

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.

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.

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.

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.

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.

Look up a Twitter/X user profile by their screen name (username). Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, profile image URL, and pinned tweet id. Use this when you know the username (e.g. "vitalik", "elonmusk"). Path param: username (string, required) - the Twitter screen name, e.g. GET /users/by/username/vitalik. Returns X v2 API-compatible JSON.

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, verification status, profile image URL, and pinned tweet id. Use this when you know the user ID. Path param: id (string, required) - numeric Twitter user ID, e.g. GET /users/44196397. Returns X v2 API-compatible JSON.

Get the list of Twitter/X users that a specific user follows, identified by their numeric user ID. Returns up to 50 following profiles per page with pagination support. Each account includes full profile data. Path param: id (string, required) - numeric Twitter user ID, e.g. GET /users/44196397/following. Query param: next_token (string, optional) - pagination cursor from previous response. Returns X v2 API-compatible JSON.

Get the list of Twitter/X users who follow a specific user, identified by their numeric user ID. Returns up to 50 follower profiles per page with pagination support. Each follower includes full profile data. Path param: id (string, required) - numeric Twitter user ID, e.g. GET /users/44196397/followers. Query param: next_token (string, optional) - pagination cursor from previous response. Returns X v2 API-compatible JSON.

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), entities (hashtags, mentions, URLs), and referenced tweets (replies, quotes, retweets). Path param: id (string, required) - numeric tweet ID, e.g. GET /tweets/1110302988. Returns X v2 API-compatible JSON.