AkashiDocs
Providers

Google News

Headlines from thousands of publishers, searchable by keyword and filterable by country, language and recency, plus top stories by topic.

  • Provider id: google-news
  • Tools: 2, at $0.001 per call
  • Categories: News
  • Homepage: news.google.com
  • Provider docs: news.google.com/rss
  • Attribution: Google News (headlines link to each publisher)
ToolPriceWhat it does
google-news/headlines$0.001Today's top stories, or one section (business, technology, sports…), for any country edition.
google-news/search$0.001Search news from thousands of publishers by keyword, country, language and recency (keyless).

Inputs are JSON bodies, and unknown fields are rejected with 422 invalid_input (not charged). POST /v1/inspect with a tool's id returns the same input schema, plus the output schema.

Google News Headlines

google-news/headlines · $0.001 per call (local) · News

Today's top stories, or one section (business, technology, sports…), for any country edition.

The current Google News front page or one of its sections (world, nation, business, technology, entertainment, sports, science, health) for a country and language edition, up to 30 headlines with publisher and time. Use it for 'what's in the news in Nigeria today' or 'top tech stories'; to search a subject use google-news/search.

Related: google-news/search, akashi/news.

Input

FieldTypeRequiredDescription
countrystringnoISO 3166-1 alpha-2 edition: US, GB, NG, IN… Pattern ^[A-Za-z]{2}$. Default "US".
languagestringnoISO 639-1 language: en, fr, es, pt, de… Pattern ^[a-z]{2}$. Default "en".
limitintegernoFrom 1 to 30. Default 10.
topicstringnotop (front page) or a section: world, nation, business, technology, entertainment, sports, science, health. One of top, world, nation, business, technology, entertainment, sports, science, health. Default "top".

Example

Input
{
  "topic": "technology",
  "country": "US",
  "limit": 5
}
Run it with the CLI
node akashi.mjs run google-news/headlines --input '{"topic":"technology","country":"US","limit":5}'

google-news/search · $0.001 per call (local) · News

Search news from thousands of publishers by keyword, country, language and recency (keyless).

Searches Google News and returns up to 30 articles, newest and most relevant first: headline, publisher, publisher site, publication time and a link that redirects to the article. Filter by edition (country + language) and recency (day, week, month); Google's quotes and OR operators work. Headlines only, no article text: read one with jina/read or firecrawl/scrape. For Google's ranked news with snippets and images use serper/news; for tech-community discussion use hackernews/search.

Related: google-news/headlines, serper/news, jina/read.

Input

FieldTypeRequiredDescription
countrystringnoISO 3166-1 alpha-2 edition: US, GB, NG, IN… Pattern ^[A-Za-z]{2}$. Default "US".
languagestringnoISO 639-1 language: en, fr, es, pt, de… Pattern ^[a-z]{2}$. Default "en".
limitintegernoFrom 1 to 30. Default 10.
querystringyesKeywords; quotes and OR work as on Google: '"Pocket Network" OR POKT'. 2–200 characters.
recencystringnoOnly articles from the last day, week or month. One of any, day, week, month. Default "any".

Example

Input
{
  "query": "\"Pocket Network\"",
  "recency": "month",
  "limit": 5
}
Run it with the CLI
node akashi.mjs run google-news/search --input '{"query":"\"Pocket Network\"","recency":"month","limit":5}'

On this page