---
title: "Search Balenciaga products"
method: GET
path: "/balenciaga/search"
tags: ["Balenciaga"]
---

# Search Balenciaga products

`GET /balenciaga/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/balenciaga/search`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `q` string, required
- `sort` 'latest' | 'price_ascending' | 'price_descending'
- `page` integer
- `filters` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BalenciagaListingResponseDoc
  - `code` integer
  - `data` BalenciagaListingResponse
    - `applied_filters` string
    - `count` integer
    - `country` string
    - `facets` BalenciagaFacet[]
      - `name` string
      - `values` BalenciagaFacetValue[]
        - `count` integer
        - `label` string
        - `value` string
    - `fetched_at` string
    - `language` string
    - `limit` integer
    - `page` integer
    - `path` string
    - `products` BalenciagaProductSummary[]
      - `availability` string
      - `colors` string[]
      - `currency` string
      - `images` string[]
      - `in_stock` boolean
      - `name` string
      - `price` number
      - `product_id` string
      - `url` string
    - `query` string
    - `sort` string
    - `sort_options` string[]
    - `source_url` string
    - `total_pages` integer
    - `total_results` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)
