API Response

Ads Results

Scrape real time ads from Google Search.As stated in the Response section, some Google searches may include ads, others may not. Depending on the scenario, if our Google Scraper API identifies ads in the search results, these will be included in the ads array inside the response body.Each ad inside the array will be displayed as an object, containing the following keys:

Element	Type	Description
position	Integer	The position of the ad
block_position	String	Position of the ad relative to the DOM. Can be top or bottom.
title	String	The title of the ad
displayed_link	String	The displayed link in the results
description	String	Description of the ad
tracking_link	String	The tracking link from google ads
link	String	Link to the ad

Answer Box Results

Get instant Google Answers using the Google Scraping APISometimes if you make certain queries (i.e. currency conversion, math equations) in your Google search will result in an instant answer from Google, displayed inside a specific box, on top of the results.If available, the content of this box will be displayed inside the answer_box array which includes:

Element	Type	Description
type	String	Type of answer box (calculator, organic result, converter, etc.)
result	String	The actual answer, when the answer box can be inlined.

Event Results

Scrape Google events straight from the Google Events Page.If the google engine identifies events on the main Google Search Page, they will be automatically parsed and displayed in the events array inside the response. Each event will be contained inside an object and will include the following keys:

Element	Type	Description
title	String	The title of the event
date	Object	Event dates
start_date	String	-- The start date of the event
when	String	-- The range when the event will take place
address	String	An array of strings that complete the address of the event
link	String	Link of the event
thumbnail	String	The thumbnail of the event base64 encoded
position	Integer	The position in the results

Image Results

Scrape images from Google and get the results in a JSON format.The google engine allows users to set the type of search to be image (via the tbm parameter). When you scrape Google Images using the Google Search API, you will be provided with the following data:

Element	Type	Description
image_suggested_searches	Array	Array of suggested images found on the main Google Page
name	String	-- Name of the image suggested search
image	String	-- Query string of the image suggested search
link	String	-- Link of the image suggested search
image_results	Array	Array of image results
image	String	-- base64 encoded image
link	String	-- Link where the image was found
source	String	-- Link of the website where the image was found
title	String	-- Title of the image

Inline Images Results

Get image results straight from the regular Google Search page.There are instances in which Google will show images on their main search page. If they are available, our scraper will include them in the response, under the inline_images array. Every scraped image will be shown as an object with the following keys:

Element	Type	Description
position	Integer	The position of the image
link	String	Link to the image on google
thumbnail	String	Link to the thumbnail of the image

People Also Search For Results

Scrape what others are searching for and get to know your market better.Google suggests search queries based on what an user searches for. The results are usually displayed under the 'People also ask' section. If our Google scraper comes across this container, its content will be included under the people_also_search_for array. The objects inside the array will display the following:

Element	Type	Description
link	String	String from google of the search
name	String	The name of the search
image	String	Base64 encoded image of the search

Shopping Results

Scrape what other companies are selling on Google.Based on your query, Google Search may display a shopping container with various items that are being sold on other e-commerce websites. If these results are available on the page, the Google Scraper API will parse them and they will be returned under the shopping_results section of the response body. Each shopping item will be displayed as an Object and will include:

Element	Type	Description
position	Integer	The position of the result
block_position	String	The position in the page of the result. Can be top for example
source_link	String	Link to the source
source	String	Name of the source
title	String	Title of the page
price	String	The price
extracted_price	Double	The numerical value of the price
extensions	Array	List of strings with the extensions
link	String	Querystring to access on Google
vendor_link	String	Link to the vendor
thumbnail	String	The thumbnail image base64 encoded

Knowledge Graph Results

Get instant descriptions of items by scraping the Google Knowledge Graph.The Knowledge Graph is a special Google container that displays general information about the term that you searched for. If the container is available, the response from our API will include the knowledge_graph key, which is comprised of:

Element	Type	Description
title	String	Title of the graph
type	String	Type of the graph (i.e Currency)
header_images	Array	Array of images inside the graph
link	String	-- Link to the image
google_link	String	-- Google images link
image	String	-- Base64 encoded image

Local Pack Results

Scrape place on Google and get information about available locations.Searching for a place on the main Google Search may sometimes display a map with available locations. In this case, our scraping API returns two arrays:

Element	Type	Description
local_map	Object	Local map object
link	String	-- Link to upper Google map
image	String	-- Displayed image encoded in base64
gps_coordinates	Object	-- GPS coordinates object
latitude	Double	-- -- Latitude position
longitude	Double	-- -- Longitude position
altitude	Integer	-- -- Altitude of location
local_results	Array	Local results array
more_locations_link	String	-- Link to discover more locations from same place
places	Array	-- Places array
position	Integer	-- -- Position of the place inside the container
place_id	String	-- -- Google ID of the place
rating	Integer	-- -- Location rating on Google Maps
title	String	-- -- Location title or name
links	Object	-- -- Links object
website	String	-- -- -- Location website
directions	String	-- -- -- Location directions
address	String	-- -- Location address
phone	String	-- -- Phone number from location

