Core APIs
...
Google
Core Requests

Videos

3min

Google Video Results

DESKTOP TABLET MOBILE

VALUE SERP parses the Google video search results the video_results array in the JSON output when the search_type=videos search parameter is set.

Google Video Results
Google Video Results


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

JSON



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

Property

Type

Description

video_results

array

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

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



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



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



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



  • displayed_link
  • string
  • The displayed (visual) link shown next to the video result.



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



  • date_utc
  • string
  • The parsed date, in ISO 8601 format, of the video 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 video result.



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



  • length
  • string
  • The runtime of the video, expressed in the form minutes:seconds .

related_searches

array

An array of Related Search objects, containing each of the related video searches shown at the bottom of the video results page. The Related Search object has the following properties:

  • query
  • string
  • The keywords / search term of the related search.



  • link
  • string
  • A link to the Google search URL for the related search.

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 Video Parameters

Updated 13 Aug 2024
Did this page help you?