{"uid":"cap_2pRjLS81wil7q69dd3Gk1","slug":"clinkagent-x-twitter-watch-cursor-based-change-monitor-b46ebc0a","name":"ClinkAgent X/Twitter Watch — Cursor-Based Change Monitor","description":"Monitor X/Twitter for changes - pass a search query and (optionally) a cursor from your last check, get back ONLY what's new since then, plus an AI change summary. Cursor-based so an agent never re-reads the same tweets. Brand monitoring, keyword alerts, competitor tracking. ?query=<advanced search>&since=<ISO timestamp or tweet id>. First call (no since) returns a baseline of the latest 20 + a cursor to pass next time.","url":"https://clinkagent.com/x/watch?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"since":{"type":"string","description":"ISO timestamp or numeric tweet id from a prior call's cursor; omit for a baseline"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"cursor":{"newest_id":"1878000000000000000"},"new_count":3,"truncated":false,"change_summary":{"summary":"...","sentiment":"neutral"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5MJd9b4bk3CxlLWL5HgfC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Monitors X/Twitter for new tweets matching a search query since a last-seen cursor, returning only new results plus an AI-written change summary","exampleAgentPrompt":"Watch X/Twitter for any new tweets mentioning 'ClinkAgent' or '#lithium' since tweet ID 1812345678901234567 and give me only what's new plus a quick AI summary of what changed.","exampleUseCases":[{"title":"Brand mention alert for new posts","prompt":"Check X/Twitter for any new tweets mentioning 'AcmeCorp' or '@AcmeCorp' since my last check at 2024-06-10T08:00:00Z and summarize what people are saying now."},{"title":"Competitor keyword tracking","prompt":"Monitor X for new tweets containing 'Tesla earnings' or '#TSLA' since tweet ID 1800000000000000000 — only show me what's new since then and give me a summary of the change."},{"title":"Hashtag alert for breaking news","prompt":"Watch the #earthquake hashtag on X/Twitter for any new posts since 2024-06-15T14:30:00Z and tell me what's being said in a quick AI summary."}],"resultDescription":"Returns a list of only the new tweets posted since the supplied cursor (or the latest 20 as a baseline on the first call), an AI-generated summary of what changed, and a new cursor to pass on the next call to avoid re-reading any tweets.","failureModes":["Missing required 'query' parameter returns an error","Invalid 'since' format (not ISO timestamp or numeric tweet ID) causes a parse error","No new tweets since last cursor returns an empty list with the same or updated cursor","Rate limiting or X/Twitter API unavailability may result in failure or stale results","Payment failure (x402) blocks the call entirely"],"whenToPreferThis":"Choose this endpoint when you need incremental, cursor-based monitoring of X/Twitter — i.e., you want only new tweets since your last check without duplicating results. It is ideal for polling agents, brand alert workflows, or competitor trackers that run on a schedule. Prefer it over a plain search endpoint when deduplication and change summaries matter, and over a full timeline endpoint when you need multi-keyword advanced search rather than a single account's posts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:47.601Z","isFirstParty":false,"canonicalSlug":"clinkagent-x-twitter-watch-cursor-based-change-monitor-b46ebc0a"}