Docs
Open Lodol
DocumentationIntegrationsAPI

GNews

App · News · 7 actions

Search the news with GNews: articles from over 80,000 sources worldwide, and the trending headline feed Google News ranks, in nine sections and dozens of languages and countries. Search by keyword or exact phrase over a date range, follow a subject on a rolling window for a scheduled workflow, count how much is being written about it, see which publishers are covering it, and compare topics or countries side by side.

Actions

ActionWhat it does
Compare countriesTake one subject and see where in the world it is being written about: two to five countries over the same window, ranked, each with its share of the combined coverage and its newest headline.
Compare topicsCompare how much is being written about several subjects (two to five of them) over the same window, ranked, each with its share of the combined coverage and its newest headline.
Count articlesCount how many articles mention a subject in the window you choose, and return the newest one.
Get top headlinesGet the trending headlines, ranked the way Google News ranks them, in any of nine sections: general, world, nation, business, technology, entertainment, sports, science or health.
Get top sources for a topicFind out who is covering a subject, not just what has been written: the publishers writing about it most in the window you choose, ranked, each with its share of the coverage and its most recent article.
Search articlesSearch news articles from over 80,000 sources worldwide, with every filter GNews offers: keywords, which part of the article to match them in, language, the country the publisher is in, a published-between window, ordering and paging.
Search recent articlesSearch articles published within a window that moves with the clock (the last 6 hours, the last day, the last week) counted back from the moment the step runs.

Compare countries

Take one subject and see where in the world it is being written about: two to five countries over the same window, ranked, each with its share of the combined coverage and its newest headline. Use it to tell a local story from an international one, or to find the market a launch actually landed in.

Inputs

Search forquerytextRequired
Keywords to search for. Put a phrase in double quotes for an exact match ("interest rate cut"), and combine terms with AND, OR and NOT. OR binds tighter than AND, so use brackets when you mix them. At most 200 characters.
CountriescountrieslistRequired
The countries to compare: between 2 and 5. Each one is searched separately and costs one request.One or more of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.
How far backwindowtext
How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of a fixed date. Note that the free plan publishes articles 12 hours after they appear, so a window shorter than that comes back empty on it.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 3d (Last 3 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days). Default: 24h.
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.

Outputs

countrieslist
The countries, most coverage first
country_countnumber
How many countries were compared
from_datetext
The start of the window, in UTC, as sent to GNews
languagetext
The language filter that was applied
leading_countrytext
The country covering it most
leading_country_labeltext
That country's name
querytext
The subject that ran
requests_usednumber
How many GNews requests this step spent: one per country
to_datetext
The end of the window, in UTC, as sent to GNews
total_articlesnumber
The combined article count across the countries
windowtext
The window that was asked for
window_labeltext
That window in words
Example output
{
  "countries": [
    {
      "country": "us",
      "country_label": "United States",
      "newest_published_at": "2026-08-19T09:12:00Z",
      "newest_source_name": "Reuters",
      "newest_title": "Chip makers post record quarter as AI demand holds",
      "newest_url": "https://www.reuters.com/technology/chip-makers-record-quarter",
      "share_percent": 63.4,
      "total_articles": 71
    },
    {
      "country": "gb",
      "country_label": "United Kingdom",
      "newest_published_at": "2026-08-19T07:45:00Z",
      "newest_source_name": "BBC News",
      "newest_title": "Regulators open review of cloud computing contracts",
      "newest_url": "https://www.bbc.co.uk/news/business-68123456",
      "share_percent": 36.6,
      "total_articles": 41
    }
  ],
  "country_count": 2,
  "from_date": "2026-08-18T10:00:00.000Z",
  "language": "en",
  "leading_country": "us",
  "leading_country_label": "United States",
  "query": "semiconductors",
  "requests_used": 2,
  "to_date": "2026-08-19T10:00:00.000Z",
  "total_articles": 112,
  "window": "24h",
  "window_label": "Last 24 hours"
}

Compare topics

Compare how much is being written about several subjects (two to five of them) over the same window, ranked, each with its share of the combined coverage and its newest headline. Use it for share of voice against competitors, or to see which of your product lines the press is picking up.

Inputs

