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.

Parameter
Description
Default Value

source

Sets the scraper.

google_shopping_product

query

UTF-encoded product code.

-

render

Enables JavaScript rendering when set to html. More info.

-

parse

Returns parsed data when set to true. Explore output data dictionary.

false

callback_url

URL to your callback endpoint. More info.

-

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.

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.

-

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

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.

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.

...
"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"
            },
...
        ],
...
Key (variants)
Description
Type

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

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"
    }
],
...
Key(related_items)
Description
Type

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"
    }
],
...
Key (specifications)
Description
Type

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

Last updated