Core APIs
...
Google
Core Requests

News

3min

Google News Results

DESKTOP TABLET MOBILE

VALUE SERP parses the Google news search results the news_results array in the JSON output when the search_type=news search parameter is set.

If you wish to exclude news results where Google have modified the original query set exclude_if_modified=true in your request parameters.

Google News Results
Google News Results


Below is an example of how Google News results are represented in the VALUE SERP result JSON:

JSON



VALUE SERP returns the following properties for search_type=news requests:

Property

Type

Description

news_results

array

An array of News Result objects, containing each of the news results returned. The News Result object has the following properties:

  • position
  • number
  • The position of the news result on the current page.



  • title
  • string
  • The title of the news result.



  • link
  • string
  • A link to the news result.



  • domain
  • string
  • The domain of the link to the news result.



  • source
  • string
  • The source / publication name of the news result.



  • date
  • string
  • The raw date, if shown, of the news result.



  • date_utc
  • string
  • The parsed date, in ISO 8601 format, of the news result. Note that date parsing relies on the API being able to successfully parse the date and isn't guaranteed in all locales.



  • snippet
  • string
  • The snippet text of the news result.



  • thumbnail
  • string
  • The thumbnail image of the news result, either returned as a URL to the image, or as a Base64-encoded image string.

top_stories

array

An array of Top Story objects representing the "top stories" horizontally-scrolling carousel section of the news result page, if shown. The Top Story object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title of the top story result.



  • link
  • string
  • A link to the top story result.



  • visible_initially
  • boolean
  • true if the top story is visible on page load, false if the top story requires a horizontal scroll of the Top Stories carousel for it to come in to view.



  • source
  • string
  • The source / publication name of the top story.



  • date
  • string
  • The raw date, if shown, of the news result.



  • date_utc
  • string
  • The parsed date, in ISO 8601 format, of the news result. Note that date parsing relies on the API being able to successfully parse the date and isn't guaranteed in all locales.



  • thumbnail
  • string
  • The thumbnail image of the top story result, either returned as a URL to the image, or as a Base64-encoded image string.



  • video
  • boolean
  • true when the top story is video format and false when not.



  • live
  • boolean
  • true when the top story is live video and false when not.



  • block_position
  • number
  • The position of the top story carousel, relative to other page features shown.

pagination

object

An object containing details of the pagination section of the page. Details are provided as Google links and API links (to make sending paginated requests easier):

  • current
  • number
  • The current page number, if shown.



  • next
  • string
  • The Google URL of the next page of results.



  • other_pages
  • object
  • An object containing details of the other pages shown on the results page. The object is keyed by the other page number, with the value being the Google URL to the page.



  • api_pagination
  • object
  • An object containing API links to request the next pages of results. Provided as a convenience to allow you to run subsequent requests for additional pages. Contains a next and other_pages property.


Next Steps      Google News Parameters

Updated 13 Aug 2024
Did this page help you?