TopicstopicslistRequired
The subjects to compare: between 2 and 5. Each one is searched separately and costs one request.
How far backwindowtext
How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of a fixed date. Note that the free plan publishes articles 12 hours after they appear, so a window shorter than that comes back empty on it.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 3d (Last 3 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days). Default: 24h.
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.
Published incountrytext
Optional. Only include articles published in this country. It is where the publisher is, not what the article is about.One of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.

Outputs

countrytext
The country filter that was applied
from_datetext
The start of the window, in UTC, as sent to GNews
languagetext
The language filter that was applied
leading_topictext
The most covered topic
requests_usednumber
How many GNews requests this step spent: one per topic
to_datetext
The end of the window, in UTC, as sent to GNews
topic_countnumber
How many topics were compared
topicslist
The topics, most covered first
total_articlesnumber
The combined article count across the topics
windowtext
The window that was asked for
window_labeltext
That window in words
Example output
{
  "country": null,
  "from_date": "2026-08-18T10:00:00.000Z",
  "language": "en",
  "leading_topic": "semiconductors",
  "requests_used": 2,
  "to_date": "2026-08-19T10:00:00.000Z",
  "topic_count": 2,
  "topics": [
    {
      "newest_published_at": "2026-08-19T09:12:00Z",
      "newest_source_name": "Reuters",
      "newest_title": "Chip makers post record quarter as AI demand holds",
      "newest_url": "https://www.reuters.com/technology/chip-makers-record-quarter",
      "share_percent": 62.0,
      "topic": "semiconductors",
      "total_articles": 62
    },
    {
      "newest_published_at": "2026-08-19T06:02:00Z",
      "newest_source_name": "Nature",
      "newest_title": "Lab reports longer qubit coherence times",
      "newest_url": "https://www.nature.com/articles/qubit-coherence",
      "share_percent": 38.0,
      "topic": "quantum computing",
      "total_articles": 38
    }
  ],
  "total_articles": 100,
  "window": "24h",
  "window_label": "Last 24 hours"
}

Count articles

Count how many articles mention a subject in the window you choose, and return the newest one. It costs a single request whether the answer is three articles or thirty thousand, so it is the cheap check to branch a workflow on: alert someone when coverage of your brand spikes, or skip the rest of the run when there is nothing new.

Inputs

Search forquerytextRequired
Keywords to search for. Put a phrase in double quotes for an exact match ("interest rate cut"), and combine terms with AND, OR and NOT. OR binds tighter than AND, so use brackets when you mix them. At most 200 characters.
How far backwindowtext
How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of a fixed date. Note that the free plan publishes articles 12 hours after they appear, so a window shorter than that comes back empty on it.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 3d (Last 3 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days). Default: 24h.
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.
Published incountrytext
Optional. Only include articles published in this country. It is where the publisher is, not what the article is about.One of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.

Outputs

countrytext
The country filter that was applied
country_labeltext
That country's name
from_datetext
The start of the window, in UTC, as sent to GNews
has_articlestrue/false
True when at least one article matches
languagetext
The language filter that was applied
newest_articleobject
The most recent matching article
querytext
The topic that ran
to_datetext
The end of the window, in UTC, as sent to GNews
total_articlesnumber
How many articles match
windowtext
The window that was asked for
window_labeltext
That window in words
Example output
{
  "country": null,
  "country_label": null,
  "from_date": "2026-08-18T10:00:00.000Z",
  "has_articles": true,
  "language": "en",
  "newest_article": {
    "content": "Semiconductor revenue rose sharply again last quarter as orders for data-centre accelerators continued to outstrip supply",
    "content_chars_remaining": 2317,
    "content_truncated": true,
    "description": "Revenue across the sector rose 18% year on year, with data-centre orders leading the way.",
    "domain": "reuters.com",
    "id": "9d1a5f3c2b7e4a8f0c6d1e2f3a4b5c6d",
    "image_url": "https://www.reuters.com/resizer/chips.jpg",
    "language": "en",
    "language_label": "English",
    "published_at": "2026-08-19T09:12:00Z",
    "source_country": "gb",
    "source_country_label": "United Kingdom",
    "source_id": "reuters",
    "source_name": "Reuters",
    "source_url": "https://www.reuters.com",
    "title": "Chip makers post record quarter as AI demand holds",
    "url": "https://www.reuters.com/technology/chip-makers-record-quarter"
  },
  "query": "semiconductors",
  "to_date": "2026-08-19T10:00:00.000Z",
  "total_articles": 62,
  "window": "24h",
  "window_label": "Last 24 hours"
}

