Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google News

GET /google/v1/news
Test this endpoint

Google 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

NameTypeDescription
qrequiredstringSearch terms. Example: electric vehicles
timestringhour, day, week, month, year (or e.g. day_3). Example: week
date_fromstringFrom date, YYYY-MM-DD.
date_tostringTo date, YYYY-MM-DD.
sortdatedate for newest first (default relevance).
sourcestringOnly this publisher (as Google names it). Example: reuters
countrystringCountry code (gl), default us. Example: us
languagestringLanguage (hl), default en. Example: en
pageintegerPage number. Example: 1
limitintegerResults 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
$.adsarray
$.ai_overviewnull
$.cachedboolean
$.credits_usedinteger
$.featured_snippetnull
$.knowledge_panelnull
$.local_resultsarray
$.next_pageinteger
$.next_startinteger
$.pageinteger
$.pages_fetchedinteger
$.people_also_askarray
$.people_also_ask_detailarray
$.querystring
$.related_searchesarray
$.resultsarray
$.results[]object | string
$.results[].datestring
$.results[].docidnull
$.results[].google_linkstring
$.results[].hrefstring
$.results[].imagenull
$.results[].image_altnull
$.results[].landing_pagenull
$.results[].positioninteger
$.results[].pricenull | string
$.results[].sourcestring
$.results[].textstring
$.results[].titlestring
$.results[].urlnull
$.search_parametersobject
$.search_parameters.autocorrectboolean
$.search_parameters.countrystring
$.search_parameters.crnull
$.search_parameters.devicestring
$.search_parameters.filterboolean
$.search_parameters.google_domainstring
$.search_parameters.languagestring
$.search_parameters.limitinteger
$.search_parameters.locationstring
$.search_parameters.lrnull
$.search_parameters.qstring
$.search_parameters.safenull
$.search_parameters.startinteger
$.search_parameters.tbsnull
$.search_parameters.typestring
$.search_urlstring
$.spellingnull
$.top_storiesarray
$.totalnull
$.videosarray