Google Shopping API

Searches Google Shopping for a product query in a country and delivers listings with price, currency, seller, rating and the Google product id (feed it to Product offers for the per-seller offer list). Paginates until max_results.

$0.001 per delivered listing, up to 100 listings per run. Nothing delivered means nothing charged.

Inputs

• query (string, required) — e.g. "wireless earbuds", "nike air max 90".
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• lang (string) — Interface language (hl), e.g. en, it, de.
• max_results (integer) — How many listings to deliver at most (1–100). You pay only for delivered listings.

What one listing looks like

• rank (integer) — 1-based position across pages.
• title (string) — Listing title.
• link (string, nullable) — Merchant / Google link.
• product_link (string, nullable) — Google Shopping product page.
• product_id (string, nullable) — Google product id parsed from product_link — input for Product offers.
• price (string, nullable) — Price as shown.
• price_value (number, nullable) — Numeric price.
• currency (string, nullable) — Currency code/symbol.
• rating (number, nullable) — Star rating.
• reviews (integer, nullable) — Review count.
• seller (string, nullable) — Merchant name.
• multiple_sources (boolean) — True when several merchants offer it.
• condition (string, nullable) — refurbished / used / open box when not new.
• extensions (string[]) — Badges (free shipping, returns…).
• tag (string, nullable) — Promo tag ("7% OFF").
• image (string, nullable) — Image URL.

FAQ

What does the Google Shopping API return?

Searches Google Shopping for a product query in a country and delivers listings with price, currency, seller, rating and the Google product id (feed it to Product offers for the per-seller offer list). Paginates until max_results. Each row carries 16 fields, listed in full on this page.

What do I send it?

A semantic input, not a URL list: query are required. One run returns up to 100 listings.

How much does the Google Shopping API cost?

$0.001 per delivered listing. A run that delivers nothing is not billed, and the