Get top headlines

Get the trending headlines, ranked the way Google News ranks them, in any of nine sections: general, world, nation, business, technology, entertainment, sports, science or health. Narrow them to a country, a language or a keyword. This is the front page; use Search articles to go looking for something in particular.

Inputs

Sectioncategorytext
Which section of the news to take headlines from. General is the overall front page.One of: general, world, nation, business, technology, entertainment, sports, science, health. Default: general.
Languagelanguagetext
Optional. Only include headlines written in this language.One of: ar (Arabic), bn (Bengali), bg (Bulgarian), ca (Catalan), zh (Chinese), cs (Czech), nl (Dutch), en (English), et (Estonian), fi (Finnish), and 31 more.
Countrycountrytext
Optional. Only include headlines for this country. Pair it with the Nation section for that country's own domestic front page.One of: ar (Argentina), au (Australia), at (Austria), bd (Bangladesh), be (Belgium), bw (Botswana), br (Brazil), bg (Bulgaria), ca (Canada), cl (Chile), and 61 more.
Keywordquerytext
Optional. Only keep headlines that match these keywords. Leave it empty for the whole category. The same search grammar applies.
Published afterfrom_datedate and time
Optional. Only include articles published at or after this moment. Times are converted to UTC for you. The free plan reaches back 30 days; paid plans reach back to 2020.
Published beforeto_datedate and time
Optional. Only include articles published at or before this moment. Times are converted to UTC for you.
How many articlesmax_articlesnumber
How many articles to return, from 1 to 100. Your plan sets the real ceiling: 10 on the free plan, 25, 50 or 100 on the paid ones.From 1 to 100. Default: 10.
Pagepagenumber
Which page of results to return. Page 1 is the first. Use it with 'How many articles' to walk through a large set of matches; GNews pages through at most 1000 articles.At least 1. Default: 1.
Also includeinclude_incompletelist
Optional. GNews leaves out an article that has no summary, no article text or no picture. Tick the ones you would still like to see. That is useful when you are counting coverage rather than reading it.One or more of: description (Articles with no summary), content (Articles with no article text), image (Articles with no picture).
Shorten the article textshorten_contenttrue/false
Cut each article's text down to a short extract. Worth turning on when you are feeding many articles to an AI step or an email and the full text would be too much. The free plan shortens it either way.Default: false.

Outputs

article_countnumber
How many articles this page actually returned
articleslist
The articles on this page
categorytext
The section that was asked for
category_labeltext
That section's name
countrytext
The country filter that was applied
country_labeltext
That country's name
from_datetext
The earliest publication time asked for, in UTC
has_moretrue/false
True when another page of matches can be fetched
languagetext
The language filter that was applied
max_articlesnumber
How many were asked for per page
pagenumber
The page that was returned
querytext
The keyword filter that was applied
to_datetext
The latest publication time asked for, in UTC
total_articlesnumber
How many articles match in total, across all pages
Example output
{
  "article_count": 2,
  "articles": [
    {
      "content": "Semiconductor revenue rose sharply again last quarter as orders for data-centre accelerators continued to outstrip supply",
      "content_chars_remaining": 2317,
      "content_truncated": true,
      "description": "Revenue across the sector rose 18% year on year, with data-centre orders leading the way.",
      "domain": "reuters.com",
      "id": "9d1a5f3c2b7e4a8f0c6d1e2f3a4b5c6d",
      "image_url": "https://www.reuters.com/resizer/chips.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T09:12:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "reuters",
      "source_name": "Reuters",
      "source_url": "https://www.reuters.com",
      "title": "Chip makers post record quarter as AI demand holds",
      "url": "https://www.reuters.com/technology/chip-makers-record-quarter"
    },
    {
      "content": "The review will report next spring, the regulator said",
      "content_chars_remaining": 1180,
      "content_truncated": true,
      "description": "The inquiry will look at exit fees and data transfer costs.",
      "domain": "bbc.co.uk",
      "id": "1f2e3d4c5b6a7988990a1b2c3d4e5f60",
      "image_url": "https://ichef.bbci.co.uk/news/1024/cloud.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T07:45:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "bbc-news",
      "source_name": "BBC News",
      "source_url": "https://www.bbc.co.uk",
      "title": "Regulators open review of cloud computing contracts",
      "url": "https://www.bbc.co.uk/news/business-68123456"
    }
  ],
  "category": "business",
  "category_label": "Business",
  "country": "us",
  "country_label": "United States",
  "from_date": null,
  "has_more": true,
  "language": "en",
  "max_articles": 10,
  "page": 1,
  "query": null,
  "to_date": null,
  "total_articles": 384
}