News Results

Scrape the News displayed on the Google Search page.Certain Google queries may result in Google displaying a special container including news. If that is the case, the Google Search Scraping API response body will have a news_results key available. Each article in the news container will be displayed as an object under news_results and the keys for each object are:

Element	Type	Description
source	String	The name of the source of the result
title	String	The title of the story
snippet	String	A snippet extract from the story
date	String	Time of publishing
link	String	Link to the story
thumbnail	String	Thumbnail of the story base64 encoded
position	Integer	The position in the box

Pagination

Discover the number of pages available on a Google search.Each API call returns Google results scraped from one page. In order for you to have a better look over the length of the search result, the response body will include a special key, named pagination which holds information about the page you scraped and its 'neighbours':

Element	Type	Description
other_pages	Object	Lists the rest of the pages with the key set as the page number and the value as the page link
next	String	Link to the next page
current	Integer	The value of the current page

Product Results

Scrape Google Product Results and get real time information on product specifications.Sometimes if you search for a product, Google may return product boxes with more information about your search. To access this information you can use the product_results property of the API response. The full body of the property includes:

Element	Type	Description
title	String	Product title
reviews	Integer	Total number of reviews
rating	Float	Product score based on customer's rating
description	String	Product description
manufacturer	String	Product manufacturer
link	String	Link to product
name	String	Name of seller
user_reviews	Object	Reviews left by users
popular_questions	Array	-- Questions asked by Google users

Organic Results

Scrape Google Search and get all the organic results in a JSON format.Each basic Google search returns a number of organic results. Only exceptional keywords end up without any results from Google. In the Google Search API, all organic results are grouped under the organic_results key and include the following elements:

Element	Type	Description
title	String	Title of the scraped Google result
link	String	Link to the result
displayed_link	String	Linked displayed on the Google search page
snippet	String	Description of the result
position	Integer	Result position on page

Recipes Results

Scrape recipes from the Google Search Results.When searching for keywords such as 'pancakes', Google may display a special container with multiple recipes related to your query. In this case, our scraper will parse that data and include each recipe inside the recipe_results array. The values extracted for each recipe available on the page are:

Element	Type	Description
title	String	Title of the receipe
link	String	Link to the recipe
source	String	Name of the source of the recipe
rating	Double	Average rating of the recipe
reviews	Integer	Number of reviews
total_time	String	Total time to prepare the recipe
ingredients	Array	List of string with ingredients
thumbnail	String	Thumbnail of the recipe base64 encoded

Related Questions Results

Scrape questions related to your Google query.When you are asking a question on Google, chances are that Google will suggest some related questions as well. To access these related questions you can use the related_questions property from the API response. Each related question we scrape from Google is contained inside an object with the following properties:

Element	Type	Description
link	String	Query-string to link to the Google page
question	String	Text of the question

Related Searches Results

Scrape Google Related Searches and expand your area of research.When you perform a search on Google you may sometimes get some related searches along with the results as well. You can retrieve these related searches through the related_searches property from the API response. The properties of each related search results are:

Element	Type	Description
link	String	Query-string to link to the Google page
query	String	Text of related search

Spell Check

Know when Google fixes your spelling mistakes.If you misspell your query term for a Google search, Google will show up a message to inform you about it. Information regarding misspelled queries can be found inside the search_information property, under spelling_fix. The full body of the search_information property contains:

Element	Type	Description
organic_results_state	String	The state of the results
total_results	Integer	The total number of results
time_taken_displayed	Double	Time in seconds displayed by Google to show the results
query_displayed	String	The query displayed
showing_results_for	String	The query that the results are from
spelling_fix	String	Spelling fix recommendation from Google

Sports Results

Scrape sports results by simply querying Google.If you're searching for a sports team or person, and they recently participated in a competition, Google usually returns a box showing the results of that team or person. Our scraper automatically picks up these results and sends it to you inside the sport_results property from the API response. The structure of this property is made of:

Element	Type	Description
title	String	Title of the sports restults container
league	String	The league
games	Array	Games played by the team or player in question

Top Carousel Results

Scrape Google Top Carousel results and get more data from your query.Google might sometimes display a list of results for common query terms on top of the search page. This list can be found in the top_carousel property. The body of each result inside the top_carousel array includes:

Element	Type	Description
link	String	Link to the google page for that specific element
image	String	Base64 encoded image displayed on the top carousel element
name	String	Name of the element inside the carousel
extensions	Array	More data found inside the carousel's body.

Top Stories Results

Scrape all available top stories from the Google Search Page.Searching for a topic that is 'in demand' usually results in Google displaying a 'Top stories' container on the page. If this container is available, our scraper will return the top_stories property which contains:

