Google Search Scraper API is a tool that allows users to extract search data (SERP) from Google Search results in a structured format. The API returns a HTML or JSON object that contains the search results and additional metadata about the search or CSV.

HTML Example

JSON Structure

The JSON structure returned by the Google Search Scraper API includes required elements, such as request_info, search_parameters, search_metadata, search_information, pagination, as described in the Results SERP Google API section, as well as those specific to Google Search, which are described below.

ads - Google Ads Results

ads: An array containing information about the ads returned by the API.

position: The position of the ad on the search results page.
block_position: The position of the block that contains the ad on the search results page.
title: The title of the ad.
link: The URL of the landing page for the ad.
tracking_link: The URL of the tracking link for the ad.
domain: The domain of the landing page for the ad.
displayed_link: The displayed link for the ad.
description: The description of the ad.
sitelinks: An array of sitelinks for the ad, each containing a title, description, and link.

organic_results - Google Organic Results

Here is the description of the JSON parameters for each organic_result object:

position: the ranking position of the search result.
title: the title of the search result.
link: the URL of the search result.
domain : the domain of the search result URL.
displayed_link : the displayed URL of the search result, which may be different from the actual URL due to Google's redirection.
snippet: the snippet of the search result that appears under the title and URL in Google's search results page.
prerender: indicates whether the search result has been prerendered by Google. A prerendered result is a cached version of the page that may load faster than the actual page.
cached_page_link : the URL of the cached page for the search result, if available.
sitelinks: an object containing the sitelinks for the search result, if available. Sitelinks are additional links to specific pages within the same website as the search result.
- inline: an array of inline sitelinks, each of which contains a title and link.
- expanded: an array is made up of objects that include the title, snippet (if available), and link properties, which represent the title and link of the expanded sitelink.

about_this_result: an object containing information about the search result.
- source : an object containing information about the source of the search result.
- first_indexed: an object containing information about when the source was first indexed by Google.
  - raw : the raw text of the information.
  - parsed: the parsed value of the information.
- connection_secure : an object containing information about whether the connection to the search result website is secure.
  - raw : the raw text of the information.
  - parsed: the parsed value of the information.
- your_search_and_this_result: an array of strings containing information about how the search result relates to the user's search.
block_position: the position of the search result within its block on the search results page. A block is a group of related search results, such as those from the same website or those that match a specific query.
date: the raw date, if displayed, of the organic search result.
date_utc: the parsed date, in ISO 8601 format, of the organic search result. Note that successful parsing of the date relies on the API's ability to parse the date, and may not be guaranteed for all locales.
nested_results: an array of additional search results displayed indented under the main organic result. These results are often used by Google to show content from a subdomain of the main search result.
rich_snippets: an object containing the rich snippets displayed beneath the organic search result.
- top: an object containing a string-array property called "extensions" containing the raw rich snippet extensions, a detected_extensions object showing any strongly-parsed known extensions (such as rating, reviews, price, etc.), and an attributes array containing name or value pairs for each of the attributes displayed under the main rich snippet section.

top_stories - Google Top Stories

Here are the descriptions for each parameter in the top_stories JSON object:

link: The URL link to the article or content.
title: The title or headline of the article or content.
visible_initially: A boolean value indicating whether the content is visible initially or not.
source: The source or publisher of the content.
date: The date and time when the content was published, in a human-readable format.
date_utc: The date and time when the content was published, in a UTC format.
block_position: The position of the content in the block or section where it appears.
thumbnail: The image thumbnail associated with the content, encoded in Base64 format.
video: A boolean value indicating whether the content includes a video or not.
live: A boolean value indicating whether the content is currently live or not.

knowledge_graph - Google Knowledge Graph

Here is a description of each parameter in the knowledge_graph object:

id: a string value representing the unique identifier for the entity in the knowledge graph.
title: a string value representing the title or name of the entity in the knowledge graph.
type: a string value representing the type or category of the entity in the knowledge graph.
images: an array of image URLs or base64 encoded images that represent the entity in the knowledge graph.
website: a string representing the website URL of the entity described in the knowledge graph
description: a string representing the description of the knowledge graph
source: an object containing name and link properties describing the source of the knowledge graph
profiles: an array of objects containing a name and link property representing the social profile for the entity described in the knowledge graph
people_also_search_for: an array of objects containing a name and link property representing the "people also search for" data for the entity described in the knowledge graph
known_attributes: an array of attributes from the knowledge graph
block_position: a number representing the position of the knowledge graph relative to other page features shown
details: a string representing hotel details
amenities: an array of hotel amenities.

related_searches - Google Related Searches

Here is the description of each parameter related_searches object.

related_searches: an array of objects containing related search queries and links to Google search results.

query: The related search query.
link: The link to the Google search results page for the related search query.
type: The type of related search, such as group or standard.
group_name: The name of the group associated with the related search query (if applicable).

