Core APIs
...
Google
Core Requests

Search

3min

Google Search Results

DESKTOP TABLET MOBILE

SerpWow parses regular Google web search results when the search_type parameter is omitted.

Google Search Results
Google Search Results


Below is an example of how the Google Search results are represented in the SerpWow result JSON. Note that the example below is fictitious as there are too many different sections to the Google Search result to be included in one response:

JSON



SerpWow returns the following properties for search requests:

nProperty

Type

Description

organic_results

array

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

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



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



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



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



  • cached_page_link
  • string
  • A link to the Google web cache for this organic result, if shown.



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



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



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



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



  • about_this_result
  • object
  • The about_this_result property contains details from the About This Result popup for this organic result.
    • 

      Document image
      
    • 
      1. source
      2. object
      3. An object containing link , link and link string properties showing the website source detail from the About This Result popup.
    • 
      1. connection_secure
      2. object
      3. An object containing parsed boolean property which will be set to true when Google reports that the connection to this site is secure in the About This Result popup. Also contains a raw string property being the raw text shown.



  • rich_snippets
  • object
  • Rich Snippets Object An object containing the rich snippets shown under the organic search result: not present in mobile
    • 

      Document image
      
    • 
      1. top
      2. object
      3. An object containing a extensions string-array property containing the raw rich snippet extensions, a detected_extensions object showing any strongly-parsed known extensions (such as rating, reviews, price etc) and a attributes array containing name / value pairs for each of the attributes shown under the main rich snippet section.



  • sitelinks
  • object
  • Sitelinks Object An object containing the sitelinks shown next to the organic search result: not present in mobile
    • 

      Document image
      
    • 
      1. inline
      2. array
      3. An array of objects containing title and link properties being the title and link of the inline sitelink.
    • 
      1. expanded
      2. array
      3. An array of objects containing title , snippet (if shown) and link properties being the title and link of the expanded sitelink.



  • nested_results
  • array
  • An array of nested results listed indented under the main organic result, sometimes used by Google to display results from a subdomain of the main result.



  • block_position
  • number
  • The position of the organic_result relative to other page features shown.



ads

array

An array of Ads objects, containing each of the sponsored ads shown on the Google SERP. The Ad object has the following properties:

  • 

    Document image
    



  • position
  • number
  • The position of the ad result within the ads on the current page.



  • title
  • string
  • The title text of the ad.



  • tracking_link
  • string
  • The tracking link that is followed when the Ad is clicked.



  • displayed_link
  • string
  • The displayed (visual) link shown in the ad.



  • description
  • string
  • The descriptive text of the ad.



  • block_position
  • number
  • The position of the ad, relative to other page features shown.



  • relative_block_position
  • string
  • Can be set to top or bottom .

ai_overview

object

An object containing details of Google AI Overview ("AIO").

Note if you set the include_ai_overview=true request parameter, you will be charged an extra credit. If AIO is not returned, you will not be charged the extra credit.

  • 

    Paste an image link or upload your image
    or
    No image chosen
    



  • ai_overview_banner
  • string
  • The banner



  • ai_overview_contents
  • array
  • contents Array (header) An array containing the information shown in AIO.
    • 
      1. type
      2. string
      3. can be header
    • 
      1. text
      2. string
      3. contains the text of the header
    • 
      1. type
      2. string
      3. can be list
    • 
      1. list
      2. string
      3. list Array An array containing a list of text information shown in AIO.
        1. 
          1. text
          2. string
          3. contains text from the list



  • ai_overview_sources
  • array
  • contents Array (header) An array containing source information of citations
    • 
      1. source_title
      2. string
      3. title of the source
    • 
      1. source_description
      2. string
      3. description field from source
    • 
      1. source_url
      2. string
      3. url of source
    • -
      1. source_domain
      2. string
      3. domain of url
    • 
      1. source_image
      2. string
      3. a Base64-encoded image string.
    • 
      1. source_name
      2. string
      3. name of the source



answer_box

object

An object containing details of the "featured snippet" or "answer box" section of the SERP page.

