Core APIs
...
Google
Core Requests

Search

19min

Google Search Results

DESKTOP TABLET MOBILE

Scale SERP 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 Scale SERP 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



A Complete Guide to /search JSON response

At the beginning of the JSON response, you'll find request_info, search_metadata, search_parameters, and organic_results fields, which provides information about your search query.

request_info

contains information on he request's success status, credit status and remaining credits available

search_parameters

Lists the parameters used for the search, such as the query term and search engine

search_metadata

Contains information on the API request’s success status, credit usage, and the remaining credits available

organic_results

Contains organic search results listing relevant links, titles, and other details related to the search query



Explanation of Additional Fields:

The other fields in the JSON response vary based on the content available on the page being parsed. Each field dynamically reflects the specific elements found on the page, providing relevant details based on what was retrieved from the search.







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.



  • price
  • string
  • The price for services/goods of a business, if shown. Multiple formats are supported: price level ($, $$, etc), price ($10), price estimate ($10+), and price range ($10-20)



  • 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
    • 
      • delivery
      • array
      • 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









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.



  • prerender
  • boolean
  • Indicates whether the server returns a pre-rendered version of the content



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









shopping_graphs

array

not supported for device=mobile

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.



Next Steps      Google Search Parameters

Updated 11 Mar 2025
Did this page help you?
PREVIOUS
Specifications
NEXT
News
Docs powered by Archbee