---
title: "Browse a Burberry category"
method: GET
path: "/burberry/category"
tags: ["Burberry"]
---

# Browse a Burberry category

`GET /burberry/category`

## Request

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

Returns one page (20 products) of a Burberry category/browse listing. category is the site-relative category path, e.g. /l/womens-clothing/new-arrivals/ -- use burberry-categories to discover every valid value instead of guessing from site URLs. offset paginates in increments of 20 (the upstream's own fixed page size). sort selects the result order. The response includes the upstream's own available filters (facets) with live per-option result counts; feed a selection back in via facets, a comma-separated list of property:value pairs taken from this same response's facets field (e.g. benefit:bags,dotcomreportingcolour:black -- see a live response for the values valid for that category). At most one value per facet property; an unmatched or invalid combination returns a well-formed empty result, not an error.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BurberryCategoryResponseDoc
  - `code` integer
  - `data` BurberryCategoryResponse
    - `applied_facets` string: AppliedFacets echoes back the facets parameter that was applied to this request, if any.
    - `category` string
    - `count` integer
    - `facets` BurberryFacet[]: Facets lists the upstream's own available filters (category, colour, size, price range, and others depending on the category) with live per-option result counts. Feed a selection back in via this request's own facets parameter (property:value, taken from a Facet's Name and one of its Options' Value).
      - `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
    - `sort` string
    - `source_url` string
    - `total_products` 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)