Note if you set the include_answer_box=true request parameter then the link from the answer_box will be included at the start of the organic_results array. This is useful if you consider the answer box to contain the first "organic" result.

  • 

    Document image
    



  • answers
  • array
  • Answers Array An array containing the answers shown in the answer box section:
    • 
      1. answer
      2. string
      3. The text of the answer, if shown.
    • 
      1. rows
      2. array
      3. An array of strings containing the answers as rows where Google present the answers in a list.
    • 
      1. source
      2. object
      3. An object containing the source of the answer provided in the answer box. If the include_answer_box=true request parameter is set then the link provided in the source object is inserted as the first result in the organic_results array. The source object contains the following properties: link , displayed_link and title .



  • block_position
  • number
  • The position of the answer box, relative to other page features shown.



  • answer_box_type
  • number
  • A dynamically generated ID for the type of answer box shown, not that this ID is temporal and may change as new answer box types are found.

knowledge_graph

object

  • An object containing details of the "knowledge graph" section to the side of the SERP page.

    Document image
    





  • id
  • string
  • The knowledge graph ID, if shown. Can be used in the knowledge_graph_id request parameter to prompt this knowledge graph to display.



  • title
  • string
  • The title of the knowledge graph.



  • website
  • string
  • The website URL of the entity described in the knowledge graph.



  • type
  • string
  • The type of the knowledge graph.



  • description
  • string
  • The description of the knowledge graph.



  • source
  • object
  • An object containing name and link properties describing the source of the knowledge graph.



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



  • profiles
  • array
  • An array of objects containing a name and link property being the name and link to the social profile for the entity described in the knowledge graph.



  • people_also_search_for
  • array
  • An array of objects containing a name and link property being the name and link to "people also search for" data for the entity described in the knowledge graph.



  • known_attributes
  • array
  • An array of attributes from the knowledge graph.



  • block_position
  • number
  • The position of the knowledge graph, relative to other page features shown.



  • details
  • string
  • Hotel details.



  • amenities
  • array
  • An array of hotel amenities.



  • hours
  • array
  • An array of hours.



  • opening_hours
  • object
  • An object with additional parsing for hours.



  • order_food
  • array of objects
  • An order food object containing vendors where you can pick up or request delivery for the business
    • 
      1. pickup
      2. array
      3. vendors providing pickup options
        • 
          1. link
          2. string
          3. The URL where the pickup order can be placed
        • 
          1. platform
          2. object
          3. Platform details of the pikcup provider
            • 
              1. domain
              2. string
              3. the domain name of the platform
            • 
              1. name
              2. string
              3. the platform's display name
            • 
              1. image
              2. string
              3. A URl to the platform's image or logo
        • 
          1. text
          2. string
          3. Display text for the platform name
    • 
      1. delivery
      2. array
      3. vendors providing delivery options
        • 
          1. link
          2. string
          3. The URL where the delivery order can be placed.
        • 
          1. platform
          2. object
          3. Platform details of the delivery provider
            • 
              1. domain
              2. string
              3. the domain of. theplatform
            • 
              1. name
              2. string
              3. the platform's display name
            • 
              1. image
              2. string
              3. A URl to the platform's image or logo
        • 
          1. text
          2. string
          3. Display text for the platform name

search_refinement

object

An object containing details of the "search refinement" section at the top of the SERP page.

  • 

    Document image
    



  • items
  • array
  • Items Array An array containing the items in the search refinement:
    • 
      1. title
      2. string
      3. The title text of the search refinement item, if shown.
    • 
      1. link
      2. string
      3. The link of the search refinement item, if shown.
    • 
      1. block_position
      2. number
      3. The position of the search refinement item, relative to other page features shown.

local_map

object

An object containing details of the map displayed in the local results section of the Google SERP page.

  • 

    Document image
    



  • link
  • string
  • An link to a Google Places page for the locality.



  • gps_coordinates
  • object
  • An object representing the GPS coordinates of the local map, contains latitude , longitude and elevation number properties.



  • image
  • string
  • An image URL link, or Base-64 encoded image data, to the map image shown above the local results.

