Gucci API endpoint
Returns one Gucci recommendations shelf: product summaries (name, price, image, stock) from either a given product's own "You May Also Like" carousel (style_code set) or the site's general trending-items shelf (style_code omitted). style_code comes from gucci-search's or gucci-category's own style_code field.
/gucci/recommendationsstyle_code (optional) comes from gucci-search's or gucci-category's own style_code field and selects that product's own "You May Also Like" carousel; omit it for the site's general trending-items shelf instead. max (default 10, maximum 20) caps how many products to return.
Notable response behavior:
model reports which shelf the response came from: related-products (style_code given) or trending-items (style_code omitted).price and currency are always in USD (the US storefront only).products list, not an error.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| style_code | 10 | |
| name | 10 | “Bamboo Tote large bag” and 8 other values |
| price | 10 | 2,065 to 4,600, median 4,150 |
| currency | 10 | USD in all 10 |
| image_url | 10 | media.gucci.com |
| url | 10 | gucci.com |
| in_stock_online | 10 | true in 10 of 10 |
| in_stock_stores | 10 | true in 10 of 10 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| style_code | string | No | Product style code to get related items for; omit for the site's general trending-items shelf instead | A005Y8AAG231096 | |
| max | integer | No | 10 | Maximum products to return, defaults to 10, maximum 20 | 10 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/gucci/recommendations" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"style_code": "A005Y8AAG231096",
"model": "related-products",
"country": "us",
"count": 2,
"products": [
{
"style_code": "A005Y8AAG4B9761",
"name": "Bamboo Tote large bag",
"price": 4450,
"currency": "USD",
"image_url": "https://media.gucci.com/style/$format$/1784301307/A005Y8_AAG4B_9761_001_100_0000_Light.jpg",
"url": "https://www.gucci.com/us/en/pr/women/handbags/shoulder-bags-for-women/bamboo-tote-large-bag-p-A005Y8AAG4B9761",
"in_stock_online": true,
"in_stock_stores": true
},
{
"style_code": "A005YBAAG8Z2742",
"name": "Bamboo Tote medium bag",
"price": 3950,
"currency": "USD",
"in_stock_online": true,
"in_stock_stores": true
}
]
}
}Request schema
No body schema
Response schema
#/definitions/gucci.recommendationsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | gucci.RecommendationsResponse | No | ||||
| data.count | integer | No | ||||
| data.country | string | No | ||||
| data.fetched_at | string | No | ||||
| data.model | string | No | ||||
| data.products | array | No | ||||
| data.products[].currency | string | No | ||||
| data.products[].image_url | string | No | ||||
| data.products[].in_stock_online | boolean | No | ||||
| data.products[].in_stock_stores | boolean | No | ||||
| data.products[].name | string | No | ||||
| data.products[].price | number | No | ||||
| data.products[].style_code | string | No | ||||
| data.products[].url | string | No | ||||
| data.source_url | string | No | ||||
| data.style_code | string | 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/recommendations" \
-H "x-api-key: $CRAWLORA_API_KEY"