Shopping Product
The google_shopping_product
source is designed to retrieve Google Shopping product page for a specified product.
Request samples
In the code example below, we make a request to retrieve the product page for product ID 5007040952399054528
from Google Shopping on com
domain.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_shopping_product",
"domain": "com",
"query": "5007040952399054528",
"parse": true
}'
We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.
Request parameter values
Generic
Basic setup and customization options for scraping Google Shopping product pages.
source
Sets the scraper.
google_shopping_product
query
UTF-encoded product code.
-
user_agent_type
Device type and browser. The full list can be found here.
desktop
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
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.
-
locale
Accept-Language
header value which changes your Google search page web interface language. More info.
-
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.
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
product_details_keywords
An array of strings containing keywords extracted from the product details.
array
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
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
},
...
]
},
...
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": []
},
...
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.
...
"variants": [
{
"type": "Size",
"items": [
{
"value": "1",
"available": true,
"product_id": "14855470651354119759"
},
{
"value": "1\u00bd",
"available": true,
"product_id": "5671387020715674519"
},
{
"value": "2",
"available": true,
"product_id": "1029961476587819050"
},
...
],
...
type
The type of variant.
string
items
An array of objects containing details of each variant item.
array
items.value
The value of the variant option
string
items.available
A boolean indicating whether the variant option is available (true) or not (false).
boolean
items.product_id
A unique identifier for the product variant.
string
Related Items
An array of objects containing related items for the product.
...
"related_items": [
{
"items": [
{
"url": "/shopping/product/16479871209744499300?uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&prds=epd:10860789321621480519,oid:10860789321621480519,pid:6998593240514241486,prmr:1,rsk:PC_11355485667075104643&sa=X&ved=0ahUKEwjG8LquqNOGAxXbDhAIHRQMB2AQ2sgCCPEB",
"image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcQpQuG5H0h5YM8gR0Hcw6c_RCpNdXX7h6TbSRn8oyEMDajHyn6btJ8NdvoaUQX0mHauB9Tyyam3D3j803Bn-kggu9FniPdP1252_ayDDp2CvshV91x7u9X7&usqp=CAY",
"price": 90,
"store": "adidas",
"currency": "USD",
"reviews_count": 0
},
...
],
"title": "You might also like"
}
],
...
items
An array of objects containing details of each related item.
array
items.url
The URL to the related product page.
string
items.image
The URL of the related product's image.
string
items.price
The price of the related product in the specified currency.
integer
items.title
(optional)
The title of the related product listing.
string
items.rating
(optional)
The average user rating of the related product, typically out of 5.
integer
items.store
(optional)
The name of the store or merchant offering the related product.
string
items.currency
The currency code for the product price.
string
items.reviews_count
The total number of reviews for the related product.
integer
title
The title or heading for the related items section
string
Specifications
An array of objects containing specification details for the product.
...
"specifications": [
{
"items": [
{
"title": "Product Type",
"value": "Casual Shoes"
},
{
"title": "Color",
"value": "Black/White"
},
{
"title": "Shoe Size",
"value": "6"
}
],
"section_title": "General"
}
],
...
items
An array of objects containing individual specification details.
array
items.title
The title of the specification.
string
items.value
The value of the specification.
string
section_title
The title or heading for the section of specifications.
string
Product details keywords
An array of strings containing keywords extracted from the product details section.
"product_details_keywords": [
"premium leather upper",
"classic 3-stripes",
"textile branding",
"lace closure",
"cushioned insole",
"synthetic lining",
"gum rubber outsole",
"sticky grip"
]
The product_details_keywords
field provides a structured list of key product features and characteristics extracted from the product details section. These keywords make it easier to filter, compare, and analyze products based on their specific attributes without having to parse the full description text.
Last updated
Was this helpful?