local_results

array

An array of Local Result objects containing details of the local results shown under the local map on the Google SERP page.

  • 

    Document image
    



  • position
  • number
  • The position of the local result in the local_results array.



  • title
  • string
  • The title of the local result, typically the business name.



  • address
  • string
  • The address of the local result, if shown.



  • link
  • string
  • A link to the local result business website, if shown.



  • data_cid
  • string
  • The cid of the place result. A CID is a unique identifier Google assigns to a specific businesses entity. Read more about Google cid 's here . Note The data_cid is used as a request parameter in Place Details and Place Products requests.



  • gps_coordinates
  • object
  • An object representing the GPS coordinates of the local result, contains latitude and longitude number properties.



  • price
  • string
  • A locale-specific string (i.e. "$$$") indicating the relative price of services offered by the business.



  • price_parsed
  • number
  • A numeric representation of the relative price of services offered by the business, ranging from 1 (inexpensive) to 5 (expensive).



  • price_description
  • string
  • A text representation of the relative price of services offered by the business, if shown. For example 'Inexpensive'.



  • rating
  • number
  • The customer rating the place has received, out of 5.



  • reviews
  • number
  • The number of customer reviews the place has received.



  • extensions
  • array
  • An array of strings being the extensions/services offered by the business, i.e. "Offers takeaway". not present in mobile



  • block_position
  • number
  • The relative position of this local result on the Google SERP page relative to other SERP features.

shopping_graphs

array

An array of Shopping Graph arrays representing the shopping elements on a page, if shown. A Shopping Graph object has the following properties:

  • 

    Document image
    



  • position
  • number
  • The position of the shopping element within the given shopping graph.



  • title
  • string
  • The title of the shopping element.



  • price
  • string
  • The price of the shopping element.



  • price_parsed
  • object
  • Price Parsed Object An object containing a parsed version of the item price.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the shopping item.
    • 
      1. regular_price
      2. string
      3. The rating assigned to the shopping element, if available.
    • 
      1. regular_price_parsed
      2. object
      3. regular price parsed object An object containing a parsed version of the regular_price
        • 
          1. symbol
          2. string
          3. The currency symbol, i.e. $ for USD.
        • 
          1. value
          2. number
          3. The price of the shopping item.



  • rating
  • number
  • The rating assigned to the shopping element, if available.



  • reviews
  • number
  • The reviews count given to the shopping element, if available.



  • image
  • string
  • The image of the shopping element, either returned as a URL to the image, or as a Base64-encoded image string.



  • stores_that_sell
  • string
  • The string on shopping element telling what stores cary the product, if available.

top_stories

array

An array of Top Story objects representing the "top stories" horizontally-scrolling carousel section, 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.

inline_tweets

array

An array of Inline Tweet objects, containing each of the inline tweets shown on the Google SERP. The Inline Tweet object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title text of the inline tweet.



  • link
  • string
  • The main tweet link shown - either to the tweet itself or the author.



  • status_link
  • string
  • A link to the tweet itself (as opposed to the author), if shown.



  • snippet
  • string
  • The inline tweet snippet text.



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



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



  • block_position
  • number
  • The position of the inline tweet, relative to other page features shown.

inline_recipes

array

An array of Inline Recipe objects, containing each of the inline recipes shown on the Google SERP. The Inline Recipe object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title text of the inline recipe.



  • link
  • string
  • The link to the recipe on the target website.



  • rating
  • number
  • The customer rating of the recipe, if shown, out of 5.



  • reviews
  • number
  • The number of customer reviews the inline recipe has received.



  • ingredients
  • array
  • An array of strings containing the ingredients in the recipe, if shown.



  • source
  • string
  • The name of the website on which the recipe is located.



  • total_time
  • string
  • The free-text description of the time taken to prepare the recipe.



  • image
  • string
  • A Base 64-encoded image showing the thumbnail image of the recipe.



  • block_position
  • number
  • The position of the inline recipe, relative to other page features shown.

inline_videos

array

