Core APIs
...
Google
Shopping & Products

Search

3min
google shopping results desktop desktop tablet mobile value serp parses the google shopping search results when the search type=shopping search parameter is set below is an example of how google shopping results are represented in the value serp result json { "request info" { "success" "true", "credits used" 1, "credits used this request" 1, "credits remaining" 19999, "credits reset at" "2024 01 01t00 00 00 000z" }, "search metadata" { "created at" "2024 01 01t00 00 00 000z", "processed at" "2024 01 01t00 00 00 000z", "total time taken" 1 5, "engine url" "https //www google com/search?q=pizza\&uule=w+caiqicinvw5pdgvkifn0yxrlcw\&gl=us\&hl=en\&tbm=shop\&tbs=vw\ l", "html url" "https //api valueserp com/search?api key=apikey\&q=pizza\&location=united+states\&search type=shopping\&engine=google\&output=html", "json url" "https //api valueserp com/search?api key=apikey\&q=pizza\&location=united+states\&search type=shopping\&engine=google\&output=json", "location auto message" "we have automatically set the 'google domain', 'gl' and 'hl' parameters to match the supplied location of 'united states' you can stop this behaviour by setting the 'location auto' parameter to 'false' " }, "search parameters" { "search type" "shopping", "location" "united states", "q" "pizza", "engine" "google" }, "search information" { "original query yields zero results" "false", "query displayed" "pizza" }, "shopping results" \[ { "position" 1, "title" "giordano's pizza chicago deep dish pizza choose your own 2 pack", "id" "16485180804320198887", "price" 84 99, "price parsed" { "symbol" "$", "value" 84 99, "currency" "usd", "raw" "$84 99" }, "price raw" "$84 99", "merchant" "goldbelly", "delivery" "free delivery", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "false" }, { "position" 2, "title" "red baron brick oven crust pepperoni pizza", "link" "https //www google com/shopping/product/15508520590310144614", "id" "15508520590310144614", "rating" 4 5, "reviews" 1300, "price" 6 49, "price parsed" { "symbol" "$", "value" 6 49, "currency" "usd", "raw" "$6 49" }, "price raw" "$6 49", "merchant" "safeway", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 3, "title" "choose your own pizzeria uno chicago style deep dish pizza pick 2, entrees by harry & david", "link" "https //www google com/shopping/product/14036846829966684344", "id" "14036846829966684344", "rating" 3 5, "reviews" 43, "price" 69 99, "price parsed" { "symbol" "$", "value" 69 99, "currency" "usd", "raw" "$69 99" }, "price raw" "$69 99", "merchant" "harry & david", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 4, "title" "clean eatz kitchen blt pizza", "link" "https //www google com/shopping/product/4774916560532512646", "id" "4774916560532512646", "rating" 4 7, "reviews" 348, "price" 6 99, "price parsed" { "symbol" "$", "value" 6 99, "currency" "usd", "raw" "$6 99" }, "price raw" "$6 99", "merchant" "clean eatz kitchen", "delivery" "free by 12/6", "has compare prices" "false", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 5, "title" "totino's pepperoni party frozen pizza", "link" "https //www google com/shopping/product/5210836145297590625", "id" "5210836145297590625", "rating" 4 5, "reviews" 6300, "price" 2 49, "price parsed" { "symbol" "$", "value" 2 49, "currency" "usd", "raw" "$2 49" }, "price raw" "$2 49", "merchant" "mercato com", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 6, "title" "digiorno rising crust frozen pizza pepperoni", "link" "https //www google com/shopping/product/15767433932080941472", "id" "15767433932080941472", "rating" 4 4, "reviews" 6300, "price" 9 99, "price parsed" { "symbol" "$", "value" 9 99, "currency" "usd", "raw" "$9 99" }, "price raw" "$9 99", "merchant" "albertsons", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 7, "title" "chicago deep dish pizza", "link" "https //www google com/shopping/product/3953021767280810745", "id" "3953021767280810745", "price" 84 99, "price parsed" { "symbol" "$", "value" 84 99, "currency" "usd", "raw" "$84 99" }, "price raw" "$84 99", "merchant" "giordano's", "delivery" "free by 12/6", "has compare prices" "false", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 8, "title" "giordano's pizza chicago deep dish pizza choose your own 4 pack", "id" "14076830713312465621", "price" 135 99, "price parsed" { "symbol" "$", "value" 135 99, "currency" "usd", "raw" "$135 99" }, "price raw" "$135 99", "merchant" "goldbelly", "delivery" "free delivery", "has compare prices" "false", "image" "data\ image/webp;base64, ", "has product page" "false" }, { "position" 9, "title" "screamin sicilian holy pepperoni pizza", "link" "https //www google com/shopping/product/13137855717706954051", "id" "13137855717706954051", "rating" 4 3, "reviews" 498, "price" 11 99, "price parsed" { "symbol" "$", "value" 11 99, "currency" "usd", "raw" "$11 99" }, "price raw" "$11 99", "merchant" "safeway", "has compare prices" "false", "image" "data\ image/webp;base64, ", "has product page" "true" }, { "position" 10, "title" "wild fork foods sicilian pizza", "link" "https //www google com/shopping/product/11774750032364030379", "id" "11774750032364030379", "rating" 4 1, "reviews" 118, "price" 6 97, "price parsed" { "symbol" "$", "value" 6 97, "currency" "usd", "raw" "$6 97" }, "price raw" "$6 97", "merchant" "wild fork foods", "has compare prices" "true", "image" "data\ image/webp;base64, ", "has product page" "true" } ], "filters" \[ { "name" "show only", "values" \[ { "name" "buy on google", "value" "vw\ l,mr 1,cat 499988,buy\ g,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "on sale", "value" "vw\ l,mr 1,cat 499988,sales 1,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "smaller stores", "value" "vw\ l,mr 1,cat 499988,smb 1,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "price", "values" \[ { "name" "up to $25", "value" "vw\ l,mr 1,cat 499988,price 1,ppr max 25,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "$25 – $70", "value" "vw\ l,mr 1,cat 499988,price 1,ppr min 25,ppr max 70,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "over $70", "value" "vw\ l,mr 1,cat 499988,price 1,ppr min 70,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "meat type", "values" \[ { "name" "chicken", "value" "vw\ l,mr 1,cat 499988,pdtr0 987106|2831475,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "beef", "value" "vw\ l,mr 1,cat 499988,pdtr0 987106|987107,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "turkey", "value" "vw\ l,mr 1,cat 499988,pdtr0 987106|2831476,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "pork", "value" "vw\ l,mr 1,cat 499988,pdtr0 987106|2831477,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "brand", "values" \[ { "name" "red baron", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971344,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "california pizza kitchen", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971335,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "tony's", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971406,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "digiorno", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971338,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "lunchables", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971410,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "hot pockets", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|971339,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "american flatbread", "value" "vw\ l,mr 1,cat 499988,pdtr0 971231|4237701,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "fresh / frozen", "values" \[ { "name" "fresh", "value" "vw\ l,mr 1,cat 499988,pdtr0 985775|985776,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "frozen", "value" "vw\ l,mr 1,cat 499988,pdtr0 985775|985777,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "pizza crust style", "values" \[ { "name" "thin crust", "value" "vw\ l,mr 1,cat 499988,pdtr0 4043988|4043991,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "deep dish", "value" "vw\ l,mr 1,cat 499988,pdtr0 4043988|4043992,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "flatbread", "value" "vw\ l,mr 1,cat 499988,pdtr0 4043988|4043989,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "french bread", "value" "vw\ l,mr 1,cat 499988,pdtr0 4043988|4043990,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "pizza type", "values" \[ { "name" "meat", "value" "vw\ l,mr 1,cat 499988,pdtr0 986325|986327,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "cheese", "value" "vw\ l,mr 1,cat 499988,pdtr0 986325|986326,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "vegetable", "value" "vw\ l,mr 1,cat 499988,pdtr0 986325|986328,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "fat content", "values" \[ { "name" "low fat", "value" "vw\ l,mr 1,cat 499988,pdtr0 2432349|2432350,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "fat free", "value" "vw\ l,mr 1,cat 499988,pdtr0 2432349|2432352,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "features", "values" \[ { "name" "vegetarian", "value" "vw\ l,mr 1,cat 499988,pdtr0 986391|986392,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "gluten free", "value" "vw\ l,mr 1,cat 499988,pdtr0 971430|971431,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "vegan", "value" "vw\ l,mr 1,cat 499988,pdtr0 2758732|2758733,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "breakfast", "value" "vw\ l,mr 1,cat 499988,pdtr0 2481370|2481371,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "personal size", "value" "vw\ l,mr 1,cat 499988,pdtr0 986336|986337,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "organic", "value" "vw\ l,mr 1,cat 499988,pdtr0 971427|971428,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "shipping", "values" \[ { "name" "free shipping", "value" "vw\ l,mr 1,cat 499988,ship 1,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "product rating", "values" \[ { "name" "4 and up", "value" "vw\ l,mr 1,cat 499988,avg rating 400,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] }, { "name" "seller", "values" \[ { "name" "ebay", "value" "vw\ l,mr 1,cat 499988,merchagg\ g6296794,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "foodservicedirect com", "value" "vw\ l,mr 1,cat 499988,merchagg\ m16189,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "goldbelly", "value" "vw\ l,mr 1,cat 499988,merchagg\ m100263440,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "gopuff", "value" "vw\ l,mr 1,cat 499988,merchagg\ m134889861|m305163472,init ar\ sgzkbaiuwh5kcliickyloycxpts=" }, { "name" "rebel smuggling galactic emporium", "value" "vw\ l,mr 1,cat 499988,merchagg\ m123262447,init ar\ sgzkbaiuwh5kcliickyloycxpts=" } ] } ], "pagination" { "current" 1, "next" "https //www google com/search?q=pizza\&gl=us\&hl=en\&tbs=vw\ l,cat 499988,init ar\ sgzkbaiuwh5kcliickyloycxpts%3d,ss 44\&tbm=shop\&ei=iqrwyavpikxm0pephluniao\&start=20\&sa=n\&ved=0ahukewjrt 6j njzahuljjqihyrda6eq8nmdck0h", "other pages" \[ { "page" 2, "link" "https //www google com/search?q=pizza\&gl=us\&hl=en\&tbs=vw\ l,cat 499988,init ar\ sgzkbaiuwh5kcliickyloycxpts%3d,ss 44\&tbm=shop\&ei=iqrwyavpikxm0pephluniao\&start=20\&sa=n\&ved=0ahukewjrt 6j njzahuljjqihyrda6eq8tmdcjsh" }, { "page" 3, "link" "https //www google com/search?q=pizza\&gl=us\&hl=en\&tbs=vw\ l,cat 499988,init ar\ sgzkbaiuwh5kcliickyloycxpts%3d,ss 44\&tbm=shop\&ei=iqrwyavpikxm0pephluniao\&start=40\&sa=n\&ved=0ahukewjrt 6j njzahuljjqihyrda6eq8tmdcj0h" } ], "api pagination" { "next" "https //api scaleserp com/search?api key=apikey\&q=pizza\&location=united%20states\&search type=shopping\&engine=google\&page=3", "other pages" \[ { "page" 2, "link" "https //api scaleserp com/search?api key=apikey\&q=pizza\&location=united%20states\&search type=shopping\&engine=google\&page=3" }, { "page" 3, "link" "https //api scaleserp com/search?api key=apikey\&q=pizza\&location=united%20states\&search type=shopping\&engine=google\&page=5" } ] } } } value serp returns the following properties for search type=shopping requests shopping results array an array of shopping result objects, containing each of the shopping results shown on the results page the shopping result object has the following properties position number the position of the shopping result within the current page of results title string the title of the shopping result id string the id of the shopping result can be used to request details from an individual product landing page by passing the id value into a subsequent search type=product requests' product id parameter note the id is only returned when google show a product landing page link with the shopping result regular redirection links, without a individual product landing page, will not have an id property returned as no product landing page exists link string the link displayed alongside the shopping result will be either a link to a individual product landing page (which can be requested by passing the id value into a subsequent search type=product requests' product id parameter) links to individual product landing pages will contain the string /shopping/product and have the has product page property will be set to true has product page boolean set to true when this shopping result links to an individual product landing page in this instance the id property can be used in a subsequent search type=product requests' product id parameter to request data from the individual product landing page price number the price of the merchants' offer as a number price raw string the raw price string of the merchants' offer as a number price parsed object price parsed object an object containing a parsed version of the merchants' offer price for the shopping result symbol string the currency symbol, i e $ for usd value number the price of the merchant offer currency string the currency of the merchant offer as a iso 4217 currency code set to null in the event of the currency not being identifyable on the shopping result page raw string the raw text of the merchant offer price, from which the price parsed object was created merchant string the merchant name rating number the customer rating, out of 5, shown next to the shopping result reviews number the number of customer reviews the shopping result has received has compare prices boolean set to true when there is more than (1) merchant offering this product delivery string the delivery text shown next to the shopping result image string the shopping result image expressed as either an image url, or a base 64 encoded image extensions array an array of strings being the extension text shown next to the shopping result is carousel boolean set to true then the shopping result is displayed in the carousel section at the top or bottom of the shopping results page carousel position string when is carousel=true , carousel position will be set to top or bottom depending on the location of the carousel that this shopping result is displayed in ad carousel array an array of sponsored shopping result objects found within the carousel the sponsored shopping result object has the following properties position number the position of the shopping result within the carousel title string the title of the shopping result link string the link of the shopping result price string the price of the merchants' offer as a string $59 98 price parsed object price parsed object an object containing a parsed version of the merchants' offer price for the shopping result symbol string the currency symbol, i e $ for usd value number the price of the merchant offer regular price string the non discounted price regular price parsed object symbol string value number merchant string the merchant name rating number the customer rating, out of 5, shown next to the shopping result reviews number the number of customer reviews the shopping result has received block position string position of ad carousel on the html page filters array an array of filter objects containing name/value pairs for filtering subsequent search type=shopping requests to just those results matching the given filter a filter value can be passed into a subsequent search type=shopping requests' shopping filter request parameter name string the name of the filter i e brand values array filter values object an object containing the filter name and value name string the name of the filter i e "sony" value string the value of the filter this value can be passed into a subsequent search type=shopping requests' shopping filter request parameter to limit results to just those shopping results matching the given filter value pagination object an object containing details of the pagination section of the page details are provided as google links and api links (to make sending paginated requests easier) current number the current page number, if shown next string the google url of the next page of results other pages object an object containing details of the other pages shown on the results page the object is keyed by the other page number, with the value being the google url to the page api pagination object an object containing api links to request the next pages of results provided as a convenience to allow you to run subsequent requests for additional pages contains a next and other pages property next steps google shopping parameters https //docs trajectdata com/valueserp/search api/searches/google/shopping