Docs menu

Balenciaga API endpoint

Search Balenciaga products API

Searches Balenciaga's storefront by keyword using the site's own product-grid fragment. q is required; sort accepts latest, price_ascending, or price_descending; page is one-based with 12 products per page; and filters accepts comma-separated exact field:value pairs from live facets. Repeat a field to OR multiple values within that facet. A genuine no-result query returns an empty products list.

GETapiKey3 credits/requestBalenciagabalenciaga.listingResponseDoc/balenciaga/search

Endpoint facts

Method: GET
API path: /balenciaga/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Balenciaga
Response schema: #/definitions/balenciaga.listingResponseDoc

Balenciaga Scraper API Try Search Balenciaga products API in Playground Balenciaga API documentation

How this endpoint behaves

Query parameters:

q (required): free-text search query.
sort (optional): one of latest, price_ascending, or price_descending; defaults to latest.
page (optional): one-based page number; defaults to 1. Search pages contain 12 products.
filters (optional): comma-separated exact field:value pairs from the response's live facets. Repeat a field to OR multiple values within that facet, for example akeneo_macroColor:BLACK,akeneo_macroColor:WHITE. The live search surface currently exposes facet groups such as akeneo_macroColor, akeneo_productCategoryFilter, akeneo_materialFilter, akeneo_sellingLine, akeneo_stoneFilter, and size; use the returned facets values as the accepted value space.

Notable response behavior:

Search uses the product-grid fragments fired by Balenciaga's own sort and load-more controls.
Search filters are passed to the same storefront facet parameters as the live UI; different facet fields are combined, and repeated values within one field are ORed upstream.
A genuine no-result query returns count: 0 and products: [].
Product URLs in the response can be passed directly to balenciaga-product.

Live monitoring

Monitored request: GET /balenciaga/search?q=hourglass
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.53 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /balenciaga/search?q=hourglass
Items in products: 12
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 12 checked	Values in the sample
product_id	12
name	12	“hourglass handbag xs” and 7 other values
in_stock	12	true in 10 of 12
images	12	median 4 entries
url	12	balenciaga.com
colors	6	median 4 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Free-text search query	hourglass
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
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 example

curl -X GET "https://api.crawlora.net/api/v1/balenciaga/search?q=hourglass&sort=latest&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "hourglass",
    "sort": "latest",
    "country": "ZW",
    "language": "en",
    "page": 1,
    "limit": 12,
    "count": 1,
    "total_results": 35,
    "products": [
      {
        "product_id": "A007IH2ACT21000",
        "name": "HOURGLASS AVENUE TOP HANDLE BAG SMALL",
        "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	Example
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
data.facets[].name	string	No
data.facets[].values	array	No
data.facets[].values[].count	integer	No
data.facets[].values[].label	string	No
data.facets[].values[].value	string	No
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
data.products[].availability	string	No
data.products[].colors	array	No
data.products[].currency	string	No
data.products[].images	array	No
data.products[].in_stock	boolean	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].product_id	string	No
data.products[].url	string	No
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

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/balenciaga/search?q=hourglass&sort=latest&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Balenciaga endpoint docs Balenciaga Scraper API List Balenciaga categories API documentation Browse a Balenciaga category API documentation Get a Balenciaga product API documentation Get Balenciaga product variations API documentation Balenciaga Store-Locator Countries API documentation List Balenciaga stores API documentation

Open in Playground Back to group

Docs menu

Balenciaga API endpoint

Search Balenciaga products API

GETapiKey3 credits/requestBalenciagabalenciaga.listingResponseDoc/balenciaga/search

Endpoint facts

Method: GET
API path: /balenciaga/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Balenciaga
Response schema: #/definitions/balenciaga.listingResponseDoc

Balenciaga Scraper API Try Search Balenciaga products API in Playground Balenciaga API documentation

How this endpoint behaves

Query parameters:

q (required): free-text search query.
sort (optional): one of latest, price_ascending, or price_descending; defaults to latest.
page (optional): one-based page number; defaults to 1. Search pages contain 12 products.
filters (optional): comma-separated exact field:value pairs from the response's live facets. Repeat a field to OR multiple values within that facet, for example akeneo_macroColor:BLACK,akeneo_macroColor:WHITE. The live search surface currently exposes facet groups such as akeneo_macroColor, akeneo_productCategoryFilter, akeneo_materialFilter, akeneo_sellingLine, akeneo_stoneFilter, and size; use the returned facets values as the accepted value space.

Notable response behavior:

Search uses the product-grid fragments fired by Balenciaga's own sort and load-more controls.
Search filters are passed to the same storefront facet parameters as the live UI; different facet fields are combined, and repeated values within one field are ORed upstream.
A genuine no-result query returns count: 0 and products: [].
Product URLs in the response can be passed directly to balenciaga-product.

Live monitoring

Monitored request: GET /balenciaga/search?q=hourglass
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.53 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /balenciaga/search?q=hourglass
Items in products: 12
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 12 checked	Values in the sample
product_id	12
name	12	“hourglass handbag xs” and 7 other values
in_stock	12	true in 10 of 12
images	12	median 4 entries
url	12	balenciaga.com
colors	6	median 4 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Free-text search query	hourglass
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
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 example

curl -X GET "https://api.crawlora.net/api/v1/balenciaga/search?q=hourglass&sort=latest&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "hourglass",
    "sort": "latest",
    "country": "ZW",
    "language": "en",
    "page": 1,
    "limit": 12,
    "count": 1,
    "total_results": 35,
    "products": [
      {
        "product_id": "A007IH2ACT21000",
        "name": "HOURGLASS AVENUE TOP HANDLE BAG SMALL",
        "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	Example
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
data.facets[].name	string	No
data.facets[].values	array	No
data.facets[].values[].count	integer	No
data.facets[].values[].label	string	No
data.facets[].values[].value	string	No
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
data.products[].availability	string	No
data.products[].colors	array	No
data.products[].currency	string	No
data.products[].images	array	No
data.products[].in_stock	boolean	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].product_id	string	No
data.products[].url	string	No
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

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/balenciaga/search?q=hourglass&sort=latest&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search Balenciaga products API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search Balenciaga products API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related