An array of Inline Video objects, containing each of the inline videos shown on the Google SERP. The Inline Video object has the following properties:

  • 

    Document image
    



  • position
  • number
  • The position of the inline video within the inline videos section of the search results page.



  • title
  • string
  • The title text of the inline video.



  • length
  • string
  • The runtime/length of the inline video, if shown, expressed in the form hours.minutes.seconds .



  • source
  • string
  • The source name of the inline video.



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



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



  • link
  • string
  • The link navigated to when the inline video is clicked.



  • key_moments
  • array
  • An array of objects describing the Key Moments in the inline video. Each key moment object contains link , time and text string properties.



  • block_position
  • number
  • The position of the inline video, relative to other page features shown.

inline_images

array

An array of Inline Image objects, containing each of the inline images shown on the Google SERP. The Inline Images object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title text of the inline image.



  • image
  • string
  • An image URL, or Base 64 encoded image data, of the inline image.



  • link
  • string
  • The link navigated to when the inline image is clicked.



  • block_position
  • number
  • The position of the inline image, relative to other page features shown.

inline_shopping

array

An array of Inline Shopping objects, containing each of the inline shopping items shown on the Google SERP. The Inline Shopping object has the following properties:

  • 

    Document image
    



  • link
  • string
  • The link followed when the inline shopping item is clicked.



  • title
  • string
  • The title text of the inline shopping product.



  • string
  • The raw text price of the inline shopping item.



  • merchant
  • string
  • The name of the merchant.



  • position
  • number
  • The position of the inline shopping item within the inline shopping section of the search results page.



  • block_position
  • number
  • The position of the inline shopping item





  • relative_block_position
  • string
  • block_position can be either top or bottom .



  • visible_initially
  • boolean
  • Set to false when the inline shopping item is not visible on initial page load, and requires a horizontal scroll to bring in to view.



  • image
  • string
  • An image URL, or Base 64 encoded image data, of the inline shopping item image.



  • regular_price
  • string
  • The rating assigned to the shopping element, if available.



  • regular_price_parsed
  • object
  • Price Parsed Object An object containing a parsed version of the inline shopping item price.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the inline shopping item.





  • rating
  • number
  • The customer rating of the inline shopping item, out of 5.



  • feed_name
  • string
  • The feed name, if shown.



  • feed_link
  • array
  • The link to the feed.

explore_brands

array

An array of Explore Brands objects, containing each of the explore brands items shown on the Google SERP. The Explore Brands object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The brand name.



  • description
  • string
  • The descriptive text for the brand's product.



  • link
  • string
  • The link to the brand's product.



  • image
  • string
  • The image of the brand's product, either returned as a URL to the image, or as a Base64-encoded image string.



  • position
  • number
  • The position of the brand within the explore brands element.





  • block_position
  • number
  • The position of the explore_brands serp feature relative to other page features shown.

discussions_and_forums

array

An array of Discussions and Forums items, containing each of the results returned. The Discussions and Forums object has the following properties:

  • 

    Document image
    



  • discussion_title
  • string
  • The title of the discussions and forums item.



  • link
  • string
  • The link to the source of discussions and forums item.



  • source
  • object
  • An object describing the source, typically the site that the discussions and forums item was returned from. Contains source_title , domain , source_community , comments_count and time string properties, if shown.



  • block_position
  • number
  • The position of the Discussions and Forums, relative to other page features shown.

local_service_ads

array

An array of Local Service Ads objects, containing each of the local service ads items shown on the Google SERP. The Local Service Ad object has the following properties:

not present in mobile

  • 

    Document image
    



  • position
  • number
  • The position of the local service ad within the local service ads section of the search results page.



  • title
  • string
  • The title text of the local service ad.



  • link
  • string
  • The link followed when the local service ad is clicked.



  • is_google_guaranteed
  • boolean
  • Set to true when the "Google Guaranteed" badge is shown next to the local service ad.



  • extensions
  • array
  • An array of strings representing the local service ad extensions.



  • rating
  • number
  • The customer rating of local service ad, out of 5.



  • block_position
  • number
  • The position of the local_service_ad relative to other page features shown.



  • relative_block_position
  • string
  • Can be either top or bottom .

