Google shopping

We currently provide data on Google Shopping (google_shopping) for 37 countries. The data includes offers, products, product matchings, product specs, reviews, and search results.

Supported countries:

  • Africa: South Africa (za)
  • Americas: Brazil (br), Canada (ca), Mexico (mx), and United States (us)
  • Asia: Hong Kong (hk), India (in), Japan (jp), Korea (Republic of) (kr), Singapore (sg), Turkey (tr), and United Arab Emirates (ae)
  • Europe: Austria (at), Belgium (be), Czechia (cz), Denmark (dk), Finland (fi), France (fr), Germany (de), Greece (gr), Hungary (hu), Ireland (ie), Italy (it), Netherlands (nl), Norway (no), Poland (pl), Portugal (pt), Romania (ro), Russian Federation (ru), Slovakia (sk), Spain (es), Sweden (se), Switzerland (ch), Ukraine (ua), and United Kingdom (gb)
  • Oceania: Australia (au) and New Zealand (nz)

Supported topics:

Jump to: offers, product, product_and_offers, product_matching, product_specs, reviews, search_results

Topic offers

Supported key:

  • id Samples values are as follows:
	11439103407659839974
	16488583829101110384
	3958720122321812215
	9629600374284049808
	

view sample results

Supported parameters:

  • max_age (default 1200 = 20 hours)
  • max_pages (default 1)
  • sort_by (default ranking_descending)
  • condition (default any)
  • shipping (default any)

Topic product

Supported key:

  • id Samples values are as follows:
	10537759399520717778
	409382351075348383
	10537759399520717778
	

view sample results

Supported parameters:

  • max_age (default 43200 = 30 days)

Topic product_and_offers

Note: Due to Google Shopping changes (End of 2023), search results for gtins are inconsistent and not reliable. Therefore we have recently begun to ignore the given max_age parameter for the search_results subtopic of product_and_offers (key: GTIN) as we cannot retrieve new / valid information from Google Shopping Search Results on the go.
Furthermore Price API will look for the last valid/found GTIN -> Product_ID matches in our database and use that Product_ID.

Supported keys:

  • id Samples values are as follows:
	10537759399520717778
	409382351075348383
	10537759399520717778
	
  • term Samples values are as follows:
	KPM Leuchten 10012-1-45
	iphone 13 128GB Silver
	Super Mario World
	dot-spot 42000.35.55
	
  • gtin Samples values are as follows:
	4001967047745
	4000158913043
	4001967022032
	4001967151985
	

view sample results

Supported parameters:

  • max_age (default 1200 = 20 hours)
  • max_pages (default 1)
  • sort_by (default ranking_descending)
  • condition (default any)
  • shipping (default any)

Topic product_matching

Supported key:

  • product_info

    Note: Each value should be in ndjson format and have the fields 'gtin', 'product_title' and 'product_url'

    Samples values are as follows:

	{"gtin":"718910628060","product_title":"Zero Queen Of Doom Skateboard Deck - Sandoval 8.375\"","product_url":"https:\/\/www.skatehut.co.uk\/eu\/zero-queen-of-doom-skateboard-deck-sandoval-8-375.htm"}
	{"gtin":"5060626667396","product_title":"Meow Big Cat Complete Skateboard - White 8''","product_url":"https:\/\/www.skatehut.co.uk\/eu\/meow-big-cat-complete-skateboard-8-0-inches.htm"}
	{"gtin":"5059028008845","product_title":"SFR Youth Ramp Triple Pad Set - Black\/Lime","product_url":"https:\/\/www.skatehut.co.uk\/sfr-youth-ramp-triple-pad-set-black-lime.htm?ps=ODMzPTQ4MjI=#833=4822"}
	

view sample results

Supported parameters:

  • max_age (default 43200 = 30 days)

Topic product_specs

Supported key:

  • id Samples values are as follows:
	1486762053208079216
	13866443303046468565
	14389903822767628761
	15822114156836167438
	

view sample results

Supported parameters:

  • max_age (default 43200 = 30 days)

Topic reviews

Supported key:

  • id Samples values are as follows:
	10537759399520717778
	409382351075348383
	10537759399520717778
	

view sample results

Supported parameters:

  • max_age (default 10080 = 7 days)
  • max_pages (default 1)

Topic search_results

Supported keys:

  • term

    Note: The ids in the 'search_results' topic may not always be valid, particularly when the type is set to 'offer', and cannot be relied upon when making requests to the 'product_and_offers' or 'offers' topics and that might result in an invalid value error.

    Samples values are as follows:

	Samsung Galaxy A22 5G
	Babyflaschen
	MacBook Pro m1 max 512GB
	
  • gtin

    Note: Due to Google Shopping changes (End of 2023), search results for gtins are inconsistent and not reliable. Therefore we have recently begun to give an error for search_results (key: GTIN) as we cannot guarantee data quality.

    Samples values are as follows:

	4545350045906
	4545350049461
	4545350052591
	4545350040475
	

view sample results

Supported parameters:

  • max_age (default 43200 = 30 days)
  • max_pages (default 1)
  • sort_by (default ranking_descending)
  • condition (default any)
  • min_price (omitted by default)
  • max_price (omitted by default)
  • merchant_id (omitted by default)