Endpoint Playground

Try the Search Gucci products API

Searches Gucci's US product catalog by keyword using the storefront's public catalog. Results include card-level data and the live total count; per-product colors, materials, sizes, gender, and line are omitted when the search source does not provide them. A genuinely empty result returns a well-formed empty products list. The response's size_facets field lists live size values and counts -- pass one as size on a follow-up call to filter.

What a live request returned

14 Oct 2026: 24 products; 11 fields had a value in every checked item.

Observed request: GET /gucci/search?q=belt&limit=24
Fields with a value in every checked item: style_code, name, brand, price, currency, images, thumbnail_url, url

Sample value profiles: price: 430 to 720, median 590; name: “GG Marmont reversible belt” and 15 other values; thumbnail_url: media.gucci.com.

Request: GET /gucci/search
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.52 s
Monitored request: GET /gucci/search?q=belt

Search Gucci products API documentation Gucci platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gucci/search?q=belt' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	Yes	belt	Search keyword
page	integer	No		One-based page number, defaults to 1
limit	integer	No		Results per page, defaults to 24, maximum 100
size	string	No		Filter to products listing this exact size as available. See size_facets for live values -- omit size to see all sizes first.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "belt",
    "country": "us",
    "page": 1,
    "limit": 24,
    "count": 2,
    "total_results": 177,
    "total_pages": 8,
    "size_facets": {
      "Gucci 90": 142,
      "Gucci 100": 143
    },
    "products": [
      {
        "style_code": "400593AP00T1000",
        "name": "GG Marmont wide belt",
        "price": 570,
        "currency": "USD",
        "in_stock": true,
        "url": "https://www.gucci.com/us/en/pr/women/accessories-for-women/belts-for-women/gg-marmont-wide-belt-p-400593AP00T1000"
      }
    ]
  }
}

More Gucci endpoints

List Gucci's category and subcategory taxonomy Browse a Gucci category listing Get a Gucci product Gucci product recommendations Gucci product size chart Get a Gucci store's detail List Gucci store locations Search Gucci stores in a map viewport Gucci search-box suggestions

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestgucci.searchResponseDocGucci

GET /gucci/search

Search Gucci's product catalog

Response behavior

- A genuinely empty result (e.g. a nonsense query) returns a well-formed empty `products` list with `total_results: 0`, not an error. - `price` and `currency` are always in USD (the US storefront only). - `size_facets` lists every size value present in the response's own result set (i.e. `q`, and `size` if also given), each with its own live product count. - Gucci's current catalog search source returns card-level fields: style code, name, price, images, PDP URL, and stock. Optional per-product fields such as `colors`, `materials`, `sizes`, `gender`, and `line` are omitted when Gucci does not include them in that search response; use `gucci-product` for PDP attributes.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Search keyword

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "belt",
    "country": "us",
    "page": 1,
    "limit": 24,
    "count": 2,
    "total_results": 177,
    "total_pages": 8,
    "size_facets": {
      "Gucci 90": 142,
      "Gucci 100": 143
    },
    "products": [
      {
        "style_code": "400593AP00T1000",
        "name": "GG Marmont wide belt",
        "price": 570,
        "currency": "USD",
        "in_stock": true,
        "url": "https://www.gucci.com/us/en/pr/women/accessories-for-women/belts-for-women/gg-marmont-wide-belt-p-400593AP00T1000"
      }
    ]
  }
}

Endpoint Playground

Try the Search Gucci products API

What a live request returned

14 Oct 2026: 24 products; 11 fields had a value in every checked item.

Observed request: GET /gucci/search?q=belt&limit=24
Fields with a value in every checked item: style_code, name, brand, price, currency, images, thumbnail_url, url

Sample value profiles: price: 430 to 720, median 590; name: “GG Marmont reversible belt” and 15 other values; thumbnail_url: media.gucci.com.

Request: GET /gucci/search
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.52 s
Monitored request: GET /gucci/search?q=belt

Search Gucci products API documentation Gucci platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/gucci/search?q=belt' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	Yes	belt	Search keyword
page	integer	No		One-based page number, defaults to 1
limit	integer	No		Results per page, defaults to 24, maximum 100
size	string	No		Filter to products listing this exact size as available. See size_facets for live values -- omit size to see all sizes first.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "belt",
    "country": "us",
    "page": 1,
    "limit": 24,
    "count": 2,
    "total_results": 177,
    "total_pages": 8,
    "size_facets": {
      "Gucci 90": 142,
      "Gucci 100": 143
    },
    "products": [
      {
        "style_code": "400593AP00T1000",
        "name": "GG Marmont wide belt",
        "price": 570,
        "currency": "USD",
        "in_stock": true,
        "url": "https://www.gucci.com/us/en/pr/women/accessories-for-women/belts-for-women/gg-marmont-wide-belt-p-400593AP00T1000"
      }
    ]
  }
}

More Gucci endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestgucci.searchResponseDocGucci

GET /gucci/search

Search Gucci's product catalog

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Search keyword

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "belt",
    "country": "us",
    "page": 1,
    "limit": 24,
    "count": 2,
    "total_results": 177,
    "total_pages": 8,
    "size_facets": {
      "Gucci 90": 142,
      "Gucci 100": 143
    },
    "products": [
      {
        "style_code": "400593AP00T1000",
        "name": "GG Marmont wide belt",
        "price": 570,
        "currency": "USD",
        "in_stock": true,
        "url": "https://www.gucci.com/us/en/pr/women/accessories-for-women/belts-for-women/gg-marmont-wide-belt-p-400593AP00T1000"
      }
    ]
  }
}