questions_and_answers

array

An array of the Questions & Answers objects, containing each of the results returned. The Questions & Answers object has the following properties:

  • 

    Document image
    



  • question
  • string
  • The text of the question.



  • answer
  • string
  • The text of the answer from the source.



  • source
  • object
  • An object describing the source (typically the site that the question and answer was returned from) of the question & answer, if shown. Contains link , domain and title string properties.



  • votes
  • object
  • The number of votes counted for the answer.



  • block_position
  • number
  • The position of Question & answers, relative to other page features shown.

related_questions

array

An array of Related Question objects, containing each of the related questions shown on the search results page - typically under the People also ask subheading. The Related Question object has the following properties:

  • 

    Document image
    



  • question
  • string
  • The text of the related question.



  • answer
  • string
  • The text of the related question answer.



  • answer_list
  • array
  • An array of strings where a list is presented in the related question answer.



  • source
  • object
  • An object describing the source (typically the site that the related question was returned from) of the related question, if shown. Contains link , displayed_link and title string properties.



  • search
  • object
  • An object describing the Google search that this related question links to, if shown. Contains link string property (being the Google search URL). not present in mobile



  • block_position
  • number
  • The position of the related question, relative to other page features shown.

related_searches

array

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

  • 

    Document image
    



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



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



  • block_position
  • number
  • The position of the feature relative to other page features shown.

scholarly_articles

array

An array of Scholarly Articles objects, containing each of the links from the scholarly articles shown at the top of the search results page (if present). The Scholarly Article object has the following properties:

  • 

    Document image
    



  • position
  • number
  • The position of the hotel within the list.



  • title
  • string
  • The title of the scholarly article..



  • link
  • string
  • A link to the article on Google Scholar.



  • cited_by_count
  • number
  • A cite-count for the Google Scholar article.



  • author
  • string
  • A author of the Google Scholar article as-shown next to the result.



  • block_position
  • number
  • The position of the scholarly article result, relative to other page features shown.

film_info

object

An object containing details of the film returned by the search query, if the search query was for a film:

  • 

    Document image
    



  • title
  • string
  • The title of the film.



  • subtitle
  • string
  • The subtitle of the film.



  • year
  • string
  • The release year of the film, if shown.



  • genre
  • string
  • The genre of the film, if shown.



  • length
  • string
  • The length of the film, if shown.



  • cast
  • array
  • An array of objects representing the cast members of the film. Each object in the array contains actor , character , link and image properties.



  • services
  • array
  • An array of objects representing the video-on-demand services providing this film. Each object in the array contains price (optional), link , title and link properties.



  • reviews
  • array
  • An array of objects representing the reviews this film. Each object in the array contains rating , source , description and link properties.

find_results_on

array

An object containing a list of websites that usually show up above the local-pack for Google UK searches, particularly for directory-type searches;

  • title
  • string
  • The title of result



  • source
  • string
  • The website source



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



  • position
  • number
  • The position of the website within the list.



  • link
  • string
  • The link followed when the website is clicked.



  • domain
  • string
  • The base domain of the link



  • block_position
  • number
  • The position of the courses feature relative to other page features shown.



ai_overview_included

boolean

Set to true if the AI Overview is generated on the search page results.

events

array

An array of Events objects, containing each of the events items shown on the Google SERP. The Events object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title text of the event.



  • link
  • string
  • The link followed when the event is clicked.



  • date
  • object
  • An object containing day_of_month number propertly, and month & text string properties showing the date of the event.



  • address
  • object
  • An object containing address1 , and address2 properties showing the address2 of the event.



  • image
  • array
  • The image of the event object, either returned as a URL to the image, or as a Base64-encoded image string.



  • block_position
  • number
  • The position of the inline shopping item, similar to the block_position of an Ad, an inline shopping items block_position can be either top or bottom .

popular_products

array

An array of Popular Products arrays representing the popular products elements on a page, if shown. A Popular Product object has the following properties:

