Google News
Google News search with date, country and language filters.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
googlenews - Version:
1.0.1 - Reads from:
news.google.com
| Action | Description | Listed price |
|---|---|---|
search | Search Google News for articles about a query, such as a company, with a date filter, country and language. One search returns at most about 100 articles, ranked by Google News relevance, not by date: Google News ignores paging past them and offers no sort by date. To collect more, narrow the dates, or set splitByDay to search each day of a range separately. Rows carry the publisher's own URL, its name, the publish time and the lead image; Google News serves no snippet. | Billed per request at your plan's rates |
search
Search Google News for articles about a query, such as a company, with a date filter, country and language. One search returns at most about 100 articles, ranked by Google News relevance, not by date: Google News ignores paging past them and offers no sort by date. To collect more, narrow the dates, or set splitByDay to search each day of a range separately. Rows carry the publisher's own URL, its name, the publish time and the lead image; Google News serves no snippet.
POST https://request.usestring.ai/v1/integrations/googlenews/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. What to search for, such as a company name. Google News search syntax such as quotes and OR works. At least 1 character. |
when | hour day week month year | Only articles from the last hour, day (24 hours), week (7 days), month (30 days) or year. Cannot be combined with from or to. |
from | string | Only articles published on or after this date, YYYY-MM-DD. Google News draws the day in US Pacific time. Matches ^\d{4}-\d{2}-\d{2}$. |
to | string | Only articles published on or before this date, YYYY-MM-DD, inclusive. Google News draws the day in US Pacific time. Matches ^\d{4}-\d{2}-\d{2}$. |
splitByDay | boolean | Run one search per day from from to to (both required, at most 31 days) and return up to limit articles for each day, newest day first. Costs one request per day. |
country | string | The Google News edition's country, ISO 3166-1 alpha-2 such as US, GB or DE. Defaults to US. Matches ^[A-Za-z]{2}$. |
language | string | The edition's language, such as en, de or pt-BR. Defaults to en. Matches ^[a-z]{2,3}(-[A-Za-z0-9]{2,4})?$. |
limit | integer | The most articles to return, 1 to 100, per day under splitByDay. Defaults to 100. From 1 to 100. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
position | integer | Position in the results, from 1, in Google News' relevance order. |
title | string | — |
url | string | The article on the publisher's site, already resolved from Google News' redirect. |
source | string | null | The publisher's name, such as Reuters. |
publishedAt | string | null | When the article was published, ISO 8601 in UTC. |
publishedAtPrecision | second day null | second, or day when Google News gives only the publish date, as it does for most articles older than about a week: publishedAt is then midnight US Pacific of that date, and under from and to can read a day after to. |
authors | string[] | — |
thumbnail | string | null | The article's lead image on the publisher's site. |
articleId | string | Google News' id for the article, as in news.google.com/read/<articleId>. |
day | string | null | Under splitByDay, the day (YYYY-MM-DD, US Pacific) whose search returned the article; null otherwise. |
Example
curl https://request.usestring.ai/v1/integrations/googlenews/search \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Nvidia",
"when": "week",
"limit": 3
}'data starts with these rows:
[
{
"position": 1,
"title": "NVIDIA Launches Open Agent Safety Platform to Secure Agents From Testing to Deployment",
"url": "https://nvidianews.nvidia.com/news/open-agent-safety-platform",
"source": "NVIDIA Newsroom",
"publishedAt": "2026-09-28T22:54:06Z",
"publishedAtPrecision": "second",
"authors": [],
"thumbnail": "https://nvidianews.nvidia.com/_gallery/get_file/?file_id=6aba9c533d6332d60a0bb99a",
"articleId": "CBMibkFVX3lxTFAxdzBTN1hGTnNfZXZNWUU1MjhzQnpHUndjNkNYMGZiRGc1TDR5NExfTmtrbkFvZU5Fakp1eG1CVVFOZ0tpYzJ2aFVVY1pCSFY4Vl80Tkhqbkp3blMyejJkUXdpTVlBZWdzd2VKdVdR",
"day": null
},
{
"position": 2,
"title": "Nvidia announced a software tool to stop rogue AI. How would it work?",
"url": "https://www.pbs.org/newshour/world/nvidia-announced-a-software-tool-to-stop-rogue-ai-how-would-it-work",
"source": "PBS",
"publishedAt": "2026-09-28T22:07:17Z",
"publishedAtPrecision": "second",
"authors": ["Kelvin Chan"],
"thumbnail": "https://d3i6fh83elv35t.cloudfront.net/static/2026/09/2026-09-03T173029Z_895078105_RC2YEMA2W13D_RTRMADP_3_HUGGING-FACE-M-A-NVIDIA-1024x740.jpg",
"articleId": "CBMipAFBVV95cUxORGNBNGRXVmhjbjdpVjV0M1dJRDdBRThrLVJqcnlHeEpUNThyY0VGX2VybDZtZnJOaFE1QkQ3NWpiNngxMHJLYUJidnhVSE10WmFSZ2FXUkVVeGRlWUprRjBxdXBhTzNodF9WZGFkVGpQUW81X0EwSzFsVnBRaTZKWlo2clBzWWhPSVBiUzl3NXlTMFYwNElSMlRrWlhta3BfOHczUdIBqgFBVV95cUxOSG9WaTFjT281VllzZlN5YmFtbVpHRlFJdlBGLTE1VHFWX25kM0tIbjFOLXlIN1JycS12RVpNTGo5YXRHZ0Y3YnlteGY0aWJfY09UUnR0OXhaZ3VnWkE3ZWFSS1dpLXJLd0pXeFlYNjlZMkpPWEdPanJfeV9JU2dpcGY1OFE3N3dsRF9sRFhteW1XSkZsM0lldnZ6MlVHZXhGUWFEXzdlNGIwZw",
"day": null
}
]Requests and billing
- Requests: 1 Web Access request per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
Yelp
Yelp business records, search by term and location, and business reviews.
Amazon
Amazon.com product search, category listings and product pages, optionally as a shopper at a US ZIP code, customer reviews by product, filtered by star rating and sorted top or most recent, top reviews from Amazon's other country stores, and public wish lists with their items.