Skip to main content

Fast SERP: Google Shopping endpoints

Google Shopping offers two types of pages that Fast SERP supports:
  • Shopping search results — a listing of products for a given search query, via https://www.google.com/search?q=[searchTerm]&udm=28
  • Product detail page (PDP) — a full product page with offers, specifications, and reviews, via a Google Shopping product URL
Both endpoints require the x-unblock-data-format: parsed_light request header and the brd_json=1 URL parameter. Omitting either will result in an unexpected response format.

Fast Shopping Search Request

Fast SERP for Google Shopping works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

Shopping search results

Use the udm=28 parameter to retrieve the Google Shopping search results listing page.
curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=iphone&udm=28&brd_json=1"

Response Format

A successful shopping search response contains a shopping array.

shopping array

FieldTypeRequiredDescription
pricestringYesDisplayed price of the product
linkstringYesURL to the product listing or merchant page
global_rankintegerYesRank position of the result on the page
titlestringNoProduct name
shopstringNoName of the merchant or seller
imagestringNoURL of the product thumbnail image
ratingnumberNoAverage customer rating
reviews_cntintegerNoNumber of customer reviews
old_pricestringNoOriginal price before discount, if applicable

Example response — shopping search results

{
  "shopping": [
    {
      "title": "Apple iPhone 16 128GB Black",
      "link": "https://www.example-store.com/iphone-16-black",
      "price": "$799.00",
      "old_price": "$899.00",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3240,
      "image": "https://www.example-store.com/images/iphone-16.jpg",
      "global_rank": 1
    },
    {
      "title": "Apple iPhone 16 256GB White",
      "link": "https://www.another-store.com/iphone-16-white",
      "price": "$899.00",
      "shop": "Another Store",
      "rating": 4.7,
      "reviews_cnt": 1850,
      "image": "https://www.another-store.com/images/iphone-16-white.jpg",
      "global_rank": 2
    }
  ]
}
Response schema: https://api.brightdata.com/data_schemas/fast_serp/google_search_shopping.schema.json

Fast Shopping Product Request

Fast SERP for Google Shopping product pages works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided. For Fast SERP, both the x-unblock-data-format: parsed_light request header and the brd_json=1 URL parameter are required. Omitting either will result in an unexpected response format.

Native proxy request

curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  "https://www.google.com/search?ibp=oshop&q=Apple+iPhone+17+Pro+Max&prds=catalogid:14168848586042650493,headlineOfferDocid:9742715914832712106,imageDocid:17255481404991010739,gpcid:5141485329231317038,mid:576462869544971580,pvt:hg&pvorigin=25&hl=en&gl=us&shem=damc,pvflt,shrtsdl&shndl=37&udm=28&source=sh/x/prdct/hdr/m1/1&brd_json=1" \
  -H 'x-unblock-data-format: parsed_light'

Response Format

A successful response is structured around three top-level fields: product, product_offers, and product_spec.

product object

Top-level product information.
FieldTypeDescription
titlestringName of the product
descriptionstringFull product description
imagesarray of stringsList of product image URLs
ratingnumber | nullAverage customer rating
reviews_cntintegerTotal number of customer reviews

product_offers array

List of individual seller offers for the product.
FieldTypeDescription
sellerstringName of the seller or merchant
linkstringURL to the seller’s product page
logostringURL of the seller’s logo image
item_pricearray of stringsCurrent price(s) displayed for the offer
item_old_pricearray of stringsPrevious/crossed-out price(s), if applicable
shippingstringShipping cost or delivery information
ratingnumberSeller or offer rating
reviews_cntintegerNumber of reviews for this offer
detailsarray of stringsList of offer detail highlights
details_and_offersstringCombined details and promotional offer text
payment_methodsstringAccepted payment methods

product_spec object

Technical specifications grouped into sections.
FieldTypeDescription
specsarrayList of specification sections
specs[].dataarrayList of spec items within the section
specs[].data[].namestringSpecification label, e.g. "Display size"
specs[].data[].valuestringSpecification value, e.g. "6.1 inches"

Example Response

{
  "product": {
    "title": "Apple iPhone 17 Pro Max",
    "description": "The Apple iPhone 17 Pro Max features the latest A-series chip, a pro camera system, and all-day battery life in a titanium design.",
    "images": [
      "https://www.example-store.com/images/iphone-17-pro-max-front.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-back.jpg"
    ],
    "rating": 4.9,
    "reviews_cnt": 5120
  },
  "product_offers": [
    {
      "seller": "Example Store",
      "link": "https://www.example-store.com/iphone-17-pro-max",
      "logo": "https://www.example-store.com/logo.png",
      "item_price": ["$1,199.00"],
      "item_old_price": ["$1,299.00"],
      "shipping": "Free shipping",
      "rating": 4.9,
      "reviews_cnt": 2100,
      "details": ["In stock", "Ships within 24 hours"],
      "details_and_offers": "In stock. Ships within 24 hours. 10% off with code SAVE10.",
      "payment_methods": "Visa, Mastercard, PayPal"
    },
    {
      "seller": "Another Store",
      "link": "https://www.another-store.com/iphone-17-pro-max",
      "logo": "https://www.another-store.com/logo.png",
      "item_price": ["$1,209.00"],
      "item_old_price": [],
      "shipping": "$5.99 shipping",
      "rating": 4.7,
      "reviews_cnt": 980,
      "details": ["In stock"],
      "details_and_offers": "In stock. Standard delivery 3-5 days.",
      "payment_methods": "Visa, Mastercard"
    }
  ],
  "product_spec": {
    "specs": [
      {
        "data": [
          { "name": "Display size", "value": "6.9 inches" },
          { "name": "Display type", "value": "Super Retina XDR OLED" }
        ]
      },
      {
        "data": [
          { "name": "Storage", "value": "256GB" },
          { "name": "RAM", "value": "12GB" },
          { "name": "Processor", "value": "Apple A19 Pro" }
        ]
      },
      {
        "data": [
          { "name": "Main camera", "value": "48MP" },
          { "name": "Battery capacity", "value": "4685 mAh" }
        ]
      }
    ]
  }
}
Response schema: https://api.brightdata.com/data_schemas/fast_serp/google_search_shopping_product.schema.json

Supported parameters

gl

Two-letter country code used to define the country of search

hl

Two-letter language code used to define the page languages