not present in tablet



  • position
  • number
  • The position of the product element within the given popular products list.



  • title
  • string
  • The title of the product element.



  • price
  • object
  • Price Object An object that contains a parsed version of the item's price.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the product item.



  • regular_price
  • object
  • Regular Price Object An object that contains a parsed version of the item's regular price.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The regular price of the product item.



  • product_status
  • string
  • A status indicating whether the product is discounted, if available, i.e. 32% off or Low Price.



  • rating
  • number
  • The rating assigned to the product element, if available. Out of 5



  • reviews
  • number
  • The reviews count given to the product element, if available.



  • merchant
  • string
  • The main store that sells the product, if available.



  • stores_that_sell
  • array
  • A string array in the product element stating which stores sell the product, if available.

perspectives

array

An array of Perspectives representing the perspectives elements on a page, if shown. A Perspective object has the following properties:

not present in tablet

  • title
  • string
  • The title of the perspective element.



  • description
  • string
  • The description of the perspective element, if available.



  • source
  • string
  • The source of the perspective element.



  • link
  • string
  • The link of the perspective element.



  • date
  • string
  • The raw date of the perspective element.



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

jobs

array

An array of Jobs objects, containing each of the jobs items shown on the Google SERP. The Jobs object has the following properties:

not present in tablet

  • 

    Document image
    



  • title
  • string
  • The title of the job element.



  • position
  • number
  • The position of the job within the job list.



  • block_position
  • number
  • The position of the job feature relative to other page features shown.



  • company
  • string
  • The company offering the job as shown in the element.



  • source
  • string
  • The source website of the job element.



  • location
  • string
  • The location of the job.



  • posted
  • string
  • A short description of how long ago the job was posted, if shown.



  • salary
  • string
  • The salary offered by the job, if shown.



  • classification
  • string
  • The classification of the job - whether it is full-time, part-time, or contract.

apps

array

An array of Apps objects, containing each of the app items shown on the Google SERP. The Apps object has the following properties:

not present in tablet and desktop

  • 

    Document image
    



  • position
  • number
  • The position of the app within the app list.



  • block_position
  • number
  • The position of the app feature relative to other page features shown.



  • title
  • string
  • The title of the app.



  • price
  • string
  • The price of the app, if shown.



  • url
  • string
  • The url of the app.



  • description
  • string
  • The description of the app.



  • rating
  • number
  • The rating of the app on a 5 point scale.

short_videos

array

An array of Short Videos representing the short videos elements on a page, if shown. A Short video object has the following properties:

  • 

    Document image
    

not present in tablet and desktop

  • title
  • string
  • The title of the short video element.



  • source
  • string
  • The source of the short video element.



  • link
  • string
  • The link of the short video element.

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.

buying_guide

object

An array of buying_guide results related to the keyword. The buying_guide object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title of the buying guide



  • items
  • array
  • Items Array An array containing the dropdowns of the buying_guide:
    • 
      1. category
      2. string
      3. The title of the category
    • 
      1. categoryDetail
      2. string
      3. Question associated with category
    • 
      1. answer
      2. string
      3. Answer to the question



  • source
  • array
  • source array An array containing information regarding the source:
    • 
      1. link
      2. string
      3. link to the source
    • 
      1. domain
      2. string
      3. domain of the source
    • 
      1. displayed_link
      2. string
      3. The dispayed (visual) link shown
    • 
      1. title
      2. string
      3. The title of the source



  • related_search
  • array
  • related_search array An array containing information regarding the related_search:
    • 
      1. link
      2. string
      3. link to the related_search
    • 
      1. title
      2. string
      3. The title of the related_search

found_on_the_web

object

An array of found on the web results related to the keyword from sources across the web. The found on the web video object has the following properties:

  • 

    Document image
    



  • title
  • string
  • The title of the found on the web element.



  • image
  • string
  • The image of the brand's product, either returned as a URL to the image, or as a Base64-encoded image string.



  • position
  • string
  • The position of the found on the web element within the list



  • block_position
  • number
  • The position of the found on the web feature relative to other page features shown.



inline_hotels

object

