Balenciaga API endpoint
Returns Balenciaga's public physical-store directory for one country, including addresses, coordinates, phone numbers, opening hours, and store-service flags. Use balenciaga-store-countries to discover the complete accepted country enum.
/balenciaga/storesQuery parameters:
country (required): one of AE, AT, AU, BE, BR, CA, CN, CZ, DE, DK, ES, FR, GB, HK, IE, IT, JP, KR, KW, MC, MO, MX, MY, NL, NZ, QA, SA, SG, CH, TH, TW, or US. Use balenciaga-store-countries to discover the live list.Returns all stores Balenciaga's public locator publishes for the selected
country, including city metadata, address, coordinates, phone, opening hours,
current-day hours, and store capabilities. An accepted country with no stores
returns an empty stores list.
| Field | Filled in, of 31 checked | Values in the sample |
|---|---|---|
| id | 31 | |
| name | 31 | “Santa Clara - Westfield Valley Fair” and 30 other values |
| address1 | 31 | “2855 Stevens Creek Blvd, Suite 1235” and 30 other values |
| city | 31 | “Santa Clara” and 23 other values |
| state | 31 | “California” and 14 other values |
| postal_code | 31 | |
| country_code | 31 | |
| country | 31 | United States of America in all 31 |
| phone | 31 | |
| latitude | 31 | |
| longitude | 31 | |
| details_url | 31 | balenciaga.com |
| status | 31 | Active in all 31 |
| closed | 31 | true in 0 of 31 |
| today_hours | 31 | |
| opening_hours | 31 | |
| availability | 31 | true in 31 of 31 |
| appointments | 31 | true in 31 of 31 |
| reserve_in_store | 31 | true in 31 of 31 |
| pickup | 31 | true in 21 of 31 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| country | string | Yes | Two-letter country code Allowed values: AE, AT, AU, BE, BR, CA, CN, CZ, DE, DK, ES, FR, GB, HK, IE, IT, JP, KR, KW, MC, MO, MX, MY, NL, NZ, QA, SA, SG, CH, TH, TW, US. | US | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/balenciaga/stores?country=US" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"country": "US",
"language": "en",
"store_count": 31,
"cities": [
"Atlanta",
"Austin",
"Beverly Hills"
],
"stores": [
{
"id": "83014",
"name": "Santa Clara - Westfield Valley Fair",
"address1": "2855 Stevens Creek Blvd, Suite 1235",
"city": "Santa Clara",
"state": "California",
"postal_code": "95050",
"country_code": "US",
"country": "United States of America",
"phone": "+1 408 572 8020",
"latitude": 37.326542,
"longitude": -121.94536,
"status": "Active",
"closed": false,
"availability": true,
"appointments": true,
"reserve_in_store": true,
"pickup": true
}
]
}
}Request schema
No body schema
Response schema
#/definitions/balenciaga.storesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | balenciaga.StoresResponse | No | ||||
| data.cities | array | No | ||||
| data.country | string | No | ||||
| data.fetched_at | string | No | ||||
| data.language | string | No | ||||
| data.source_url | string | No | ||||
| data.store_count | integer | No | ||||
| data.stores | array | No | ||||
| data.stores[].address1 | string | No | ||||
| data.stores[].address2 | string | No | ||||
| data.stores[].appointments | boolean | No | ||||
| data.stores[].availability | boolean | No | ||||
| data.stores[].city | string | No | ||||
| data.stores[].closed | boolean | No | ||||
| data.stores[].country | string | No | ||||
| data.stores[].country_code | string | No | ||||
| data.stores[].details_url | string | No | ||||
| data.stores[].id | string | No | ||||
| data.stores[].latitude | number | No | ||||
| data.stores[].longitude | number | No | ||||
| data.stores[].name | string | No | ||||
| data.stores[].opening_hours | object | No | ||||
| data.stores[].phone | string | No | ||||
| data.stores[].pickup | boolean | No | ||||
| data.stores[].postal_code | string | No | ||||
| data.stores[].reserve_in_store | boolean | No | ||||
| data.stores[].state | string | No | ||||
| data.stores[].status | string | No | ||||
| data.stores[].today_hours | balenciaga.StoreTodayHours | No | ||||
| data.stores[].today_hours.closing_hour | string | No | ||||
| data.stores[].today_hours.opening_hour | string | No | ||||
| data.stores[].today_hours.status | 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/balenciaga/stores?country=US" \
-H "x-api-key: $CRAWLORA_API_KEY"