Get top sources for a topic

Find out who is covering a subject, not just what has been written: the publishers writing about it most in the window you choose, ranked, each with its share of the coverage and its most recent article. Use it to build a press list, to see where a story is landing, or to pick the publishers to read it through.

Inputs

Search forquerytextRequired
Keywords to search for. Put a phrase in double quotes for an exact match ("interest rate cut"), and combine terms with AND, OR and NOT. OR binds tighter than AND, so use brackets when you mix them. At most 200 characters.
How far backwindowtext
How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of a fixed date. Note that the free plan publishes articles 12 hours after they appear, so a window shorter than that comes back empty on it.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 3d (Last 3 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days). Default: 24h.
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.
Published incountrytext
Optional. Only include articles published in this country. It is where the publisher is, not what the article is about.One of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.
How many publishersmax_sourcesnumber
How many publishers to return, most active first, from 1 to 25.From 1 to 25. Default: 10.
Articles to rank fromsample_sizenumber
How many recent articles to build the ranking from, in one request. More articles make a steadier ranking; your plan sets the ceiling (10 on the free plan, up to 100 on the largest).From 1 to 100. Default: 10.

Outputs

countrytext
The country filter that was applied
from_datetext
The start of the window, in UTC, as sent to GNews
languagetext
The language filter that was applied
querytext
The topic that ran
sampled_articlesnumber
How many articles the ranking was built from
source_countnumber
How many publishers appeared in the sample
sourceslist
The publishers covering it, most active first
to_datetext
The end of the window, in UTC, as sent to GNews
total_articlesnumber
How many articles match in total
windowtext
The window that was asked for
window_labeltext
That window in words
Example output
{
  "country": null,
  "from_date": "2026-08-12T10:00:00.000Z",
  "language": "en",
  "query": "semiconductors",
  "sampled_articles": 10,
  "source_count": 6,
  "sources": [
    {
      "article_count": 4,
      "domain": "reuters.com",
      "latest_published_at": "2026-08-19T09:12:00Z",
      "latest_title": "Chip makers post record quarter as AI demand holds",
      "latest_url": "https://www.reuters.com/technology/chip-makers-record-quarter",
      "share_percent": 40.0,
      "source_id": "reuters",
      "source_name": "Reuters",
      "source_url": "https://www.reuters.com"
    },
    {
      "article_count": 2,
      "domain": "bbc.co.uk",
      "latest_published_at": "2026-08-19T07:45:00Z",
      "latest_title": "Regulators open review of cloud computing contracts",
      "latest_url": "https://www.bbc.co.uk/news/business-68123456",
      "share_percent": 20.0,
      "source_id": "bbc-news",
      "source_name": "BBC News",
      "source_url": "https://www.bbc.co.uk"
    }
  ],
  "to_date": "2026-08-19T10:00:00.000Z",
  "total_articles": 384,
  "window": "7d",
  "window_label": "Last 7 days"
}

Search articles

Search news articles from over 80,000 sources worldwide, with every filter GNews offers: keywords, which part of the article to match them in, language, the country the publisher is in, a published-between window, ordering and paging. Each article comes back flattened, with its publisher, its domain and a clean copy of its text.

Inputs