An array of local results specifically for hotels.

  • 

    Document image
    



  • name
  • string
  • The title of the category



  • data_key
  • string
  • A description



  • rating
  • number
  • The rating assigned to the hotel, if available. Out of 5



  • reviews
  • number
  • The reviews count given to the product element, if available.



  • price
  • string
  • The raw text price shown for the top product



  • snippet
  • string
  • The snippet text of the hotel



  • type
  • string
  • hotel star rating, if available. Out of 5



  • amenities
  • array
  • an array of hotel amenities



  • deal
  • array
  • Items Array An array containing the items in the deal array:
    • 
      1. badget_text
      2. string
      3. The displayed badge
    • 
      1. text
      2. string
      3. The deal



  • position
  • number
  • The position of the hotel within the list.



  • block_position
  • number
  • The position of the inline_hotels to know result, relative to other page features shown.

things_to_know

object

An array of things to know object shown on the Google SERP page.

  • 

    Document image
    



  • category
  • string
  • The title of the category



  • category_detail
  • string
  • A description



  • answer
  • string
  • The answer to category_detail description, if shown



  • answer_list
  • array
  • A list related to the answer, if shown



  • source
  • array
  • Items Array An array containing the items in the search refinement:
    • 
    • 
      1. link
      2. string
      3. The link of the source, if shown.
    • 
      1. link
      2. string
      3. The link of the source, if shown.
    • 
      1. displayed_link
      2. string
      3. The displayed (visual) link, if shown.
    • 
      1. title
      2. string
      3. The title text of the source, if shown.



  • block_position
  • number
  • The position of the things to know result, relative to other page features shown.



flights



object

An array of with google flights information

  • 

    Document image
    



  • flight_results
  • array
  • flight_results array An array containing flight resultt:
    • 
    • 
      1. airline
      2. string
      3. The airline, if shown.
    • 
      1. duration
      2. string
      3. The duration of the flight, if shown
    • 
      1. price
      2. string
      3. The displayed price, if shown
    • 
      1. link
      2. string
      3. The link of the source, if shown
    • 
      1. type
      2. string
      3. The type of flight (i.e. non-stop), if shown
    • 



  • price_trend
  • array
  • price trend array An array containing price_trends:
    • 
    • 
      1. departure_date
      2. string
      3. The departure date of the flight, if shown.
    • 
      1. return_date
      2. string
      3. The return date of the flight, if shown
    • 
      1. price_from
      2. string
      3. The displayed price, if shown
    • 
      1. link
      2. string
      3. The link of the source, if shown
    • 
      1. type
      2. string
      3. The type of flight (i.e. non-stop), if shown



  • origin
  • string
  • The origin of the flight



  • destination
  • string
  • The destination. of the flight



  • departure_date
  • string
  • The departure date of the flight



  • block_position
  • number
  • The block position of the result



  • return_date
  • string
  • The return_date



  • flight_parameters
  • array
  • flight_parameters array An array containing flight parameters such as ticket type (i.e. economy), and if its a round trip flight.
    • 



stocks

object

An array of with stock information

  • 

    Document image
    



  • title
  • string
  • The company name



  • price
  • object
  • price trend array Contains information related to stock price and currency:
    • 
    • 
      1. current
      2. number
      3. The most recent stock price at the time of the response.
    • 
      1. currency
      2. string
      3. The currency in which the stock is priced.



  • snippet
  • string
  • A summary of the stock's recent performance, including teh change in value for the day



  • timestamp
  • string
  • The time at which the data was retrieved



  • table
  • object
  • table array A detailed summary of key stock statistics, including the following fields:
    • 
    • 
      1. open
      2. number
      3. The stock price at the opening of the trading session
    • 
      1. High
      2. number
      3. The highest price reached during the trading session
    • 
      1. Low
      2. number
      3. The lowest price reached during the trading session.
    • 
      1. Mkt Cap
      2. string
      3. The company's market capitalization, represented in trillions.
    • 
      1. P/E Ratio
      2. number
      3. The price-to-earnings ratio, indicating the stock price relative to earnings per share.
    • 
      1. Div yield
      2. string
      3. The dividend yield percentage, representing the annual dividend payments relative to the stock price.
    • 
      1. 52-wk high
      2. number
      3. The highest price the stock has reached in the last 52 weeks
    • 
      1. 52-wk low
      2. string
      3. The lowest price the stock has reached in the last 52 weeks



  • link
  • string
  • A URL that directs to the full stock summary/info page for further details



  • domain
  • string
  • The base domain of the link



  • graph
  • array of objects
  • graph array A array containing time-series data for the stock's performance over a specific period. Each object contains the value and date:
    • 
    • 
      1. value
      2. number
      3. The stock price at a given time
    • 
      1. date
      2. string
      3. The timestamp of the data point in ISO 8601 format

