Skip to content

Google Shopping Scraper can scrape and parse various Google Shopping page types to collect structured e-commerce data.

Notifications You must be signed in to change notification settings

oxylabs/google-shopping-scraper

Repository files navigation

Google Shopping Scraper

Oxylabs promo code

In this tutorial, we'll demonstrate how to extract data from Google Shopping. In the first part of the tutorial, we'll use a free tool, built for smaller scale scraping. In the second part, we'll show how to use Oxylabs API for more effective, bigger scale scraping. To use Oxylabs API, get a free trial here.

Free Google Shoppping Scraper

A free tool used to get shopping items from Google Shopping for a provided search query.

Prerequisites

To run this tool, you need to have Python 3.11 installed in your system.

Installation

Open up a terminal window, navigate to this repository and run this command:

make install

Scraping Google Shopping

To scrape shopping items from Google Shopping, simply run this command in your terminal with a query of your choosing:

make scrape QUERY="<your_shopping_search_query>"

For this example, let's try scraping Google Shopping results for cat food. The command should look something like this:

make scrape QUERY="cat food"

Make sure to enclose your query in quotation marks, otherwise the tool might have trouble parsing it.

After running the command, your terminal should look something like this:

image

After the tool has finished running, you should see a file named shopping.csv in your current directory.

This file contains shopping listings for the query you entered. The generated CSV file contains these columns of data:

  • title - The title of the item.
  • price - The price of the item.
  • delivery_price - The delivery price of the item.
  • review - An optional review field, which can contain a rating of up to 5 stars, and a total number of reviews.
  • url - The URL of the Google Shopping page for that item.

Here's an example of how the data can look like:

image

Notes

In case the code doesn't work or your project is of bigger scale, please refer to the second part of the tutorial. There, we showcase how to scrape public data with Oxylabs API.

Scraping Google Shopping with Oxylabs API

Google Shopping Scraper extracts timely e-commerce data in raw HTML or structured JSON format. The scraper offers a maintenance-free data collection infrastructure that automates the bulk of underlying processes, from sending HTTP requests to data parsing.

The underlying measures, such as proxies, ensure considerably fewer CAPTCHAs and IP blocks. The scraper supports localized results from almost any locale worldwide (195 countries) with country-level and postal code targeting.

Additionally, the scraper can automate recurring scraping and parsing jobs through Scheduler, load dynamic websites that use JavaScript for rendering content, and retrieve results via the API or directly to Google Cloud Storage or Amazon S3 storage bucket.

Keep in mind that to access this tool, you'll need an active subscription – a paid plan or a free 7-day trial. You can claim your trial via our self-service dashboard.

How it works

There are various page types we can scrape and parse on Google Shopping. You can either provide us with a full URL or a few input parameters via specifically built data sources (e.g. Search, Product, Product Pricing so we can form the URL on our end.

Overview

Below is a quick overview of all the available data source values we support with Google Shopping.

Source Description Structured data
google Submit any Google Shopping URL you like. Depends on the URL.
google_shopping_search Search results for a search term of your choice. Yes.
google_shopping_product Product page of a product ID of your choice. Yes.
google_shopping_pricing List of offers available for a product ID of your choice. Yes.

URL

The google source is designed to retrieve content from various Google Shopping URLs. Instead of sending multiple parameters and letting us form and scrape Google Shopping URLs, you can provide us with a URL to the required Google Shopping page. We do not strip any parameters or alter your URLs in any other way.

This data source also supports parsed data (structured data in JSON format), as long as the URL submitted links to a page that we can parse.

Query parameters

Parameter Description Default Value
source Data source. More info. google
url Direct URL (link) to Google page -
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. -
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. -
parse true will return parsed data, as long as the URL submitted is for Google Search. -

- required parameter

Python code example

In this example, we make a request to retrieve a Google Shopping Search result for keyword adidas, as seen in New York, USA.

import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'google',
    'url': 'https://www.google.com/search?tbm=shop&q=adidas&hl=en',
    'geo_location': 'New York,New York,United States'
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Instead of response with job status and results url, this will return the
# JSON response with results.
pprint(response.json())

Code examples for other languages can be found here.

Shopping Search

The google_shopping_search source is designed to retrieve Google Shopping search results.

Query parameters

Parameter Description Default Value
source Data source. More info. google_shopping_search
domain Domain localization com
query UTF-encoded keyword -
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. -

context:
nfpr

true will turn off spelling auto-correction. false

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 -

- required parameter

Python code example

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.

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_shopping_search',
    'domain': 'com',
    'query': 'adidas',
    'pages': 4,
    'context': [
        {'key': 'sort_by', 'value': 'pd'},
        {'key': 'min_price', 'value': 20},
    ],
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Code examples for other languages can be found here.

Shopping Product

The google_shopping_product source is designed to retrieve Google Shopping product page for a specified product.

Query parameters

Parameter Description Default Value
source Data source. More info. google_shopping_product
domain Domain localization com
query UTF-encoded product code -
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

Python code example

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

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_shopping_product',
    'domain': 'com',
    'query': '5007040952399054528',
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Code examples for other languages can be found here.

Product Pricing

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

Query parameters

Parameter Description Default 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

Python code example

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.

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_shopping_pricing',
    'domain': 'com',
    'query': '5007040952399054528',
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Code examples for other languages can be found here..

If you have questions or concerns about Google Shopping Scraper or associated features, get in touch via (support@oxylabs.io) or through the live chat on our website.

Read More Google Scraping Related Repositories: Google Sheets for Basic Web Scraping, How to Scrape Google Shopping Results, Google Maps Scraper, Google Play Scraper, How To Scrape Google Jobs, Google News Scrpaer, How to Scrape Google Scholar, How to Scrape Google Flights with Python, How To Scrape Google Images, Scrape Google Search Results, Scrape Google Trends

Also, check this tutorial on pypi