Gucci API endpoint
Searches Gucci's public store-map GeoJSON feed for locations inside the requested viewport. market selects the storefront locale and localized labels; it does not filter results by country. The supported, live-verified market values are ca (English), fr (French), jp (Japanese), uk (English), and us (English). Coordinates and viewport bounds determine the returned stores. The Gucci site's text field geocodes in the browser and its name parameter does not filter this feed, so callers must provide bounds and a center (geocode a place before calling). Dateline-crossing bounds are not supported.
/gucci/stores/searchSearches Gucci's public map feed for store locations inside a geographic viewport. market selects the storefront locale and localized labels; it does not filter results geographically. The currently supported, live-verified market values are ca, fr, jp, uk, and us (the UK path is uk). These five are an initial verified subset, not Gucci's complete set of country/language storefronts.
All coordinates are required. north, west, south, and east define the viewport; latitude and longitude are its center. The center must lie inside the viewport. Dateline-crossing viewports are not supported.
Gucci's store page geocodes free-text locations in the browser. Its name query parameter did not filter the map feed in live replay, so this endpoint does not accept a place name or perform geocoding; callers should geocode the desired place and send the resulting viewport.
Parameters:
market (required): ca (English), fr (French), jp (Japanese), uk (English), or us (English).north, west, south, east (required): viewport bounds in degrees.latitude, longitude (required): viewport center in degrees.Notable response behavior:
count is the number of returned map features; a valid empty features array is returned as count: 0.status string that has been observed as 416 alongside valid HTTP 200 responses and real store features. The scraper uses the HTTP status and GeoJSON structure instead.market; geometry comes from the requested viewport and may include stores outside that locale's country.Example request:
GET /api/v1/gucci/stores/search?market=uk&north=51.691&west=-0.510&south=51.286&east=0.335&latitude=51.5072&longitude=-0.1276
| Field | Filled in, of 16 checked | Values in the sample |
|---|---|---|
| number | 16 | 1 |
| active | 16 | true in 16 of 16 |
| name | 16 | “London Bond Street Flagship” and 15 other values |
| type | 16 | store (14), flagship (2) |
| latitude | 16 | |
| longitude | 16 | |
| categories | 16 | median 7 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| market | string | Yes | Gucci storefront locale; controls localization only, not geographic filtering Allowed values: ca, fr, jp, uk, us. | us | |
| north | number | Yes | Viewport northern latitude | 40.917705 | |
| west | number | Yes | Viewport western longitude | -74.258843 | |
| south | number | Yes | Viewport southern latitude | 40.476578 | |
| east | number | Yes | Viewport eastern longitude | -73.700169 | |
| latitude | number | Yes | Viewport center latitude | 40.7127753 | |
| longitude | number | Yes | Viewport center longitude | -74.0059728 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/gucci/stores/search?market=us&north=40.917705&west=-74.258843&south=40.476578&east=-73.700169&latitude=40.7127753&longitude=-74.0059728" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"market": "uk",
"language": "en_gb",
"count": 1,
"stores": [
{
"number": 1,
"active": true,
"name": "London Bond Street Flagship",
"type": "flagship",
"address": "144-146 New Bond Street",
"city": "London, Great Britain",
"phone": "+442076292716",
"latitude": 51.5116,
"longitude": -0.14385,
"categories": [
"jewelry",
"womens_bags"
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/gucci.storeSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | gucci.StoreSearchResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.language | string | No | ||||
| data.market | string | No | ||||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].active | boolean | No | ||||
| data.stores[].address | string | No | ||||
| data.stores[].categories | array | No | ||||
| data.stores[].city | string | No | ||||
| data.stores[].latitude | number | No | ||||
| data.stores[].longitude | number | No | ||||
| data.stores[].name | string | No | ||||
| data.stores[].number | integer | No | ||||
| data.stores[].phone | string | No | ||||
| data.stores[].services | array | No | ||||
| data.stores[].type | 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/search?market=us&north=40.917705&west=-74.258843&south=40.476578&east=-73.700169&latitude=40.7127753&longitude=-74.0059728" \
-H "x-api-key: $CRAWLORA_API_KEY"