related_questions - Google Related Questions or People also ask

Here is the description of each parameter related_questions object.

related_questions: an array of related questions that are often displayed in the Google search results page along with the main query result.

question: the related question itself.
answer: the answer to the related question.
source: an object containing information about the source of the answer, including:
- link: the URL link to the source.
- displayed_link: the displayed URL link to the source.
- title: the title of the source webpage.
search: an object containing information about the Google search result that led to the related question and its answer, including:
- link: the URL link to the Google search result page.
- title: the title of the Google search result page.
block_position: the position of the related question block in the search result page.

inline_images - Google Inline Images

Parameter inline_images in the JSON refers to a list of inline images containing information about the images, their links, titles, and block positions. Each image is represented as a JSON object with the following parameters:

image: a string representing the URL of the image
link: a string representing the URL of the webpage that the image links to
title: a string representing the title or alt-text associated with the image
block_position: an integer representing the position of the block of text containing the image, typically used for layout purposes.

Parameter inline_image_suggestions in the JSON refers to a list of suggested image titles for the inline images that could be used as search keywords or tags to improve the search results. Each suggestion is represented as a JSON object with the following parameter:

title: a string representing the suggested title for the image.

inline_shopping - Google Inline Shopping

Here is a description of each parameter in the inline_shopping JSON:

link: A URL link to the product's page.
title: The name or title of the product.
price: The price of the product in the format of a string.
merchant: The name of the merchant or seller of the product.
position: The numerical position of the product within the shopping feed.
block_position: The position of the block where the product is located.
is_single_product: A boolean value indicating whether the product is a single item or a bundle.
visible_initially: A boolean value indicating whether the product is initially visible.
image: A base64 encoded image of the product.
regular_price: The regular price of the product in the format of a string.
regular_price_parsed: An object containing the symbol and numerical value of the regular price of the product.
price_parsed: An object containing the symbol and numerical value of the product's price.
feed_name: The name of the product as it appears in the feed.
feed_link: A URL link to the product's page as it appears in the feed.
rating: the customer rating of the inline shopping item, out of 5.

inline_recipes - Google Recipes Results

inline_recipes: An array of objects representing recipes that are displayed inline in the search results.

title: the title of the recipe.
link: the URL of the recipe.
source: the name of the website where the recipe was published.
ingredients: an array of strings representing the ingredients needed for the recipe.
rating: a number representing the rating of the recipe.
total_time: a string representing the total time needed to prepare the recipe.
image: a base64-encoded string representing the image of the recipe.
block_position: the position of the inline recipe, relative to other page features shown.

film_info - Google Film Info

Here is a description of each parameter in the film_info JSON object:

film_info: an object containing information about the film.

title: the title of the film.
subtitle: the subtitle of the film, which includes the rating, year of release, and genre.
year: A key representing the year of release of the film.
genre: A key representing the genre of the film.
length: A key representing the length of the film.
cast: A key representing an array of objects containing information about the cast members.
- actor: A key representing the name of the actor.
- character": A key representing the name of the character played by the actor.
- image: A key representing the image of the actor.
- link: A key representing the link to a website where additional information about the actor can be found.
services: An array of objects for the video-on-demand services offering the film, with properties including price (optional), link, title.
reviews: an array of objects representing the reviews for the film, with properties including rating, source, description, and link.
tabs: an array of objects representing the the tabs like Overview, Cast, Watch movie, Reviews, Trailers & clips, Quotes and others with properties including title and id.

answer_box - Google Answer Box

Here is a description of each parameter in the answer_box JSON object:

answer_box_type: an integer representing the type of answer box being displayed.
answers: an array of objects that contains the answer or/and type or/and formula or other types of answers of the answer box.
source: an array of objects that contains the link, displayed_link and title.
block_position: an integer representing the position of the answer box on the page.

scholarly_articles - Google Scholarly Articles

Here is a description of each parameter in the scholarly_articles JSON object:

scholarly_articles: an array of scholarly articles returned by the API.

title: the title of the scholarly article.
link: a link to the scholarly article.
cited_by_count: the number of articles that cite this scholarly article.
author: the author of the scholarly article.
block_position: the position of the scholarly article within the block of results returned by the API.

local_map - Goolge Local Map

Here is a description of each parameter in the local_map JSON object:

local_map: an object containing details of the map displayed in the local results section of the Google SERP page.

link: A hyperlink to a Google Places page for the location, where users can access more information about the place, such as contact information, reviews, and photos.
gps_coordinates: The geographical coordinates of the location shown on the map, consisting of latitude, longitude, and altitude.
latitude: The north-south coordinate of the location on the Earth's surface, measured in degrees from the equator.
longitude: The east-west coordinate of the location on the Earth's surface, measured in degrees from the prime meridian.
altitude: The vertical coordinate of the location, measured in meters above sea level.
image: A static image of the map displayed in the local results section of the Google SERP page, encoded in base64 format.