Element	Type	Description
link	String	Link to the story
title	String	Title of the story
Source	String	The website that released the story
date	String	The date when the story was published
thumbnail	String	Base64 encoded image related to the story

Twitter Results

Scrape popular tweets right from the Google search results.Google prioritises popular tweets and, if for example you are searching for a Twitter account, Google may display the latest tweets of that account in a special box. If available, our scraper will parse these tweets and they can be accessed via the inline_tweets property from the API response. The full body of this object contains:

Element	Type	Description
view_on_twitter_link	String	Twitter link to the queried account
twitter_handle	String	Google displayed name of the account
twitter_link	String	Google related link to the account
tweets	Array	Array of tweets
tweet	String	-- Tweet body
link	String	-- Link to specific tweet
position	Integer	-- Position of the tweet inside the tweets container
published_date	String	-- Date when the tweet was published

Video Results

Scrape videos displayed on the Google Search page.Specific keywords may trigger Google's video engine. In this scenario, Google may display video results instead of text based results. When the Google Search Scraping API detects video elements on the results page, it parses them alongside other organic results, under the organic_results property.

Product Results

Scrape Google Product Results and get real time information on product specifications.The body of the Google Product Results response includes:

Element	Type	Description
product_results	Object	Details found on the product main container
title	String	Product title
reviews	Integer	Total number of reviews
rating	Float	Product score based on customer's rating
description	String	Product description
extentions	Array	Product extentions
highlights	Array	Product highlights
prices	Array	A list with shown prices for the product
typical_prices	Object	Product typical prices, it shows in what range the price is
low	String	​
high	String	​
shown_price	String	​
media	Array	An array with media elements that contain the product
type	Sring	Type of the media element
link	String	Link tot the resource
seller_results	Object	Details about product sellers
online_sellers	Object	​
position	Int	The position where the product was found
name	String	Name of the seller
link	String	Link to the seller
additional_details	String	Additional details about the seller's offer
base_price	String	Base price of the product
additional_price	Object	Shows why is a difference (if any) between the base_price and the total_price
shipping	String	Shipping fee value
tax	String	Tax value
total_price	String	Total price of the product
reviews_results	Object	Details about product reviews and ratings
ratings	Object	This product ratings breakdown
stars	Int	Number of stars
amount	Int	How many ratings have this number of stars
reviews	Array	A list with reviews of this product
position	Int	The position of the review
date	String	The date when the review was published
rating	Int	Rating the of the review
source	String	Source of the review
content	String	Contents of the review
images	Array	A list with all the images found on the review
related_products	Array	A list with related_products
position	Int	The position of the related product
title	String	​
link	String	​
thumbnail	String	​
price	String	​
rating	String	​
reviews	Int	How many reviews has the product
specs_results	Object	An object with all the specifications found on the product. The keys of this element are generated from DOM

Offers Results

Scrape Google Product Offers Results and get real time information on product buying choices.The body of the Google Product Offers Results response contains:

Element	Type	Description
product_results	Object	Details found on the product main container
title	String	Product title
reviews	Integer	Total number of reviews
rating	Float	Product score based on customer's rating
type	Sring	Type of the media element
seller_results	Object	Details about product sellers
online_sellers	Object	​
position	Int	The position where the product was found
name	String	Name of the seller
link	String	Link to the seller
additional_details	String	Additional details about the seller's offer
base_price	String	Base price of the product
additional_price	Object	Shows why is a difference (if any) between the base_price and the total_price
shipping	String	Shipping fee value
tax	String	Tax value
total_price	String	Total price of the product
related_products	Array	A list with related_products
position	Int	The position of the related product
title	String	​
link	String	​
thumbnail	String	​
price	String	​
rating	String	​
reviews	Int	How many reviews has the prod

Specs Results

Scrape Google Product Specs Results and get real time information on product specifications.The body of the Google Product Specs Results response contains:

Element	Type	Description
product_results	Object	Details found on the product main container
title	String	Product title
reviews	Integer	Total number of reviews
rating	Float	Product score based on customer's rating
description	String	Product description
extentions	Array	Product extentions
specs_results	Object	An object with all the specifications found on the product. The keys of this element are generated from DOM

Reviews Results

Scrape Google Product Reviews Results and get real time information about product reviews and ratings.The body of the Google Product Reviews Results response includes:

Element	Type	Description
product_results	Object	Details found on the product main container
title	String	Product title
reviews	Integer	Total number of reviews
rating	Float	Product score based on customer's rating
reviews_results	Object	Details about product reviews and ratings
ratings	Object	This product ratings breakdown
stars	Int	Number of stars
amount	Int	How many ratings have this number of stars
reviews	Array	A list with reviews of this product
position	Int	The position of the review
date	String	The date when the review was published
rating	Int	Rating the of the review
source	String	Source of the review
content	String	Contents of the review
images	Array	A list with all the images foun