> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fast SERP shopping search

> Use Bright Data's Fast SERP service to retrieve compact Shopping search results in real time via a native proxy interface.

## 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.

```bash theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --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

| Field | Type | Required | Description |
| - | - | - | - |
| `price` | string | Yes | Displayed price of the product |
| `link` | string | Yes | URL to the product listing or merchant page |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Product name |
| `shop` | string | No | Name of the merchant or seller |
| `image` | string | No | URL of the product thumbnail image |
| `rating` | number | No | Average customer rating |
| `reviews_cnt` | integer | No | Number of customer reviews |
| `old_price` | string | No | Original price before discount, if applicable |
| `foreign_price` | string | No | Price as displayed in the merchant's own currency, when it differs from the search currency |
| `price_details` | array of objects | No | Breakdown of the price into named components. Each object carries `type` and `price`, and both are always present |
| `tag` | string | No | Promotional label Google attaches to the listing, e.g. `"Sale"` |

#### Example response, shopping search results

```json theme={null}
{
  "shopping": [
    {
      "title": "Apple iPhone 16 128GB Black",
      "link": "https://www.example-store.com/iphone-16-black",
      "price": "$799.00",
      "old_price": "$899.00",
      "foreign_price": "€739.00",
      "price_details": [
        { "type": "item", "price": "$799.00" },
        { "type": "shipping", "price": "$0.00" },
        { "type": "tax", "price": "$65.92" }
      ],
      "tag": "Sale",
      "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\_shopping.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_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.

<Note>
  Google Shopping product (PDP) URLs are short-lived. They carry an encoded `prds=` payload that Google rotates frequently, so a copied URL stops resolving after a short window. Do not hardcode a product URL. Instead, use whatever URL Google routes to when you open a product from a shopping search result tile, then append `&brd_json=1`.
</Note>

### Native proxy request

```shell theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  "<GOOGLE_SHOPPING_PRODUCT_URL>&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.

| Field | Type | Description |
| :- | :- | :- |
| `title` | string | Name of the product |
| `description` | string | Full product description |
| `images` | array of strings | List of product image URLs |
| `rating` | number \| null | Average customer rating |
| `reviews_cnt` | integer | Total number of customer reviews |
| `ai_images` | array of strings | Links to images in ai segment |

### `product_offers` array

List of individual seller offers for the product.

| Field | Type | Description |
| :- | :- | :- |
| `seller` | string | Name of the seller or merchant |
| `link` | string | URL to the seller's product page |
| `logo` | string | URL of the seller's logo image |
| `item_price` | array of strings | Current price(s) displayed for the offer |
| `item_old_price` | array of strings | Previous/crossed-out price(s), if applicable |
| `total_price` | array of strings | Total cost(s) of the offer including shipping and tax, as displayed by the seller |
| `shipping` | string | Shipping cost or delivery information |
| `rating` | number | Seller or offer rating |
| `reviews_cnt` | integer | Number of reviews for this offer |
| `details` | array of strings | List of offer detail highlights |
| `details_and_offers` | string | Combined details and promotional offer text |
| `payment_methods` | string | Accepted payment methods |

### `product_spec` object

Technical specifications grouped into sections.

| Field | Type | Description |
| :- | :- | :- |
| `specs` | array | List of specification sections |
| `specs[].data` | array | List of spec items within the section |
| `specs[].data[].name` | string | Specification label, e.g. `"Display size"` |
| `specs[].data[].value` | string | Specification value, e.g. `"6.1 inches"` |

## Example Response

```json theme={null}
{
  "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"
    ],
    "ai_images": [
      "https://www.example-store.com/images/iphone-17-pro-max-ai-1.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-ai-2.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"],
      "total_price": ["$1,298.92"],
      "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": [],
      "total_price": ["$1,314.75"],
      "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\_shopping\_product.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_shopping_product.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `q` | Search query (**must be first in URL**) | `q=iphone` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |

***