Gucci API endpoint
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.
/gucci/searchSearches Gucci's US product catalog by keyword: product cards with the storefront's live total result count, stock flags, and live size facets. Pagination and limit are applied by this API.
q is required. page (default 1) and limit (default 24, maximum 100) control pagination. size (optional) filters to products listing this exact size as available (for example, Gucci 90) -- see the response's own size_facets field for the live list of size values and counts available for the current query, to discover a valid value before filtering by it; omit size on the first call to see every size across the whole query.
Notable response behavior:
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.colors, materials, sizes, gender, and line are omitted when Gucci does not include them in that search response; use gucci-product for PDP attributes.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| style_code | 24 | |
| name | 24 | “GG Marmont reversible belt” and 15 other values |
| brand | 24 | Gucci in all 24 |
| price | 24 | 430 to 720, median 590 |
| currency | 24 | USD in all 24 |
| images | 24 | median 6 entries |
| thumbnail_url | 24 | media.gucci.com |
| url | 24 | gucci.com |
| in_stock | 24 | true in 24 of 24 |
| in_stock_online | 24 | true in 24 of 24 |
| in_stock_stores | 24 | true in 24 of 24 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search keyword | belt | |
| page | integer | No | 1 | One-based page number, defaults to 1 | 1 |
| limit | integer | No | 24 | Results per page, defaults to 24, maximum 100 | 24 |
| 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. | Gucci 90 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/gucci/search?q=belt&page=1&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/gucci.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | gucci.SearchResponse | No | ||||
| data.count | integer | No | ||||
| data.country | string | No | ||||
| data.fetched_at | string | No | ||||
| data.limit | integer | No | ||||
| data.page | integer | No | ||||
| data.products | array | No | ||||
| data.products[].brand | string | No | ||||
| data.products[].categories | array | No | ||||
| data.products[].category_codes | array | No | ||||
| data.products[].colors | array | No | ||||
| data.products[].currency | string | No | ||||
| data.products[].description | string | No | ||||
| data.products[].gender | string | No | ||||
| data.products[].images | array | No | ||||
| data.products[].in_stock | boolean | No | ||||
| data.products[].in_stock_online | boolean | No | ||||
| data.products[].in_stock_stores | boolean | No | ||||
| data.products[].line | string | No | ||||
| data.products[].materials | array | No | ||||
| data.products[].name | string | No | ||||
| data.products[].price | number | No | ||||
| data.products[].sizes | array | No | ||||
| data.products[].sku | string | No | ||||
| data.products[].style_code | string | No | ||||
| data.products[].thumbnail_url | string | No | ||||
| data.products[].url | string | No | ||||
| data.query | string | No | ||||
| data.size | string | No | ||||
| data.size_facets | object | No | SizeFacets lists the live size values and counts returned by Gucci's catalog for this query. A value can be passed back as Size. | |||
| data.source_url | string | No | ||||
| data.total_pages | integer | No | ||||
| data.total_results | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/gucci/search?q=belt&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"