← API Store
Search & SEOGoogle
Google News
GET /google/v1/newsGoogle News results: title, source, date, snippet, thumbnail and link, with time range, date sort and source filters; every /google/v1/search parameter also applies.
Every response includes credits_used: the credits this call cost. limit (up to 100) loads one results page per 10 results and is charged per page, like /google/v1/search.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search terms. Example: electric vehicles |
time | string | hour, day, week, month, year (or e.g. day_3). Example: week |
date_from | string | From date, YYYY-MM-DD. |
date_to | string | To date, YYYY-MM-DD. |
sort | date | date for newest first (default relevance). |
source | string | Only this publisher (as Google names it). Example: reuters |
country | string | Country code (gl), default us. Example: us |
language | string | Language (hl), default en. Example: en |
page | integer | Page number. Example: 1 |
limit | integer | Results wanted. Example: 20 |
Every endpoint also takes: raw、fields、fresh、output、records
{
"ads": [],
"ai_overview": null,
"cached": false,
"credits_used": 1,
"featured_snippet": null,
"knowledge_panel": null,
"local_results": [],
"next_page": 2,
"next_start": 10,
"page": 1,
"pages_fetched": 1,
"people_also_ask": [],
"people_also_ask_detail": [],
"query": "nvidia source:reuters",
"related_searches": [],
"results": [
{
"date": "3 days ago",
"docid": null,
"google_link": "https://www.google.com/goto?url=CAESwQEB6zswFVKu9QKqu2L1mJcgZ10V9TePLx_cUxS7Wj6BwAU-kbvgRonGh32_ZPUHfV9P3IP_GFuPSCzPJ6__g-EBRDUOo7Jl5p8wIqhE…",
"href": "/goto?url=CAESwQEB6zswFVKu9QKqu2L1mJcgZ10V9TePLx_cUxS7Wj6BwAU-kbvgRonGh32_ZPUHfV9P3IP_GFuPSCzPJ6__g-EBRDUOo7Jl5p8wIqhEX06Ml6_U5d3FPzcD1c1mdB…",
"image": null,
"image_alt": null,
"landing_page": null,
"position": 1,
"price": "$35",
"source": "Reuters",
"text": "Reuters EXCLUSIVE: ByteDance, Alibaba, Tencent place over $35 billion worth of Nvidia chip orders Oct 20 (Reuters) - ByteDance, Alibaba and …",
"title": "EXCLUSIVE: ByteDance, Alibaba, Tencent place over $35 billion worth of Nvidia chip orders",
"url": null
},
{
"date": "4 days ago",
"docid": null,
"google_link": "https://www.google.com/goto?url=CAESxAEB6zswFeUkL-D9FxjM0SMymcVlbPZ8CPKUIcKWmW30vNDtX9EWD13QXAjErYL8RyJnPfviD4F5DLFT17bdL8ajxprUljfUMtvUaZTQ…",
"href": "/goto?url=CAESxAEB6zswFeUkL-D9FxjM0SMymcVlbPZ8CPKUIcKWmW30vNDtX9EWD13QXAjErYL8RyJnPfviD4F5DLFT17bdL8ajxprUljfUMtvUaZTQ7VGp04p4euabFXj1UgElfd…",
"image": null,
"image_alt": null,
"landing_page": null,
"position": 2,
"price": null,
"source": "Reuters",
"text": "Reuters Amazon says its AI chips will work with popular coding language, challenging Nvidia SAN FRANCISCO, Oct 19 (Reuters) - Amazon.com (AM…",
"title": "Amazon says its AI chips will work with popular coding language, challenging Nvidia",
"url": null
},
"… 8 more"
],
"search_parameters": {
"autocorrect": true,
"country": "us",
"cr": null,
"device": "desktop",
"filter": true,
"google_domain": "google.com",
"language": "en",
"limit": 10,
"location": "United States",
"lr": null,
"q": "nvidia source:reuters",
"safe": null,
"start": 0,
"tbs": null,
"type": "news"
},
"search_url": "https://www.google.com/search?q=nvidia+source%3Areuters&hl=en&gl=us&uule=w%2BCAIQICINVW5pdGVkIFN0YXRlcw&tbm=nws",
"spelling": null,
"top_stories": [],
"total": null,
"videos": []
} Response fields (52)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.ads | array |
$.ai_overview | null |
$.cached | boolean |
$.credits_used | integer |
$.featured_snippet | null |
$.knowledge_panel | null |
$.local_results | array |
$.next_page | integer |
$.next_start | integer |
$.page | integer |
$.pages_fetched | integer |
$.people_also_ask | array |
$.people_also_ask_detail | array |
$.query | string |
$.related_searches | array |
$.results | array |
$.results[] | object | string |
$.results[].date | string |
$.results[].docid | null |
$.results[].google_link | string |
$.results[].href | string |
$.results[].image | null |
$.results[].image_alt | null |
$.results[].landing_page | null |
$.results[].position | integer |
$.results[].price | null | string |
$.results[].source | string |
$.results[].text | string |
$.results[].title | string |
$.results[].url | null |
$.search_parameters | object |
$.search_parameters.autocorrect | boolean |
$.search_parameters.country | string |
$.search_parameters.cr | null |
$.search_parameters.device | string |
$.search_parameters.filter | boolean |
$.search_parameters.google_domain | string |
$.search_parameters.language | string |
$.search_parameters.limit | integer |
$.search_parameters.location | string |
$.search_parameters.lr | null |
$.search_parameters.q | string |
$.search_parameters.safe | null |
$.search_parameters.start | integer |
$.search_parameters.tbs | null |
$.search_parameters.type | string |
$.search_url | string |
$.spelling | null |
$.top_stories | array |
$.total | null |
$.videos | array |