Google Shop Light Workflows

Typical workflow

1. Send POST /v1/google/shopping/product with a catalog ID or a Google Shopping product link.
2. Read product and sellers in the same response.
3. Check complete, sellers_count, and sellers_total if you care how full the store list is.

Shop Light is synchronous. You do not poll for a job.

What you get

One request returns the product (title, brand, images when Google has them) and seller offers as a US shopper sees them in English. The first stores come from the product page. Extra stores come from Google's "More stores" button, up to your more_stores limit.

Plan

Google Shop Light has its own subscription and request allowance. It is not the same plan as Google Search Light, general Search, or Extract.

Common patterns

Catalog ID

Pass catalog_id as a string (5 to 25 digits). Quote it so long IDs stay exact.

Product URL

Pass a Google Shopping product url that contains prds=catalogid:<id>. The API takes only the catalog ID from the link.

Initial offers only

Set more_stores to 0 if you only want the stores shown on the product page (usually up to three).

Wider seller list

Leave more_stores at the default 3, or raise it (max 15). Each expansion can add up to ten stores. Asking stops when the list ends.