Google API: Search Google News
Finds recent Google News articles about a company, person or topic for a country and language, in Google News order, optionally within a time window, with each article's publisher link resolved.
Unofficial. Not affiliated with or endorsed by Google.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Query, required
query Search words, for example Nvidia.
Nvidia
- Country optional
country Country name or two-letter code, for example United States or US.
United States (default)
- Language optional
language Language name or code, for example English or en.
English (default)
- Max Results optional
max_results Maximum number of articles, for example 20. Each article's publisher link is resolved; one run resolves at most 80.
100
Whole number from 1 to 100. Default
20.- Time Window optional
time_window How far back to search, for example past_week.
past_week
One of
past_hour,past_day,past_week,past_month,any. Defaultany.
Input as JSON
{ "query": "Nvidia", "max_results": 100, "time_window": "past_week"}Output
{ "articles": [ { "headline": "NVIDIA Launches Open Agent Safety Platform to Secure Agents From Testing to Deployment", "publisher": "NVIDIA Newsroom", "article_link": "https://nvidianews.nvidia.com/news/open-agent-safety-platform" , "published_at": "2026-09-28T09:07:51+00:00", "google_news_link": "https://news.google.com/rss/articles/CBMibkFVX3lxTFAxdzBTN1hGTnNfZXZNWUU1MjhzQnpHUndjNkNYMGZiRGc1TDR5NExfTmtrbkFvZU5Fakp1eG1CVVFOZ0tpYzJ2aFVVY1pCSFY4Vl80Tkhqbkp3blMyejJkUXdpTVlBZWdzd2VKdVdR?oc=5" }, { "headline": "Nvidia releases software platform to stop AI agents from misbehaving", "publisher": "CNBC", "article_link": "https://www.cnbc.com/2026/09/28/nvidia-releases.html" , "published_at": "2026-09-28T09:00:02+00:00", "google_news_link": "https://news.google.com/rss/articles/CBMiYkFVX3lxTE4weHBRVEI3cE1uNDdNT2VtbWxCMm9iWkpzWVY0dXc4X2hGanFpZnRVLW9JY3IzTXJtMWNFMDRaNlJKZ1BUWkNfRlp2Yk00emxRUVllS3N0NlhtM0lTRHp4WUNR0gFnQVVfeXFMTTR0S3E4cUJLNEZjYmtKT2c4Vk5kXzFXQzhVOWVzdFViUlUwYkg5Zl9kVmZzdXpXVldGdW81NHFzVVZhMWZwOXE1TVVEdkdyV1VtRFJZV1ROU3JOblA…" }, { "headline": "Nvidia unveils security platform to stop AI agents from going rogue", "publisher": "AP News", "article_link": "https://apnews.com/article/nvidia-ai-agent-artificial-intelligence-safety-3c4d7c1cfde82851c0577d1fa29b8621" , "published_at": "2026-09-28T22:14:00+00:00", "google_news_link": "https://news.google.com/rss/articles/CBMiqgFBVV95cUxNLUs1WDRHbkRJcDEzM0tsZ1BWNlZzS2pMVm94RkllS3hiR0Q2UUlPTnc0SVZUcGRCMUVoNDhvTjVKdkhuajJ3RXR2WnJRS2xoRTFwNUREV09yc0dFMjc2YVpCY0RTMW1JbXdDOGpXY283UFVBcG1YRlh6UzBaS0lPOEYwck9UanNBM1dDdXRvVjhQNWtNR1NJWENoemNqNmtHMi1zZWt5UFZwdw?oc=5" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"news.google.com/search_news","input":{"query":"Nvidia","max_results":100,"time_window":"past_week"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "news.google.com/search_news" , "input": { "query": "Nvidia", "max_results": 100, "time_window": "past_week" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "news.google.com/search_news" , "input": { "query": "Nvidia", "max_results": 100, "time_window": "past_week" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run news.google.com/search_news# with {"query":"Nvidia","max_results":100,"time_window":"past_week"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "minLength": 1, "description": "Search words, for example Nvidia." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example United States or US." }, "language": { "type": "string", "default": "English", "description": "Language name or code, for example English or en." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of articles, for example 20. Each article's publisher link is resolved; one run resolves at most 80." }, "time_window": { "enum": [ "past_hour", "past_day", "past_week", "past_month", "any" ], "type": "string", "default": "any", "description": "How far back to search, for example past_week." } }}Output schema
{ "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "type": "object", "required": [ "headline", "publisher", "published_at", "article_link", "google_news_link" ], "properties": { "headline": { "type": "string" }, "publisher": { "type": [ "string", "null" ] }, "article_link": { "type": "string", "description": "Link to the article on the publisher website." }, "published_at": { "type": [ "string", "null" ], "description": "Publication time in ISO 8601 with UTC offset." }, "google_news_link": { "type": "string", "description": "Link to the Google News article." } }, "additionalProperties": false }, "description": "Articles in Google News order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
news.google.com/search_news- Returns
- headline, publisher, published time, publisher article link, Google News link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method news.google.com/search_news with the inputs above.
Ask your agent
- Pull the latest news headlines about Nvidia from the past week, with publisher names, publish times, and direct links to the original articles.
- What are German-language outlets in Germany saying about Volkswagen today? Give me up to 30 articles from the past day.
- Search Google News for coverage of Taylor Swift in the UK over the last month, max 50 results, and resolve each to the publisher's actual URL.
- I need breaking stories from the past hour on the Federal Reserve interest rate decision — headline, source, time, and link.
- Find recent French news articles in France about Mistral AI using Google News, and include both the Google News link and the original publisher link for each.
See more
All Google methodsLists the current top Google News stories, overall or for one topic, in a chosen country and language edition.
news.google.com/list_top_storiesGets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.
google.com/get_search_suggestionsLists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.
trends.google.com/list_trending_searchesSearches Google Books by words, author, subject or ISBN, with language, free-ebook and newest-first options. Ratings counts are not shown by the public book feed; newest sorts the available matches by publication date.
books.google.com/search_booksFinds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.
play.google.com/search_appsFinds a verified advertiser in the Google Ads Transparency Center by company name or website domain and returns its Google ads with dates, regions, previews and ad pages. Counts may be approximate; regions and media previews are read for the first 40 ads.
adstransparency.google.com/get_company_adsFinds Google Patents about an invention. Optional filters: inventor, assignee, country, filing date and publication stage. Legal status is the site's estimate.
patents.google.com/search_patentsGets a company's quarterly or annual income statement, balance sheet or cash flow lines from its Google Finance quote page, with exact reported amounts and year-over-year changes.
google.com/get_company_financials