---
title: "Browse a lululemon category's product listing"
method: GET
path: "/lululemon/category"
tags: ["Lululemon"]
---

# Browse a lululemon category's product listing

`GET /lululemon/category`

## Request

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

Returns one lululemon category's product listing page: products with pricing, sale detection, sizes, colors, and style numbers. category and cdp_hash are the two path segments of a lululemon category URL (https://shop.lululemon.com/c/{category}/{cdp_hash}), e.g. women-new-styles and n14f1wz6o10 -- both are also available from lululemon-categories's own category and cdp_hash fields. Pagination is page-based and real: requesting a page beyond the category's real last page returns a normal response with an empty products array rather than an error. An unrecognized category/cdp_hash pair returns 404.

## Query parameters

- `category` string, required
- `cdp_hash` string, required
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- LululemonCategoryResponseDoc
  - `code` integer
  - `data` LululemonCategoryResponse
    - `category` string: Category slug that was requested, such as `women-new-styles`.
    - `cdp_hash` string: Short id segment of the category URL that was requested.
    - `count` integer: Number of products returned on this page.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `page` integer: Page number returned, starting at 1.
    - `page_size` integer: Maximum number of products on a page.
    - `products` LululemonProductSummary[]: Products listed on this page of the category.
      - `activities` string[]: Activities the product is designed for, such as `Casual` or `Lounge`.
      - `category` string: Name of the product's category, such as `Sweatpants`.
      - `category_id` string: Id of the product's category, such as `womens-sweatpants`.
      - `colors` string[]: Names of the colors the product comes in. Positions match `style_numbers`.
      - `currency` string: Currency code of the prices, such as `USD`.
      - `id` string: lululemon product id.
      - `image_url` string: URL of the first image lululemon lists for the product.
      - `list_price` number: List price of the product.
      - `name` string: Product name as shown on lululemon.
      - `new_arrival` boolean: Whether lululemon flags the product as a new arrival.
      - `on_sale` boolean: Whether the product is on sale.
      - `price` number: Current price of the product.
      - `sale_price` number: Sale price of the product. Set only when `on_sale` is `true`.
      - `sizes` string[]: Sizes the product is available in.
      - `style_numbers` string[]: Style numbers of the product, one per color. Positions match `colors`.
      - `unified_id` string: lululemon's unified product id, a slug such as `Scuba-Evolve-Straight-Leg-Pant-Regular`.
      - `url` string: URL of the product page on lululemon.
    - `source_url` string: URL the data was read from.
    - `total_products` integer: Total number of products in the category.
  - `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)