The google_shopping_search source is designed to retrieve Google Shopping search results.
Request samples
In this example, we make a request to retrieve the first 4 pages of Google Shopping search for the search term adidas, sorted by descending price and minimum price of $20.
Device type and browser. The full list can be found here.
desktop
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
Parameter
Description
Default Value
geo_location
The geographical location that the result should be adapted for. Using this parameter correctly is extremely important to get the right data. For more information, read about our suggested geo_location parameter structures here.
-
domain
Domain localization for Google. The full list of available domains can be found here.
com
locale
Accept-Language header value which changes your Google search page web interface language. More info.
-
context:
results_language
Results language. List of supported Google languages can be found here.
-
Pagination
Controls for managing the pagination and retrieval of search results.
Parameter
Description
Default Value
start_page
Starting page number.
1
pages
Number of pages to retrieve.
1
Filtering
Advanced options for tailoring and refining the search context.
Parameter
Description
Default Value
context:
sort_by
Sort product list by a given criteria. r applies default Google sorting, rv - by review score, p - by price ascending, pd - by price descending.
r
context:
min_price
Minimum price of products to filter.
-
context:
max_price
Maximum price of products to filter.
-
Other
Additional advanced settings and controls for specialized requirements.
Parameter
Description
Default Value
context:
nfpr
true will turn off spelling auto-correction.
-
Context parameters
All context parameters should be added to the context array as objects with key and value pairs, e.g.:
..."context": [ {"key":"filter","value":"0" }]...
Structured data
Below you can find a structured output example for google_shopping_search.
Output data dictionary
HTML example
JSON structure
The table below presents a detailed list of each search page element we parse, along with its description and data type. The table also includes some metadata.
Key
Description
Type
url
The URL to the Google Shopping search page for the query.
string
page
The current page number of the search results.
integer
results
An object containing detailed search results.
object
pla (optional)
A list of product listing ads with their respective details.
array
filters (optional)
List of various filters.
array
organic
A list of unpaid listings with their respective details.
array
search_information
A list of details for the submitted search query.
object
search_information.query
The original search term.
string
search_information.showing_results_for
The search term the search results are shown for. `query` and `showing_results_for` may differ if Google auto-corrected the provided search term.
string
last_visible_page
Value identifying the maximum page number visible in the search query results page. (-1 when loading of more results is initiated by scrolling).
integer
parse_status_code
The status code of the parsing job. You can see the parser status codes described here.
integer
created_at
The timestamp when the scraping job was created.
timestamp
updated_at
The timestamp when the scraping job was finished.
timestamp
status_code
The status code of the scraping job. You can see the scraper status codes described here.
integer
job_id
The ID of the job associated with the scraping job.
string
In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.
Paid Listing Ads
An array of objects containing Product Listing Ads (PLA) for the product.