---
title: "Search Burberry products"
method: GET
path: "/burberry/search"
tags: ["Burberry"]
---

# Search Burberry products

`GET /burberry/search`

## Request

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

Searches Burberry's product catalog by keyword. Returns product summaries plus the upstream's own available filters (facets) with live per-option result counts. offset paginates in increments of 20 (the upstream's own fixed page size). sort selects the result order. facets applies a facet selection back, a comma-separated list of property:value pairs taken from this same response's facets field (e.g. benefit:bags,dotcomreportingcolour:black). A query with no matches, or a facet combination with no matches, returns a well-formed empty result, not an error. Unlike burberry-category, this response has no true grand-total result count -- only the current page's own count.

## Query parameters

- `query` string, required
- `offset` integer
- `sort` 'default' | 'price_asc' | 'price_desc' | 'newest'
- `facets` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BurberrySearchResponseDoc
  - `code` integer
  - `data` BurberrySearchResponse
    - `applied_facets` string: AppliedFacets echoes back the facets parameter that was applied to this request, if any.
    - `count` integer
    - `facets` BurberryFacet[]
      - `label` string
      - `name` string
      - `options` BurberryFacetOption[]
        - `count` integer
        - `label` string
        - `value` string
    - `fetched_at` string
    - `offset` integer
    - `products` BurberryProduct[]
      - `color` string
      - `currency` string
      - `id` string
      - `image_url` string
      - `limited_availability` boolean
      - `name` string
      - `number_of_colours` integer
      - `on_markdown` boolean
      - `original_price` number
      - `price` number
      - `sold_out` boolean
      - `url` string
    - `query` string
    - `sort` string
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/028417aa35bb?raw)