{"uid":"cap_mBslV_DIjacYNnWSxnaXW","slug":"twitr-sh-x-twitter-account-keyword-monitor-a4c1e229","name":"twitr.sh X/Twitter Account & Keyword Monitor","description":"Pay-per-call X/Twitter API for AI agents. Read tweets, search, monitor accounts in real time, and post — paid in USDC via x402. No signup, no API keys.","url":"https://twitr.sh/api/tools/x_monitor?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"type":{"enum":["account","keyword"],"type":"string","description":"Monitor kind (create). Inferred from username/query when omitted."},"hours":{"type":"integer","maximum":168,"minimum":1,"description":"Prepaid hours to purchase (default 1)."},"query":{"type":"string","maxLength":512,"description":"X search query to monitor (create, type=keyword)."},"action":{"enum":["create","extend"],"type":"string","description":"Create a new monitor or extend an existing one."},"username":{"type":"string","description":"X handle to monitor, without @ (create, type=account)."},"monitorId":{"type":"string","description":"Monitor to extend (extend only)."},"eventTypes":{"type":"array","items":{"enum":["tweet.new","tweet.reply","tweet.retweet","tweet.quote","tweet.media","tweet.link","tweet.poll","tweet.mention","tweet.hashtag","tweet.longform","profile.avatar.changed","profile.banner.changed","profile.name.changed","profile.username.changed","profile.bio.changed","profile.location.changed","profile.url.changed","profile.verified.changed","profile.protected.changed","profile.pinned_tweet.changed","profile.unavailable.changed"],"type":"string"},"description":"Event types to receive (default: all applicable). Post events (tweet.*) work for any monitor; profile-change events (profile.*.changed) apply to ACCOUNT monitors only."}}},"responseSchema":{"type":"json","example":{"message":"Monitor active for 24 hours.","monitor":{"type":"account","status":"active","target":"vercel","expires_at":1785000000000,"monitor_id":"mn_a1b2c3d4e5f6g7h8","event_types":["tweet.new"],"paid_total_usd":"0.605100","hours_purchased":24,"remaining_seconds":86400},"payment":{"amount":"0.605100","currency":"USD","protocol":"x402"},"events_url":"/api/monitors/mn_a1b2c3d4e5f6g7h8/events","manage_url":"/api/monitors/mn_a1b2c3d4e5f6g7h8"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0264","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0264/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0264","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0264","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GVtlOEV3aEzjw6YYZIkBZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0264","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates or extends a real-time monitor on an X/Twitter account or keyword query, streaming tweet and profile-change events for a prepaid number of hours.","exampleAgentPrompt":"Watch the @vercel Twitter account for new tweets and any profile changes for the next 24 hours — alert me to tweet.new and profile.bio.changed events as they happen.","exampleUseCases":[{"title":"Competitor brand monitoring","prompt":"Set up a monitor on the @openai Twitter account for the next 48 hours and notify me whenever they post a new tweet or change their profile bio."},{"title":"Keyword campaign tracking","prompt":"Monitor the keyword 'GPT-5 launch' on Twitter for the next 12 hours and send me all new tweets and quote tweets that match."},{"title":"Breaking news alert feed","prompt":"Start watching the keyword '#earthquake' on X for 6 hours and stream back any new tweets or media tweets as they appear."}],"resultDescription":"Returns a monitor object with a unique monitor ID, type (account or keyword), status (active), target, expiry timestamp, list of subscribed event types, total USD paid, hours purchased, remaining seconds, and URLs to poll events or manage the monitor. Also includes payment confirmation details via x402.","failureModes":["Invalid or suspended X username returns an error","Search query exceeds 512 character limit","Hours value outside 1–168 range is rejected","Extending a non-existent or expired monitorId fails","Insufficient USDC payment results in 402 rejection","Unsupported eventType combinations (profile.* events on keyword monitors) may be silently filtered or error"],"whenToPreferThis":"Choose this endpoint when you need continuous, real-time surveillance of a specific X account or keyword query over a defined time window — especially when you want granular event filtering (new tweets, retweets, profile changes, media posts) without setting up your own Twitter developer credentials. Ideal for agents that need to react to live social signals programmatically, paid per session with no subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:33:56.907Z","isFirstParty":false,"canonicalSlug":"twitr-sh-x-twitter-account-keyword-monitor-a4c1e229"}