top_sights

object

An array of top sights information

  • 

    Document image
    



  • top_sights
  • array of objects
  • top_sights array of objects A list of top sightseeing locations with relevant details. Each object contains the following fields:
    • 
    • 
      1. position
      2. integer
      3. the rank of the sight in the list,
    • 
      1. title
      2. string
      3. The name. ofthe sightseeing location
    • 
      1. rating
      2. float
      3. the average user rating of the sight, out of 5
    • 
      1. reviews
      2. integer
      3. total number of user reviews the sight has received
    • 
      1. description
      2. string
      3. brief description of the location

sponsored_experiences

object

An array of sponsored experiences (Tickest & Tours)

  • 

    Document image
    





  • title
  • string
  • The title or name of the sponsored tour or experience



  • link
  • string
  • The link of the source, if shown



  • domain
  • number
  • The base domain of the link



  • block_position
  • number
  • The position of the sponsored tour or experience feature relative to other page features shown.



  • price
  • string
  • the cost of the epxerience, inclduing the currency symbol



  • source
  • string
  • the provider or platform offering the experience



  • rating
  • float
  • the average user rating of the experience, out of 5



  • reviews
  • string
  • total number of user reviews the experience has received



  • price
  • object
  • price object contains details about the price of the experience
    • 
    • 
      1. symbol
      2. string
      3. the currency symbol of the price
    • 
      1. value
      2. string
      3. the price of the experience in the given currency



  • description
  • string
  • short description or additional details about the experience, such. as cancellation policies or availability

carousel

object

An array with carousel (or multi-carousel) information that appears at the top of the serp page

  • 

    Document image
    



  • header header/title of carousel
  • object
  • header object details for items in the carousel
    • 
    • 
      1. title
      2. string
      3. the title of the item
    • 
      1. link
      2. string
      3. the link to the item
    • 
      1. image
      2. string
      3. The image of the carousel item, either returned as a URL to the image, or as a Base64-encoded image string.
    • 
      1. rating
      2. float
      3. the average user rating of the sight, out of 5
    • 
      1. duration
      2. string
      3. the duration of the movie/show
    • 
      1. year
      2. string
      3. the year the movie/show was released



  • position
  • number
  • The position of the carousel. position 1 wil be row 1 on the page.

courses

object

An array of course results. This is the dedicated carousel with course results related to the users query.:

  • 

    Document image
    



  • block_position
  • number
  • The position of the courses feature relative to other page features shown.



  • filters
  • string
  • The filter for the courses search result



  • items
  • array
  • Items Array An array containing information about each course dropdowns of the buying_guide:
    • 
      1. title
      2. string
      3. The title of the course
    • 
      1. platform
      2. string
      3. the platform the course is on
    • 
      1. link
      2. string
      3. link to the course
    • 
      1. domain
      2. string
      3. The domain of the link
    • 
      1. rating
      2. float
      3. the average user rating of the sight, out of 5
    • 
      1. reviews
      2. number
      3. total number of reviews
    • 
      1. pricing_model
      2. string
      3. i.e. free / paid
    • 
      1. duration
      2. string
      3. the length of the course
    • 
      1. description
      2. string
      3. course description
    • 
      1. syllabus
      2. string
      3. syllabus Array An array containing the syllabus to the coursek


Next Steps      Google Search Parameters

Updated 17 Dec 2024
Did this page help you?