{"uid":"cap_HEDxsUtwouNe2fi5Tf0Pl","slug":"web-news-search-monitor-9329b97d","name":"Web + News Search Monitor","description":"Monitor a topic: call with a query (web or news) and a watchId; each call returns only the results you have not seen before (newResults) plus the full list, so polling agents stop re-reading old links and spending tokens on them. No setup: the first call creates the watch. Hashed URLs only, kept 60 days; the query text is never stored.","url":"https://agent-search.centorprat.workers.dev/watch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"kind":{"type":"string","description":"web | news (default web)"},"time":{"type":"string","description":"freshness: hour, day, week, month or year (optional)"},"hours":{"type":"integer","description":"news only: window in hours"},"query":{"type":"string","description":"What to search for"},"country":{"type":"string","description":"2-letter country the results are for: us, gb, de, es, fr, in, br, ... (default us)"},"private":{"type":"boolean","description":"true = the query is not logged or cached (default false)"},"watchId":{"type":"string","description":"8-64 chars; leave out on the first call"},"numResults":{"type":"integer","description":"1-20"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5ZKtwXipJx5un00gQx8SL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Polls web or news search results for a query and returns only new (unseen) results since the last call, using a watchId to track state.","exampleAgentPrompt":"Keep an eye on news about 'OpenAI GPT-5' and every time I check in, only show me articles I haven't seen before — use watchId 'openai-gpt5-watch', look at results from the past day, and give me up to 10 new results.","exampleUseCases":[{"title":"Competitor brand mention tracker","prompt":"Monitor the web for new mentions of 'Acme Corp AI' — use watchId 'acme-brand-monitor', search the US, and each time you check just give me the links I haven't seen yet, up to 10 results."},{"title":"Breaking news alert for a topic","prompt":"Watch for breaking news stories about 'Federal Reserve interest rates' from the past hour, using watchId 'fed-rates-news', and only surface articles I haven't read before — check news results, US, up to 5 new stories."},{"title":"Recruiting market intelligence feed","prompt":"Track new web pages mentioning 'senior ML engineer layoffs 2025' — use watchId 'ml-talent-watch', limit to 10 results per check, and skip anything you've already shown me before."}],"resultDescription":"Returns two lists: 'newResults' containing only URLs/results the agent has not seen in previous calls for this watchId, and a full result list. URLs are stored as hashes (not raw text) for 60 days. The first call initializes the watch automatically with no prior setup required.","failureModes":["watchId not provided on a subsequent call — treated as a new watch, losing dedup state","watchId shorter than 8 or longer than 64 characters — rejected","kind value other than 'web' or 'news' — may default or error","hours parameter used on web (non-news) kind — ignored or error","query not provided — required field missing error","time freshness value not matching allowed enum (hour/day/week/month/year) — rejected","watch state expires after 60 days — all results appear new again"],"whenToPreferThis":"Choose this endpoint when an agent needs to repeatedly poll a search query over time and must avoid re-processing URLs it has already seen — for example, in monitoring loops, alert pipelines, or any agentic workflow where token efficiency matters. Prefer it over a plain search endpoint whenever the use case involves recurrent polling rather than a one-shot lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:44.582Z","isFirstParty":false,"canonicalSlug":"web-news-search-monitor-9329b97d"}