Search forquerytextRequired
Keywords to search for. Put a phrase in double quotes for an exact match ("interest rate cut"), and combine terms with AND, OR and NOT. OR binds tighter than AND, so use brackets when you mix them. At most 200 characters.
Search insearch_inlist
Optional. Which parts of an article the keywords have to appear in. Leave it empty to use GNews's default of the headline and the summary; narrowing to the headline alone finds articles that are about the subject rather than ones that merely mention it.One or more of: title (Headline), description (Summary), content (Article text).
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.
Published incountrytext
Optional. Only include articles published in this country. It is where the publisher is, not what the article is about.One of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.
Published afterfrom_datedate and time
Optional. Only include articles published at or after this moment. Times are converted to UTC for you. The free plan reaches back 30 days; paid plans reach back to 2020.
Published beforeto_datedate and time
Optional. Only include articles published at or before this moment. Times are converted to UTC for you.
Order results bysort_bytext
How to order the articles. Newest first is the default; best match ranks the closest matches to your keywords first.One of: publishedAt (Newest first), relevance (Best match first). Default: publishedAt.
How many articlesmax_articlesnumber
How many articles to return, from 1 to 100. Your plan sets the real ceiling: 10 on the free plan, 25, 50 or 100 on the paid ones.From 1 to 100. Default: 10.
Pagepagenumber
Which page of results to return. Page 1 is the first. Use it with 'How many articles' to walk through a large set of matches; GNews pages through at most 1000 articles.At least 1. Default: 1.
Also includeinclude_incompletelist
Optional. GNews leaves out an article that has no summary, no article text or no picture. Tick the ones you would still like to see. That is useful when you are counting coverage rather than reading it.One or more of: description (Articles with no summary), content (Articles with no article text), image (Articles with no picture).
Shorten the article textshorten_contenttrue/false
Cut each article's text down to a short extract. Worth turning on when you are feeding many articles to an AI step or an email and the full text would be too much. The free plan shortens it either way.Default: false.

Outputs

article_countnumber
How many articles this page actually returned
articleslist
The articles on this page
countrytext
The country filter that was applied
country_labeltext
That country's name
from_datetext
The earliest publication time asked for, in UTC
has_moretrue/false
True when another page of matches can be fetched
languagetext
The language filter that was applied
max_articlesnumber
How many were asked for per page
pagenumber
The page that was returned
querytext
The search that ran
sort_bytext
The ordering that was applied
to_datetext
The latest publication time asked for, in UTC
total_articlesnumber
How many articles match in total, across all pages
Example output
{
  "article_count": 2,
  "articles": [
    {
      "content": "Semiconductor revenue rose sharply again last quarter as orders for data-centre accelerators continued to outstrip supply",
      "content_chars_remaining": 2317,
      "content_truncated": true,
      "description": "Revenue across the sector rose 18% year on year, with data-centre orders leading the way.",
      "domain": "reuters.com",
      "id": "9d1a5f3c2b7e4a8f0c6d1e2f3a4b5c6d",
      "image_url": "https://www.reuters.com/resizer/chips.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T09:12:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "reuters",
      "source_name": "Reuters",
      "source_url": "https://www.reuters.com",
      "title": "Chip makers post record quarter as AI demand holds",
      "url": "https://www.reuters.com/technology/chip-makers-record-quarter"
    },
    {
      "content": "The review will report next spring, the regulator said",
      "content_chars_remaining": 1180,
      "content_truncated": true,
      "description": "The inquiry will look at exit fees and data transfer costs.",
      "domain": "bbc.co.uk",
      "id": "1f2e3d4c5b6a7988990a1b2c3d4e5f60",
      "image_url": "https://ichef.bbci.co.uk/news/1024/cloud.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T07:45:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "bbc-news",
      "source_name": "BBC News",
      "source_url": "https://www.bbc.co.uk",
      "title": "Regulators open review of cloud computing contracts",
      "url": "https://www.bbc.co.uk/news/business-68123456"
    }
  ],
  "country": "gb",
  "country_label": "United Kingdom",
  "from_date": "2026-08-12T00:00:00.000Z",
  "has_more": true,
  "language": "en",
  "max_articles": 10,
  "page": 1,
  "query": "semiconductors",
  "sort_by": "publishedAt",
  "to_date": "2026-08-19T00:00:00.000Z",
  "total_articles": 384
}

Search recent articles

Search articles published within a window that moves with the clock (the last 6 hours, the last day, the last week) counted back from the moment the step runs. This is the search to put on a schedule: a fixed date range would return the same articles on every run, while this one always looks at what is new.

Inputs

