Balenciaga API endpoint
Returns one Balenciaga category listing from the site's own Search-ShowAjax fragment. path comes from balenciaga-categories. sort accepts latest, price_ascending, or price_descending. filters is a comma-separated list of exact field:value pairs from the response's live facets; repeat a field to OR multiple values within that facet; omit it for an unfiltered listing.
/balenciaga/categoryQuery parameters:
path (required): a category path from balenciaga-categories.sort (optional): latest, price_ascending, or price_descending; defaults to latest.page (optional): one-based page number; defaults to 1.limit (optional): products per page; defaults to 16, maximum 48.filters (optional): comma-separated exact field:value pairs from the response's live facets, such as akeneo_macroColor:BLACK. Repeat a field to OR multiple values within that facet, such as akeneo_macroColor:BLACK,akeneo_macroColor:WHITE.Notable response behavior:
Search-ShowAjax HTML fragment and returns its live total and facet counts.sort values map to the upstream values NewIn, PriceAscending, and PriceDescending.facets values.| Field | Filled in, of 16 checked | Values in the sample |
|---|---|---|
| product_id | 16 | |
| name | 16 | “le city bucket bag nano” and 9 other values |
| in_stock | 16 | true in 15 of 16 |
| colors | 10 | median 2 entries |
| images | 16 | median 3 entries |
| url | 16 | balenciaga.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| path | string | Yes | Category path from balenciaga-categories | /en-en/women/bags-for-women/handbags | |
| sort | string | No | Sort order Allowed values: latest, price_ascending, price_descending. | latest | |
| page | integer | No | 1 | One-based page number, defaults to 1 | 1 |
| limit | integer | No | 16 | Products per page, defaults to 16, maximum 48 | 16 |
| filters | string | No | Comma-separated exact facet filters; repeat a field for OR values, for example akeneo_macroColor:BLACK,akeneo_macroColor:WHITE | akeneo_macroColor:BLACK | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/balenciaga/category?path=%2Fen-en%2Fwomen%2Fbags-for-women%2Fhandbags&sort=latest&page=1&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"path": "/en-en/women/bags-for-women/handbags",
"country": "ZW",
"language": "en",
"sort": "latest",
"page": 1,
"limit": 16,
"count": 1,
"total_results": 148,
"total_pages": 10,
"products": [
{
"product_id": "A007IH2ACT21000",
"name": "HOURGLASS AVENUE TOP HANDLE BAG SMALL",
"currency": "USD",
"in_stock": true,
"url": "https://www.balenciaga.com/en-en/hourglass-avenue-top-handle-bag-small-black-A007IH2ACT21000.html"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/balenciaga.listingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | balenciaga.ListingResponse | No | ||||
| data.applied_filters | string | No | ||||
| data.count | integer | No | ||||
| data.country | string | No | ||||
| data.facets | array | No | Facet record, 5 fields: name, values. Described under Search Balenciaga products API. | |||
| data.fetched_at | string | No | ||||
| data.language | string | No | ||||
| data.limit | integer | No | ||||
| data.page | integer | No | ||||
| data.path | string | No | ||||
| data.products | array | No | ProductSummary record, 9 fields: availability, colors, currency, images, in_stock, name, price, product_id, url. Described under Search Balenciaga products API. | |||
| data.query | string | No | ||||
| data.sort | string | No | ||||
| data.sort_options | array | No | ||||
| data.source_url | string | No | ||||
| data.total_pages | integer | No | ||||
| data.total_results | integer | 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/category?path=%2Fen-en%2Fwomen%2Fbags-for-women%2Fhandbags&sort=latest&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"