Understanding Results

Response fields

Field	Meaning
`job_id`	UUID for this lookup
`catalog_id`	Catalog ID that was requested
`product`	Catalog ID plus title, brand, and image URLs when available
`sellers`	Seller offers in Google's order
`sellers_count`	How many offers are in `sellers`
`sellers_total`	Google's stated store count when the page shows one. It can differ from the full list by one to three stores. Missing or `null` means Google gave no count.
`more_stores_pages`	How many "More stores" expansions returned a page
`complete`	`true` if the list is full, `false` if it stopped early, `null` or missing if unknown
`attempts`	How many attempts were made for the lookup

Product object

Field	Meaning
`catalog_id`	Google catalog ID
`title`	Product title when available
`brand`	Brand when available
`images`	Image URLs Google hosts (can be empty)

Seller coverage

Read complete on its own. A missing sellers_total does not tell you if the list is complete. Matching or differing counts alone also do not.

A partial list means the lookup stopped before the end. That can happen when you hit the more_stores limit, run out of time, or Google refuses a later expansion. The sellers already returned are still usable. If the limit was the reason, try again with a higher more_stores.

When complete is null or missing, use the offers you got and treat overall coverage as unknown.

Example	`sellers_count`	`sellers_total`	`more_stores_pages`	`complete`
Four stores returned and the list is complete	`4`	`4`	`1`	`true`
Expansion limit reached with more offers available	`3`	`4`	`0`	`false`
Expansion limit reached and Google gave no total	`3`	`null`	`0`	`false`
Completeness unknown and Google gave no total	`4`	`null`	`1`	`null`
Google reports five stores, but completeness is unknown	`4`	`5`	`1`	`null`

Seller offer fields

position starts at 1. shown is page for an offer on the initial product page and more_stores for an offer from an expansion. In the latter case, more_stores_page starts at 1.

Fields	Meaning
`name`, `domain`, `title`, `link`	Store name, store domain, the store's listing title, and its product URL
`price`, `currency`, `original_price`, `discount`	Current price, ISO currency, previous price, and discount wording when available
`delivery_price`, `total_price`	Delivery cost and price including delivery. `0` means free delivery. Missing delivery cost means unknown.
`installment`	Monthly offers may include `monthly_price`, `months`, and optional `down_payment`. A monthly offer can have no one-time `price`.
`in_stock`, `condition`, `delivery`, `returns`	Availability when known, condition for used or refurbished goods, and delivery or return wording
`store_rating`, `store_reviews`	Store rating out of 5 and review count
`promotion`, `tag`, `details`, `payment_methods`	Promotion info, Google badge, extra store details, and payment methods

Optional seller fields can be absent or null. Lists can be empty. Keep unknown amounts, delivery cost, or availability distinct from 0 or false.

Billing

A returned product uses one request from your Google Shop Light allowance, whether the list is complete, partial, or of unknown completeness. Seller count and more_stores do not change the charge. Failed lookups are free.