Balenciaga API endpoint
Returns Balenciaga's live color/size variation matrix for a product, including variation ids, selection/sellability flags, care text, availability, and related product ids. url may be a product URL or a Product-Variation URL from balenciaga-product's colors[].url.
/balenciaga/product/variantsQuery parameters:
url (required): a Balenciaga product page URL, or a Product-Variation
URL from balenciaga-product's colors[].url field.Returns the live color/size matrix, variation and group ids, selection and
online-sellability flags, availability messages, material/care text, and
related product ids. Passing a product page URL resolves the exact
Product-Variation request from the page's own public markup.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| id | 2 | |
| display_name | 2 | |
| selected_value | 2 | “White Snow” and 1 other value |
| values | 2 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Balenciaga product URL or Product-Variation URL | https://www.balenciaga.com/on/demandware.store/Sites-BAL-R-INTL-Site/en_ZW/Product-Variation?dwvar_A007IH2ACT21000_color=1000&dwvar_A007IH2ACT21000_size=U&pid=A007IH2ACT21000&quantity=1 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/balenciaga/product/variants?url=https%3A%2F%2Fwww.balenciaga.com%2Fon%2Fdemandware.store%2FSites-BAL-R-INTL-Site%2Fen_ZW%2FProduct-Variation%3Fdwvar_A007IH2ACT21000_color%3D1000%26dwvar_A007IH2ACT21000_size%3DU%26pid%3DA007IH2ACT21000%26quantity%3D1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"product_id": "814444397",
"style_code": "A007IH2ACT21000",
"name": "Women's Hourglass Avenue Top Handle Bag Small in Black",
"availability": [
"In Stock"
],
"in_stock": true,
"attributes": [
{
"id": "color",
"display_name": "Color",
"selected_value": "Black",
"values": [
{
"id": "1000",
"label": "Black",
"variation_id": "814444397",
"selectable": true,
"sellable_online": true
}
]
},
{
"id": "size",
"display_name": "Size",
"selected_value": "U",
"values": [
{
"id": "U",
"label": "U",
"selectable": true
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/balenciaga.productVariantsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | balenciaga.ProductVariantsResponse | No | ||||
| data.attributes | array | No | ||||
| data.attributes[].display_name | string | No | ||||
| data.attributes[].id | string | No | ||||
| data.attributes[].selected_value | string | No | ||||
| data.attributes[].values | array | No | ||||
| data.attributes[].values[].back_in_stock | boolean | No | ||||
| data.attributes[].values[].backorderable | boolean | No | ||||
| data.attributes[].values[].id | string | No | ||||
| data.attributes[].values[].label | string | No | ||||
| data.attributes[].values[].preorderable | boolean | No | ||||
| data.attributes[].values[].selectable | boolean | No | ||||
| data.attributes[].values[].sellable_online | boolean | No | ||||
| data.attributes[].values[].url | string | No | ||||
| data.attributes[].values[].variation_group | string | No | ||||
| data.attributes[].values[].variation_id | string | No | ||||
| data.availability | array | No | ||||
| data.complete_the_look_ids | array | No | ||||
| data.currency | string | No | ||||
| data.fetched_at | string | No | ||||
| data.in_stock | boolean | No | ||||
| data.material | string | No | ||||
| data.name | string | No | ||||
| data.price | number | No | ||||
| data.product_care | string | No | ||||
| data.product_id | string | No | ||||
| data.related_product_ids | array | No | ||||
| data.source_url | string | No | ||||
| data.style_code | string | No | ||||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/product/variants?url=https%3A%2F%2Fwww.balenciaga.com%2Fon%2Fdemandware.store%2FSites-BAL-R-INTL-Site%2Fen_ZW%2FProduct-Variation%3Fdwvar_A007IH2ACT21000_color%3D1000%26dwvar_A007IH2ACT21000_size%3DU%26pid%3DA007IH2ACT21000%26quantity%3D1" \
-H "x-api-key: $CRAWLORA_API_KEY"