local_results - Google Local Results

Here is a description of each parameter in the local_results JSON object:

local_results: an array of objects containing details of local businesses that match the search query.

position: the position of the business in the local search results.
title: the title of the business.
data_cid: a unique identifier associated with the business.
extensions: an array of information about the business, including its name, rating, location, phone number, hours, and available services.
rating: the rating of the business, on a scale of 1 to 5.
reviews: the number of reviews that the business has received.
block_position: the position of the block containing the local search results on the Google SERP page.
local_results_more_link: a link to view more local results for the search query.
address: the physical address of the local result, displayed if available.
link: a link to the business website of the local result, if available.
gps_coordinates: An object that contains the precise geographical location of the local result, including latitude and longitude numeric values.
price: a string that shows the approximate price range of the services provided by the business, represented by locale-specific symbols, such as "$$$".
price_parsed: a numeric representation of the relative price range of services provided by the business, ranging from 1 (least expensive) to 5 (most expensive).
price_description: a text representation of the relative price range of services provided by the business, displayed if available. For example, "Inexpensive".

inline_tweets - Google Inline Tweets

The JSON object contains a parameter named inline_tweets which is an array of objects. Each object in the inline_tweets array has the following parameters:

link: a string parameter that contains the URL link to the tweet.
status_link: a string parameter that contains the URL link to the tweet status.
title: a string parameter that contains the Twitter handle and username of the tweet owner.
date: a string parameter that contains the time elapsed since the tweet was posted in a human-readable format.
date_utc: a string parameter that contains the UTC timestamp of when the tweet was posted in ISO 8601 format.
snippet": a string parameter that contains the snippet text of the tweet if available.
block_position: an integer parameter that contains the position of the tweet block in the API response.

inline_podcasts - Google Inline Podcasts

Here is a description of each parameter in the inline_podcasts JSON object. Each Inline Podcast object contains the following properties:

title: The title of the inline podcast episode.
podcast: The title of the inline podcast.
date: The raw text date of the inline podcast.
duration: The text-representation of the length of the inline podcast.
link: A link to the inline podcast.
block_position: The position of the inline podcast, relative to other page features shown.

inline_videos - Google Inline Videos

The inline_videos object is an array of Inline Video objects that represent the inline videos shown on the Google SERP. Each Inline Video object has the following properties:

position: a number that indicates the position of the inline video within the inline videos section of the search results page.
title: a string that represents the title text of the inline video.
length: a string that shows the runtime/length of the inline video, expressed in the form hours.minutes.seconds, if it is displayed.
source: a string that shows the source name of the inline video.
date: a string that shows the raw date, if displayed, of the inline video result.
date_utc: a string that shows the parsed date of the inline video result in ISO 8601 format. Note that date parsing relies on the API being able to successfully parse the date and isn't guaranteed in all locales.
link: a string that shows the link navigated to when the inline video is clicked.
key_moments: an array of objects that describes the Key Moments in the inline video. Each Key Moment object contains link, time, and text string properties.
block_position: a number that indicates the position of the inline video relative to other page features shown.

top_carousel - Google Top Carousel

JSON object describing the top_carousel section at the top of the SERP page:

category: the category or title of the top carousel, if displayed.
items: an array of top carousel items.
- title: the title text of the top carousel item, if displayed.
- subtitle: the sub-title text of the top carousel item, if displayed.
- link: the link of the top carousel item, if displayed.
- block_position: the position of the top carousel item, relative to other page features shown.

top_products - Google Top Products

Here is a description of each parameter in the top_products JSON object. Each top_products object contains the following properties:

title: the title text of the top product
link: the link followed when the top product item is clicked, usually to a Google search result page for the top product
price: the raw text price shown for the top product
rating: the rating the top product has received, out of 5
sources: an array containing details of website sources providing content/reviews for this top product result, with each item having the following properties:
- name: the name of the source
- link: a link to the source
- title: the title text of the source content
- snippet: the snippet text of the source content, if shown
specifications: an array containing name/value pairs of the specifications of the top product, with each item having the following properties:
- name: the name of the specification
- value: a value of the specification
block_position: the position of the top product item, relative to other features on the SERP page.

local_service_ads - Google Local Service Ads

Here is a description of each parameter in the local_service_ads JSON object. Each local_service_ads object contains the following properties:

position: the position of the local service ad within the local service ads section of the search results page.
title: the title text of the local service ad.
link: the link followed when the local service ad is clicked.
is_google_guaranteed: indicates whether the "Google Guaranteed" badge is shown next to the local service ad.
extensions: an array of strings representing the local service ad extensions.
rating: the customer rating of local service ad, on a scale of 1 to 5.
block_position: the position of the local service ad within the SERP, either "top" or "bottom". Not present for mobile devices.