Product Pricing

The google_shopping_pricing source is designed to retrieve pages containing lists of offers available for a product ID of your choice.

Code examples

In the code example below, we make a request to retrieve the product pricing page for product ID 5007040952399054528 from Google Shopping on google.com.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_shopping_pricing", 
        "domain": "com", 
        "query": "5007040952399054528",
        "parse": true
    }'

The example above uses the Realtime integration method. If you would like to use some other integration method in your query (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

Query parameters

ParameterDescriptionDefault Value

source

Data source. More info.

google_shopping_pricing

domain

Domain localization

com

query

UTF-encoded product code

-

start_page

Starting page number

1

pages

Number of pages to retrieve

1

locale

Accept-Language header value which changes your Google Shopping page web interface language. More info.

-

results_language

Results language. List of supported Google languages can be found here.

-

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.

-

user_agent_type

Device type and browser. The full list can be found here.

desktop

render

Enables JavaScript rendering. More info.

callback_url

URL to your callback endpoint. More info.

-

parse

true will return parsed data.

-

- required parameter

Structured data

Below you can find a structured output example for google_shopping_pricing.

Output data dictionary

HTML example

JSON structure

The table below presents a detailed list of each element we parse, along with its description and data type. The table also includes some metadata.

KeyDescriptionType

url

The URL to the product page on Google Shopping.

string

title

The title of the product.

string

rating (optional)

The average user rating of the product, typically out of 5.

integer

pricing

An array of objects containing pricing information from different sellers.

array

pricing.price

The price of the product in the specified currency.

integer

pricing.seller

The name of the seller offering the product.

string

pricing.details

Additional details about the purchase, such as delivery and return policies.

string

pricing.currency

The currency code for the product price.

string

pricing.condition

The condition of the product, typically "New" or "Used".

string

pricing.price_tax

The amount of tax applied to the product price.

integer

pricing.price_total

The total price of the product, including tax.

integer

pricing.seller_link

The URL to the seller's page for the product.

string

pricing.price_shipping

The shipping cost for the product.

integer

review_count (optional)

The total number of reviews for the product.

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

Last updated