Gucci API endpoint
Returns Gucci's full US store-locator listing: name, address, phone, coordinates, product departments carried, and a link to book an in-store appointment for each location. Filter to stores carrying one department with department (e.g. jewelry, mens_shoes); omit for every store -- see the response's own departments field for the live list of department tags to filter by.
/gucci/storesdepartment filters to stores that carry this product-department tag case-insensitively (e.g. jewelry, mens_shoes); omit for every store -- see the response's own departments field for the live list of tags to filter by.
Notable response behavior:
slug is the value gucci-store's own slug parameter accepts, to fetch that store's opening hours.departments (top level) lists every department tag present across the whole listing; each store's own departments lists only the tags that location carries.book_appointment_url, when present, opens that store's private-appointment booking flow.| Field | Filled in, of 96 checked | Values in the sample |
|---|---|---|
| store_code | 96 | |
| slug | 96 | |
| name | 96 | “Chicago Flagship” and 95 other values |
| type | 96 | store (84), flagship (12) |
| address | 96 | |
| city | 96 | “Chicago, Illinois, 60611, United States” and 80 other values |
| phone | 95 | |
| latitude | 96 | |
| longitude | 96 | |
| departments | 95 | median 12 entries |
| book_appointment_url | 82 | gucci.com |
| url | 96 | gucci.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| department | string | No | Department tag to filter to (case-insensitive substring match against the response's own departments field), e.g. jewelry, mens_shoes. Omit for every store. | jewelry | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/gucci/stores" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"country": "us",
"count": 94,
"departments": [
"jewelry",
"mens_bags",
"mens_shoes",
"watches",
"womens_bags",
"womens_shoes"
],
"stores": [
{
"store_code": "266",
"slug": "900-north-michigan-avenue",
"name": "Chicago Flagship",
"type": "flagship",
"address": "900 North Michigan Avenue",
"city": "Chicago, Illinois, 60611, United States",
"phone": "+13126645504",
"latitude": 41.8998,
"longitude": -87.6244,
"departments": [
"jewelry",
"mens_bags",
"watches"
],
"book_appointment_url": "https://www.gucci.com/web/baa/us/en/store/23042",
"url": "https://www.gucci.com/us/en/store/900-north-michigan-avenue"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/gucci.storesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | gucci.StoresResponse | No | ||||
| data.count | integer | No | ||||
| data.country | string | No | ||||
| data.departments | array | No | ||||
| data.fetched_at | string | No | ||||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].address | string | No | ||||
| data.stores[].book_appointment_url | string | No | ||||
| data.stores[].city | string | No | ||||
| data.stores[].departments | array | No | ||||
| data.stores[].latitude | number | No | ||||
| data.stores[].longitude | number | No | ||||
| data.stores[].name | string | No | ||||
| data.stores[].phone | string | No | ||||
| data.stores[].slug | string | No | ||||
| data.stores[].store_code | string | No | ||||
| data.stores[].type | string | No | ||||
| data.stores[].url | 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/stores" \
-H "x-api-key: $CRAWLORA_API_KEY"