{"version":1,"resources":["POST /api/tools/x_read","POST /api/tools/x_search","POST /api/tools/x_timeline","POST /api/tools/x_lists","POST /api/tools/x_communities","POST /api/tools/x_extract","POST /api/tools/x_monitor","POST /api/tools/draws","POST /api/tools/x_write","POST /api/tools/x_inbox","POST /api/tools/x_profile","POST /api/tools/x_community","POST /api/tools/radar","POST /api/tools/compose"],"openapi_url":"https://twitr.sh/openapi.json","resourceDetails":[{"path":"/api/tools/x_read","method":"POST","description":"Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"1.200000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_read/post/requestBody"},{"path":"/api/tools/x_search","method":"POST","description":"Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"1.200000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_search/post/requestBody"},{"path":"/api/tools/x_timeline","method":"POST","description":"Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"1.200000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_timeline/post/requestBody"},{"path":"/api/tools/x_lists","method":"POST","description":"Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers. Billed per item returned. Useful for following a curated set of accounts as one feed.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"1.200000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_lists/post/requestBody"},{"path":"/api/tools/x_communities","method":"POST","description":"Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"1.200000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_communities/post/requestBody"},{"path":"/api/tools/x_extract","method":"POST","description":"Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community members, spaces, or people/tweet search results — 23 extractors. Runs async: you get a claim check immediately and poll a free status URL for the download link. Billed per result.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"60.000000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_extract/post/requestBody"},{"path":"/api/tools/x_monitor","method":"POST","description":"Watch an X/Twitter account or keyword query in real time: new tweets, replies, quotes, mentions, hashtags, and profile changes, delivered to your agent by free polling or HMAC-signed webhooks. Prepaid by the hour with a hard stop at expiry — no open-ended billing. The way to track a brand, competitor, or topic without re-polling paid reads.","price":{"mode":"dynamic","currency":"USD","min":"0.026400","max":"4.234800"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_monitor/post/requestBody"},{"path":"/api/tools/draws","method":"POST","description":"Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count.","price":{"mode":"dynamic","currency":"USD","min":"0.002400","max":"84.001200"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fdraws/post/requestBody"},{"path":"/api/tools/x_write","method":"POST","description":"Act on X/Twitter through an account you connect: post a tweet, reply, like, retweet, follow or unfollow, send a DM, delete a tweet, remove a follower, or upload media. Ownership is checked server-side — an agent can only write as a handle its own wallet connected.","price":{"mode":"dynamic","currency":"USD","min":"0.006000","max":"0.036000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_write/post/requestBody"},{"path":"/api/tools/x_inbox","method":"POST","description":"Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only for handles this wallet connected.","price":{"mode":"dynamic","currency":"USD","min":"0.001200","max":"12.000000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_inbox/post/requestBody"},{"path":"/api/tools/x_profile","method":"POST","description":"Edit a connected X/Twitter account's profile: display name, bio, location, website link, avatar image, and banner image. Acts only on handles this wallet connected.","price":{"mode":"dynamic","currency":"USD","min":"0.012000","max":"0.012000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_profile/post/requestBody"},{"path":"/api/tools/x_community","method":"POST","description":"Manage X/Twitter Communities as a connected account: create a new community, join or leave an existing one, or delete a community you own.","price":{"mode":"dynamic","currency":"USD","min":"0.012000","max":"0.036000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fx_community/post/requestBody"},{"path":"/api/tools/radar","method":"POST","description":"Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters. Flat sub-cent price per call; the cheap first stop for what is happening right now.","price":{"mode":"dynamic","currency":"USD","min":"0.001000","max":"0.001000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fradar/post/requestBody"},{"path":"/api/tools/compose","method":"POST","description":"Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step.","price":{"mode":"dynamic","currency":"USD","min":"0.001000","max":"0.001000"},"schema_url":"https://twitr.sh/openapi.json#/paths/%2Fapi%2Ftools%2Fcompose/post/requestBody"}]}