Site integrations
Google News
Google News search with date, country and language filters, read from the RPC news.google.com's own search page calls.
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.0 - 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. | 1.05× its requests |
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: Listed as
multiplier, 1.05× the cost of the requests it makes, billed as one charge. This is the listed default; your plan can set its own price. Per-action pricing isn't live yet: until it is, a call bills as its requests. See Billing.