Basic setup and customization options for scraping Google Shopping product pages.
Parameter
Description
Default Value
source
Sets the scraper.
google_shopping_product
query
UTF-encoded product code.
-
render
-
parse
false
callback_url
-
user_agent_type
desktop
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
Parameter
Description
Default Value
geo_location
-
domain
com
locale
-
context:
results_language
-
Structured data
Below you can find a structured output example for google_shopping_product.
Output data dictionary
HTML sample
JSON structure
The table below presents a detailed list of each product 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 product page.
string
title
The title of the product listing.
string
images
An object containing images of the product.
object
images.full_size
An array of URLs for full-sized images of the product.
array
images.thumbnails
An array of URLs for thumbnail images of the product.
array
pricing
An object containing online pricing information.
object
reviews
An object containing review information.
object
variants
An array of objects containing product variants.
array
highlights
An array of strings highlighting the key features of the product.
array
description
A detailed description of the product.
string
related_items
An array of objects containing related items.
array
specifications
An array of objects containing product specifications.
array
parse_status_code
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
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.
Pricing
An object containing pricing information for the product.
..."pricing": {"online": [ {"price":80,"seller":"Nordstrom","details":"Free delivery by Thu, Jun 13Free lifetime returns","currency":"USD","condition":"New","price_tax":8.2,"price_total":88.2, "seller_link": "/url?q=https://www.nordstrom.com/s/adidas-kids-samba-sneaker-baby-walker-toddler-little-kid-big-kid/7430299%3Fcolor%3DCORE%2BBLACK%252F%2BFTWR%2BWHITE%252F%2BGUM5%26size%3Dbig%2Bkid-6%2Bm%26country%3DUS%26currency%3DUSD%26utm_source%3Dgoogle%26utm_medium%3Dorganic%26utm_campaign%3Dseo_shopping%26utm_channel%3Dlow_nd_seo_shopping%26srsltid%3DAfmBOorl2CxT1AHFBVXT4_CSjY0tpFIQ7WROdRquaI_AZSBRdZUpmEnOi-k&opi=95576897&sa=U&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQ2ykIjAE&usg=AOvVaw1ZPuvWAp40Pbc3lhSjyTkh",
"price_shipping":0 },... ]},...
Key (pricing)
Description
Type
online
An array of objects containing details of online pricing for the product.
array
online.price
The price of the product in the specified currency.
integer
online.seller
The name of the seller or merchant offering the product.
string
online.details
Additional details about the purchase, such as delivery and return policies.
string
online.currency
The currency code for the product price.
string
online.condition
The condition of the product.
string
online.price_tax
The amount of tax applied to the product price.
integer
online.price_total
The total price of the product, including tax.
integer
online.seller_link
The URL to the seller's page for the product.
string
price_shipping
The shipping cost for the product.
integer
Reviews
An object containing reviews and ratings information for the product.
... "reviews": {"rating":4.7,"top_review": { "text": "I first found out about this shoe a while back when it started trending online. I held off on buying a pair because I wanted to make sure it wasn't a \"come and go\" trend that I would get tired of after a few months. However, after holding off, I still found myself wanting to grab a pair. I first purchased it in the adult size off of the Adidas Website in a Women's 7, but it was way too big. Lengthwise, I'm a 6.5, but sometimes I have to size up because my feet are wide. So, when the original pair from the Adidas website came in and I realized how big they were on me, I figured I could size down and get a kids size that looks exactly the same for a cheaper price. That's exactly what I did. So, I ended up ordering a size 5 in kids and it fits perfectly! Lengthwise, I could probably also get a 4.5 in kids, but it probably wouldn't fit so well in width. The 5 gives enough room where it's roomy but not too big. Initially, the shoe is pretty narrow, but even with my wide feet and bunions, it fits really well after a few wears. I was able to pretty much break them in after 2-3 wears. Now, they fit great and they go with everything. It's such a classic, low-profile shoe that can be dressed up or down. I could definitely wear these shoes with jean shorts on the weekend but also pair them with a midi-skirt for work during the week (which is exactly what I did). I honestly can't wait to start pairing these with so many looks!\u00a0Less",
"title":"Classic Shoe","author":"Faith","rating":5,"source":"finishline.com" },"rating_stars":4.5,"reviews_count":0,"reviews_by_stars": {"1": { "url": "/shopping/product/9643822540334825608/reviews?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=pid:10536581948450497165,rate:1,rnum:10,rsk:PC_10680952363545638615&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQn08IeSgE",
"reviews_count":27 },"2": { "url": "/shopping/product/9643822540334825608/reviews?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=pid:10536581948450497165,rate:2,rnum:10,rsk:PC_10680952363545638615&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQn08IeCgD",
"reviews_count":3 },"3": { "url": "/shopping/product/9643822540334825608/reviews?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=pid:10536581948450497165,rate:3,rnum:10,rsk:PC_10680952363545638615&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQn08IdygC",
"reviews_count":13 },"4": { "url": "/shopping/product/9643822540334825608/reviews?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=pid:10536581948450497165,rate:4,rnum:10,rsk:PC_10680952363545638615&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQn08IdigB",
"reviews_count":51 },"5": { "url": "/shopping/product/9643822540334825608/reviews?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=pid:10536581948450497165,rate:5,rnum:10,rsk:PC_10680952363545638615&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQn08IdSgA",
"reviews_count":530 } },"search_suggestions": []},...
Key(reviews)
Description
Type
rating
The average rating of the product, typically out of 5.
integer
top_review
An object containing details of the top review for the product.
object
top_review.text
The text content of the top review
string
top_review.title
The title of the top review.
string
top_review.author
The author of the top review.
string
top_review.rating
The rating given by the top review's author, typically out of 5.
integer
top_review.source
The source or website where the top review was posted.
string
rating_stars
The average rating of the product, typically out of 5 stars.
integer
reviews_count
The total number of reviews for the product.
integer
reviews_by_stars
An object containing the count of reviews for each star rating.
object
reviews_by_stars.url
An object containing details of X-star reviews.
string
reviews_by_stars.reviews_count
The count of X-star reviews.
integer
search_suggestions (optional)
An array containing search suggestions related to the product reviews.
object
Variants
An array of objects containing variant options for the product.
Returns parsed data when set to true. Explore output .
URL to your callback endpoint. .
Device type and browser. The full list can be found .
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 .
Domain localization for Google. The full list of available domains can be found .
Accept-Language header value which changes your Google search page web interface language. .
Results language. List of supported Google languages can be found .
The status code of the parsing job. You can see the parser status codes described .
The status code of the scraping job. You can see the scraper status codes described .