SERP API JSON Output

Bright Data SERP API solution collects SERP structured JSON data with added calculated fields, like rank and global rank, to help you understand an element's position.

In this article you will find the meaning of each JSON field and section.

Your search details: “general”

At the top of all JSON output you can find the “general” field which contains details about the search you ran which also include the results count from the response.

The following fields can be found in the “general” field

  • general.search_engine: the search engine used for the search.
  • general.query: the keywords used for the search.
  • general.results_cnt: the results count.

Note: Google doesn’t display results count for Mobile, thus this field is supported only with desktop search results.

  • general.search_time: the response time to get the results page.
  • general.language: the language that was set for the search, (Default: hl=en). 
  • general.location: the location that was targeted with the search,(based on the  “localization” and “geo-location” parameters). 
  • general.mobile: the device the search was performed with (desktop\mobile) 
  • general.basic_view: deprecated
  • general.search _type: the type of search that was set to the request. 
  • general.Page_title: results page title
  • general.Code_version: Bright data parser version
  • general.Timestamp: the time when the search executed
  • Input.original_url: the url used for the search, this url includes all parameters applied for the search.applied for the search.

Ranking

“Rank”- Indicates the location of the element in accordance with other urls in the SERP.

Sub links have their own ranking to better understand their order.

“global _rank” - Indicate the location of the element in accordance with all the elements in the SERP.

No results\ Did you mean: “spelling”

When search is inaccurate, Google suggests other search terms, these terms will show under the “spelling” field.

Fields:

  • Original_text: the text that was searched
  • Original_empty: true, means that no results were found.
  • Auto_corrected_link: link to suggested result
  • auto_corrected _text: the suggested link text
HTML JSON

 

Reviews\Rating

Some of the links in the SERPs include rating, reviews, etc .

HTML JSON

 

Site links: “extensions”

Some results could  include site sub links (AKA site links) that are displayed as a vertical list,

These sub links are located under “extensions” in the JSON and are also marked with “extended”:true

 

HTML JSON






 

Additional format to site links is when they’re displayed as an horizontal list,

In this format the sub links are located under “extensions” but aren’t marked with “extended”:true

 

HTML JSON

Breadcrumbs: “display_link”

HTML JSON

 

Organic results: “organic”

Main search results are called organic results and are located in the organic json node.

HTML JSON

 

Popular products

Popular/Related product results.

HTML JSON

 

Ads

Please note, If you wish the Search Engine Crawler to display ads in its results output you need to enable ads mode in your Search Engine Crawler zone.

Ads are located at the top of the page (top_ads) and the bottom of the page (bottom_ads)

“Top_ads” - Ads displayed at the top of the search results will be under “top_ads”in the JSON.

 

HTML JSON


Example for top ad with subresults

“top_pla” - In some cases the ads include a carousel that is displayed as top_pla in the JSON.

“Jackpot_pla” - The right side panel with shopping ads. It appears when some particular product matches your search perfectly.

“Bottom_ads” - Ads displayed at the bottom of the search results will be under “bottom_ads”in the JSON.

 

People also ask: “people_also_ask”

The “people also ask” section includes questions Google automatically generates based on queries it believes are related to your question.

Answers (“answers”)

In the SERP the PAA box questions are connected to answers that users can click to read. This can help people better understand their initial question without clicking on other results.

In the JSON answers are located under the people_also_ask element, each question has its answer under the “answers” element.

 

HTML JSON

 

Videos

HTML JSON

 

Top stories

HTML JSON

 

Knowledge Panel: “knowledge”

Provides a brief overview of the searched topic

In HTML format this SERP feature is located at the top right corner of SERPs with desktop and at the top in mobile devices.

HTML JSON

Widgets

Knowledge.widgets.social media presence  - include  profiles

Knowledge.widgets.sideways refinements - people also ask

 

Recipes

When search for foods the SERP might contain also recipes 

 

Maps

Google Maps is a Web-based service that provides detailed information about geographical regions and sites around the world. In addition to conventional road maps, Google Maps offers aerial and satellite views of many places. In some cities, Google Maps offers street views compromising photographs taken from vehicles.

“snack_pack_map” - This map part is displayed in the JSON as and includes the coordinates of the map location.

HTML JSON

“snack_pack” - If the map includes pins of specific locations the JSON will include a snack_pack field for each location with additional details like open hours, contact details, tags etc.

 

HTML JSON

 

Related searches: “related”

At the bottom of the SERPs, Google also provides users with a “related searches” portion, prompting other search queries related to the initial search.

HTML JSON

 

Note: 

  • List_group:true, when the elements are grouped as at the top of the following screenshot
  • List_group:false , when the elements aren’t grouped as at the bottom of the following screenshot

 

Flights

HTML JSON

 

Hotels

Bright Data’s SERP API makes it easy to collect hotel data, like prices, availability, reviews, and more. 

Here’s how to collect the data from the hotel knowledge graph using Google Search and how to get even more details from the hotel page on Google Travel. 

When you search for a hotel using Google Search, its details and reviews appear in the resulting knowledge graph.

Setting arrival and departure dates along with the number of guests lets you see and compare some of the hotel’s prices. 

With SERP API, you can set these fields to collect different price combinations using dedicated parameters. Go to the SERP API playground to learn more.

The SERP API also lets you target the hotel page in Google Travel, where you can find more prices and search by more parameters (including arrival and departure dates, the number of adults and children, the children’s ages, and whether or not it has free cancellation) to collect more price combinations. Go to the API Guide to learn more.

 

Pagination

HTML JSON

 

Pagination indexes can be found in the lowest JSON section:

  • current_page- is the requested page location within the search
  • first_page_link
  • prev_page_link and next_page_link - referring to requested page
  • prev_page_start and next_page_start - first searched results number in previous and next pages
  • prev_page and next_page- number of pages for previous and next pages
  • Page- page number
  • Link- link to page 
  • Start- first result in the page

Additional Fields:

JSON field Description
type The field type (site_link, text, rating, etc.)
title The text header, mostly the link text.
description The description under the link
referral _link Redirection link 
image This field can contain the image base64 string or the Image url
image_alt Image alternative name





 

 

 

Was this article helpful?