Search forquerytextRequired
Keywords to search for. Put a phrase in double quotes for an exact match ("interest rate cut"), and combine terms with AND, OR and NOT. OR binds tighter than AND, so use brackets when you mix them. At most 200 characters.
How far backwindowtext
How recent an article has to be, counted back from the moment the step runs, so a workflow on a schedule keeps looking at fresh news instead of a fixed date. Note that the free plan publishes articles 12 hours after they appear, so a window shorter than that comes back empty on it.One of: 1h (Last hour), 6h (Last 6 hours), 12h (Last 12 hours), 24h (Last 24 hours), 2d (Last 2 days), 3d (Last 3 days), 7d (Last 7 days), 14d (Last 14 days), 30d (Last 30 days). Default: 24h.
Languagelanguagetext
Optional. Only include articles written in this language.One of: ar (Arabic), bn (Bengali), zh (Chinese), nl (Dutch), en (English), fr (French), de (German), el (Greek), he (Hebrew), hi (Hindi), and 16 more.
Published incountrytext
Optional. Only include articles published in this country. It is where the publisher is, not what the article is about.One of: ar (Argentina), au (Australia), bd (Bangladesh), br (Brazil), ca (Canada), cn (China), co (Colombia), eg (Egypt), fr (France), de (Germany), and 27 more.
Order results bysort_bytext
How to order the articles. Newest first is the default; best match ranks the closest matches to your keywords first.One of: publishedAt (Newest first), relevance (Best match first). Default: publishedAt.
How many articlesmax_articlesnumber
How many articles to return, from 1 to 100. Your plan sets the real ceiling: 10 on the free plan, 25, 50 or 100 on the paid ones.From 1 to 100. Default: 10.

Outputs

article_countnumber
How many articles this page actually returned
articleslist
The articles on this page
countrytext
The country filter that was applied
country_labeltext
That country's name
from_datetext
The start of the window, in UTC, as sent to GNews
has_moretrue/false
True when another page of matches can be fetched
languagetext
The language filter that was applied
max_articlesnumber
How many were asked for per page
pagenumber
The page that was returned
querytext
The search that ran
sort_bytext
The ordering that was applied
to_datetext
The end of the window, in UTC, as sent to GNews
total_articlesnumber
How many articles match in total, across all pages
windowtext
The window that was asked for
window_labeltext
That window in words
Example output
{
  "article_count": 2,
  "articles": [
    {
      "content": "Semiconductor revenue rose sharply again last quarter as orders for data-centre accelerators continued to outstrip supply",
      "content_chars_remaining": 2317,
      "content_truncated": true,
      "description": "Revenue across the sector rose 18% year on year, with data-centre orders leading the way.",
      "domain": "reuters.com",
      "id": "9d1a5f3c2b7e4a8f0c6d1e2f3a4b5c6d",
      "image_url": "https://www.reuters.com/resizer/chips.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T09:12:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "reuters",
      "source_name": "Reuters",
      "source_url": "https://www.reuters.com",
      "title": "Chip makers post record quarter as AI demand holds",
      "url": "https://www.reuters.com/technology/chip-makers-record-quarter"
    },
    {
      "content": "The review will report next spring, the regulator said",
      "content_chars_remaining": 1180,
      "content_truncated": true,
      "description": "The inquiry will look at exit fees and data transfer costs.",
      "domain": "bbc.co.uk",
      "id": "1f2e3d4c5b6a7988990a1b2c3d4e5f60",
      "image_url": "https://ichef.bbci.co.uk/news/1024/cloud.jpg",
      "language": "en",
      "language_label": "English",
      "published_at": "2026-08-19T07:45:00Z",
      "source_country": "gb",
      "source_country_label": "United Kingdom",
      "source_id": "bbc-news",
      "source_name": "BBC News",
      "source_url": "https://www.bbc.co.uk",
      "title": "Regulators open review of cloud computing contracts",
      "url": "https://www.bbc.co.uk/news/business-68123456"
    }
  ],
  "country": null,
  "country_label": null,
  "from_date": "2026-08-18T10:00:00.000Z",
  "has_more": true,
  "language": "en",
  "max_articles": 10,
  "page": 1,
  "query": "semiconductors",
  "sort_by": "publishedAt",
  "to_date": "2026-08-19T10:00:00.000Z",
  "total_articles": 384,
  "window": "24h",
  "window_label": "Last 24 hours"
}

Gmail

Previous Page

Go modules

Next Page

On this page

ActionsCompare countriesCompare topicsCount articlesGet top headlinesGet top sources for a topicSearch articlesSearch recent articles