Getting Started with Google Shop Light

Use Google Shop Light to look up a product on Google Shopping and compare the stores that sell it. One request returns the product details and seller offers shown to shoppers in the United States.

Before you begin

You need:

A Geonode API key
An active Google Shop Light subscription
A Google catalog ID or a Google Shopping product URL

If you have not done the initial setup yet, see Quick Start Guide.

Make your first request

Send a POST request to the Google Shop Light endpoint.

POST /v1/google/shopping/product

Set GEONODE_API_KEY in your shell to your API key. Keep the key on your server or in your local shell, not in client-side code.

Example with catalog ID

curl -X POST \
  'https://scraper.geonode.io/v1/google/shopping/product' \
  -H "X-Api-Key: $GEONODE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "catalog_id": "11018290803738983204",
    "more_stores": 3
  }'

Example with product URL

If you have a Google Shopping product link, send the URL instead. The API reads the catalog ID from the link.

{
  "url": "https://www.google.com/search?ibp=oshop&q=+&prds=catalogid%3A11018290803738983204"
}

The product page shows the first few stores (usually up to three), or all of them if there are fewer. Each "More stores" expansion can add up to ten. Set more_stores to 0 for only the initial offers. The default of 3 allows up to three expansions.

Example response

The response comes back in the same HTTP call. Read product for the item and sellers for its offers in Google's order. This sample shows a product with one seller. Prices and availability can change.

{
  "job_id": "1ebcb6e0-2219-4a93-8e00-db56c66d0b4e",
  "catalog_id": "11018290803738983204",
  "product": {
    "catalog_id": "11018290803738983204",
    "title": "Moen 24 in. Towel Bar",
    "brand": "Moen",
    "images": []
  },
  "sellers": [
    {
      "position": 1,
      "shown": "page",
      "more_stores_page": null,
      "name": "Home Depot",
      "domain": "homedepot.com",
      "price": 29.98,
      "currency": "USD",
      "delivery_price": 0,
      "total_price": 29.98,
      "in_stock": true
    }
  ],
  "sellers_count": 1,
  "sellers_total": 1,
  "more_stores_pages": 0,
  "complete": true,
  "attempts": 1
}

sellers_count is how many stores came back. sellers_total is the count Google shows, when it shows one. Those two can differ by one to three stores. Missing or null total means Google gave no count.

Read complete separately. true means the list is complete. false means the lookup stopped early. Missing or null means completeness is unknown. You can still use the offers that came back. A lookup can stop early when it hits your more_stores limit, runs out of time, or Google refuses a later expansion.

Usage

Each successful product lookup uses one request from your Google Shop Light monthly allowance. The charge is the same for a partial list or unknown completeness, for any more_stores value. Failed requests are free.