{"uid":"cap_ls7VQXaoFADWX66s_0uCp","slug":"news-search-clustered-google-news-results-38a3f040","name":"News Search – Clustered Google News Results","description":"News search API: Google News results plus Google News RSS, merged and clustered by story, so each row is one story with its best outlet, how many outlets cover it and links to the others. Freshness window in hours (1 h to 1 y), country and language. Ranked by outlet authority, coverage and recency. Tracking parameters removed from links.","url":"https://agent-search.centorprat.workers.dev/news?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"time":{"type":"string","description":"freshness: hour, day, week, month or year (optional)"},"hours":{"type":"integer","description":"only stories from the last N hours (1-8760)"},"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)"},"language":{"type":"string","description":"e.g. en, es, de"},"numResults":{"type":"integer","description":"1-20 (default 10)"}}},"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_sNL1WC9RWh6PFGr8E79PI","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":"Searches Google News and Google News RSS, merges and clusters results by story, returning one row per story with the best outlet, coverage count, and clean links — ranked by authority, recency, and breadth.","exampleAgentPrompt":"Search the news for stories about the US Federal Reserve interest rate decision from the last 24 hours — give me up to 10 results in English for the US, and show me how many outlets are covering each story.","exampleUseCases":[{"title":"Breaking news monitoring for a brand","prompt":"Find all news stories mentioning 'OpenAI' from the last 6 hours, US results in English, up to 10 stories — I want to see which outlets are covering each one and how broadly."},{"title":"Foreign-language news research","prompt":"Search Spanish-language news from Spain about the upcoming elections over the past week — give me 10 clustered stories ranked by how many outlets are covering them."},{"title":"Competitive intelligence briefing","prompt":"Pull the top 10 news stories about Tesla from the last 48 hours for a US audience, in English — I want to know which outlets are running each story and get clean links with no tracking junk."}],"resultDescription":"A ranked list of story clusters where each row represents one distinct news story. Each cluster includes the headline, the most authoritative outlet covering it, a count of how many total outlets are covering the story, clean tracking-free links to those other outlets, and recency information. Results are ranked by a combination of outlet authority, breadth of coverage, and freshness.","failureModes":["Query returns no results if the topic is too niche or outside the freshness window","Very short freshness windows (e.g. 1 hour) may return sparse results for low-traffic topics","Country or language combinations may have limited coverage outside major markets","Rate limiting or upstream Google News changes could cause empty or partial result sets","Invalid country codes or language codes may silently fall back to defaults"],"whenToPreferThis":"Choose this endpoint when you need deduplicated, story-level news results rather than raw article lists — it's superior when you want to know the breadth of media coverage (how many outlets) and only see the best source per story. Prefer it over raw Google SERP or RSS feeds when freshness control (exact hours window), multi-outlet clustering, and clean tracking-free links are important. It's especially useful for brand monitoring, competitive intelligence, and news briefings where duplicate stories from different syndication outlets would be noise.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T21:45:20.058Z","isFirstParty":false,"canonicalSlug":"news-search-clustered-google-news-results-38a3f040"}