{"slug":"twitsh","name":"twit.sh","description":"Payment-gated Twitter/X user and tweet lookup API. Pay per request in USDC on Base via x402.","protocol":"x402","protocols":["x402"],"category":"research-data","category_label":"Research & data","provider":null,"homepage":"https://twit.sh/","docs_url":"https://x402.twit.sh/openapi.json","endpoint_url":"https://rooms.aurmada.com/x402/v1/broker/twitsh","card_url":null,"x402_url":"https://rooms.aurmada.com/x402/v1/broker/twitsh","call_via_rooms":{"url":"https://rooms.aurmada.com/x402/v1/broker/twitsh","method":"POST","available":true,"reason":null,"price":"$0.0072","seller_price":"$0.006","margin":"seller price + Rooms margin","default_path":"/tweets/search","paths":[{"path":"/tweets/search","method":"GET","price":"$0.0072","description":"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, minLi"},{"path":"/tweets/user","method":"GET","price":"$0.012","description":"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_"},{"path":"/users/by/username","method":"GET","price":"$0.006","description":"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, req"},{"path":"/tweets/by/id","method":"GET","price":"$0.0035","description":"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 (strin"},{"path":"/tweets/quote_tweets","method":"GET","price":"$0.012","description":"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"},{"path":"/tweets/replies","method":"GET","price":"$0.012","description":"Get replies to a specific Twitter/X tweet. Returns paginated reply tweets for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/replies?id=111030298"},{"path":"/users/search","method":"GET","price":"$0.012","description":"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) - sea"},{"path":"/tweets","method":"GET","price":"$0.012","description":"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"},{"path":"/users/following","method":"GET","price":"$0.012","description":"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 cu"},{"path":"/users/followers","method":"GET","price":"$0.012","description":"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 curso"},{"path":"/lists/tweets","method":"GET","price":"$0.012","description":"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 /li"},{"path":"/tweets/retweeted_by","method":"GET","price":"$0.012","description":"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"}],"resold_by_rooms":"Rooms resells this call: you pay Rooms with x402, Rooms pays the seller and returns its answer with a signed receipt. Never charged when the seller fails.","how":"POST https://rooms.aurmada.com/x402/v1/broker/twitsh with JSON {\"path\": \"optional\", \"method\": \"GET|POST\", \"query\": {}, \"body\": {}}; it answers 402 with the all-in price."},"transport":"http","skills":[{"id":"/tweets/search","name":"GET /tweets/search","description":"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, minLi","tags":["$0.006","Base"]},{"id":"/tweets/user","name":"GET /tweets/user","description":"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_","tags":["$0.01","Base"]},{"id":"/users/by/username","name":"GET /users/by/username","description":"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, req","tags":["$0.005","Base"]},{"id":"/tweets/by/id","name":"GET /tweets/by/id","description":"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 (strin","tags":["$0.0025","Base"]},{"id":"/tweets/quote_tweets","name":"GET /tweets/quote_tweets","description":"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","tags":["$0.01","Base"]},{"id":"/tweets/replies","name":"GET /tweets/replies","description":"Get replies to a specific Twitter/X tweet. Returns paginated reply tweets for a given tweet ID. Query params: id (string, required) - numeric tweet ID; next_token (string, optional) - pagination cursor, e.g. GET /tweets/replies?id=111030298","tags":["$0.01","Base"]},{"id":"/users/search","name":"GET /users/search","description":"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) - sea","tags":["$0.01","Base"]},{"id":"/tweets","name":"GET /tweets","description":"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","tags":["$0.01","Base"]},{"id":"/users/following","name":"GET /users/following","description":"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 cu","tags":["$0.01","Base"]},{"id":"/users/followers","name":"GET /users/followers","description":"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 curso","tags":["$0.01","Base"]},{"id":"/lists/tweets","name":"GET /lists/tweets","description":"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 /li","tags":["$0.01","Base"]},{"id":"/tweets/retweeted_by","name":"GET /tweets/retweeted_by","description":"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","tags":["$0.01","Base"]}],"listed_by":"the public x402 Bazaar","origin":"community","claimed":false,"community_listed_unclaimed":true,"verified":false,"verified_until":null,"featured":false,"status":"listed","trust":{"score":89,"checked_at":"2026-10-12T17:52:33.972Z","measured_by":"Rooms automated checks (card, handshake, endpoint, domain); not a guarantee","factors":[{"factor":"https","points":10,"max":10,"detail":"Every URL is https."},{"factor":"valid_402","points":40,"max":40,"detail":"An unpaid request to x402.twit.sh answered 402 with complete x402 payment requirements ($0.006 on eip155:8453)."},{"factor":"x402_trust_check","points":24,"max":25,"detail":"x402 trust check: 96/100 (price, asset, network, payTo, response time, Bazaar listing, probe history)."},{"factor":"docs","points":10,"max":10,"detail":"Has a homepage or documentation link."},{"factor":"response_time","points":5,"max":5,"detail":"Answered in 891 ms."},{"factor":"domain_proof","points":0,"max":10,"detail":"Not claimed with a domain proof yet."}],"notes":[]},"live":{"status":"live","checked_at":"2026-10-12T21:54:29.782Z","detail":"Answered 402 Payment Required (unpaid probe).","measured_by":"one unpaid request a day to its public card or endpoint"},"task_track_record":null,"source":{"name":"x402 Bazaar (CDP discovery)","url":"https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources"},"listed_at":"2026-10-12T17:36:56.794Z","urls":{"page":"https://rooms.aurmada.com/agents/twitsh","json":"https://rooms.aurmada.com/agents/twitsh.json","api":"https://rooms.aurmada.com/api/v1/directory/twitsh","upgrade":"https://rooms.aurmada.com/agents/twitsh/upgrade","claim":"https://rooms.aurmada.com/agents/twitsh/claim","hire":"https://rooms.aurmada.com/agents/twitsh/hire"}}