# SSENSE API Scraper (`rl1987/ssense-api-scraper`) Actor

Search and browse luxury fashion products from SSENSE via its private GraphQL API. Extract product listings with brand, price, images and category data.

- **URL**: https://apify.com/rl1987/ssense-api-scraper.md
- **Developed by:** [R.L.](https://apify.com/rl1987) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 product listing rows

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## SSENSE Scraper — Luxury Fashion Product & Price Data API

**Scrape SSENSE.com product listings, brands, prices, and images at scale.** This Apify Actor extracts structured luxury fashion data from [SSENSE](https://www.ssense.com) — the leading online retailer for designer clothing, shoes, bags, and accessories — by searching keywords or browsing any category, for men, women, or everything else.

No browser automation, no HTML parsing, no CAPTCHAs. The scraper talks directly to SSENSE's product API and returns clean JSON you can export to Excel, CSV, JSON, or feed straight into your database, price-monitoring tool, or dashboard.

---

### What you can do with it

- **Competitor & price monitoring** — track designer prices, sale/markdown activity, and new arrivals across brands.
- **Product & catalog research** — build a dataset of luxury fashion products by category (bags, sneakers, dresses, jackets, jewelry, and more).
- **Brand analysis** — pull every product for a brand and compare pricing, assortment, and discounting.
- **E-commerce & resale sourcing** — find products, images, and price points for reselling, dropshipping, or market research.
- **Machine learning & trend data** — collect fashion product images and metadata for training or trend forecasting.

### Why this scraper

- ⚡ **Fast** — queries the SSENSE product API directly instead of rendering pages.
- 🎯 **Accurate** — structured fields (brand, category, regular & sale price, images, product URL) straight from source.
- 🔁 **Reliable pagination** — cross-page deduplication and end-of-results detection, so you get the full catalog without duplicates.
- 🌍 **Locale aware** — set language/country locale (default `en-US`).
- 🛡️ **Proxy ready** — routes through Apify Proxy by default to avoid blocks.
- 💸 **Pay per result** — pay-per-event pricing: you're charged per product row extracted, nothing wasted.

---

### Input

| Field | Type | Description |
|-------|------|-------------|
| `q` | string | Search keyword (e.g. `shirt`, `jeans`, `loafers`). Optional. |
| `gender` | select | `men`, `women`, or `everything-else`. Default `women`. |
| `category` | select | Browse a specific SSENSE category (Clothing, Bags, Sneakers, Dresses, Jewelry, and dozens more). Optional. |
| `maxItems` | integer | Max products to extract. `0` = unlimited (up to the per-search cap). Default `100`. |
| `locale` | string | Language/country locale. Default `en-US`. |
| `proxyConfiguration` | object | Proxy settings. Apify Proxy on by default. |

#### Example input

```json
{
  "q": "sneakers",
  "gender": "men",
  "maxItems": 200,
  "locale": "en-US"
}
````

> **Note:** SSENSE limits each search or category browse to **1,000 results** — the maximum any single run can return. To collect more, split your scraping into multiple narrower searches or categories (e.g. by keyword, brand, or subcategory).

Or browse a whole category instead of searching:

```json
{
  "gender": "women",
  "category": "women:4",
  "maxItems": 0
}
```

***

### Output

Each product is one dataset row:

```json
{
  "id": 14567890,
  "name": "Black Leather Ankle Boots",
  "brandName": "Bottega Veneta",
  "brandId": 123,
  "categoryName": "Boots",
  "categoryId": 116,
  "gender": "women",
  "priceRegular": 1350,
  "priceSale": 945,
  "images": [
    "https://img.ssensemedia.com/images/.../1.jpg"
  ],
  "url": "https://www.ssense.com/en-us/women/product/..."
}
```

| Field | Description |
|-------|-------------|
| `id` | SSENSE product ID |
| `name` | Product name |
| `brandName` / `brandId` | Designer brand |
| `categoryName` / `categoryId` | Product category |
| `gender` | `men` / `women` / `everything-else` |
| `priceRegular` | Regular price |
| `priceSale` | Sale price (if discounted) |
| `images` | Product image URLs |
| `url` | Direct link to the product page |

Export in JSON, CSV, Excel, XML, or RSS from the Apify dataset, or pull it via the [Apify API](https://docs.apify.com/api/v2).

***

### Pricing

Pay-per-event. You pay only for the data you get:

| Event | Price | Per 1,000 |
|-------|-------|-----------|
| Product listing row | $0.001 | **$1.00** |
| Product detail row *(when "Include product details" is on)* | $0.0005 | **+$0.50** |

Basic listing scraping costs **$1 per 1,000 products**. Enable **Include product details** to also fetch each product's full detail-page data (description, composition, country of origin, size/stock availability) for an extra **$0.50 per 1,000 products** — billed only for products that are actually enriched.

***

### How to run

1. Open the Actor in the [Apify Console](https://console.apify.com).
2. Set your search keyword and/or category, gender, and max items.
3. Click **Start**.
4. Download results or connect them to [Make, Zapier, Google Drive, GitHub, and 100+ integrations](https://apify.com/integrations).

### Integrations & automation

Schedule runs, get webhooks on finish, and pipe data into your stack. Works with the [Apify API](https://docs.apify.com/api/v2), [JavaScript SDK](https://docs.apify.com/sdk/js), [Python SDK](https://docs.apify.com/sdk/python), and [Apify integrations](https://apify.com/integrations) (Make, Zapier, Slack, Google Sheets, and more).

***

### Is it legal to scrape SSENSE?

This Actor collects publicly available product data. You are responsible for how you use scraped data — respect SSENSE's terms, applicable laws, and copyright on images. This tool is intended for legitimate market research, price monitoring, and analytics. See Apify's [ethical web scraping](https://blog.apify.com/is-web-scraping-legal/) guide.

***

### FAQ

**Do I need SSENSE login or API keys?** No. Just set your input and run.

**Can I scrape a whole category?** Yes — set `category` and `maxItems: 0` for the full listing, up to the 1,000-result cap per search.

**Is there a result limit?** Yes. SSENSE caps each search or category browse at **1,000 results**. Split large jobs into narrower searches or subcategories to get more.

**Can I get every product for a brand?** Search by the brand name via `q`, or browse the relevant category and filter results.

**Which countries/currencies?** Set `locale` (e.g. `en-US`) to control language and region.

***

### Support

Found a bug or need a new field? Open an issue on the Actor page. Contributions and feature requests welcome.

# Actor input Schema

## `q` (type: `string`):

Search products by keyword (e.g., 'shirt', 'dress')

## `gender` (type: `string`):

Product gender department

## `languageCode` (type: `string`):

Language for product names/descriptions

## `countryCode` (type: `string`):

Country for pricing and availability

## `sort` (type: `string`):

How to sort results

## `includeDetails` (type: `boolean`):

Fetch full product detail for each item (adds description, composition, sizes, etc.). Increases request count by 1 per product.

## `maxItems` (type: `integer`):

Maximum number of products to fetch. 0 = unlimited (can be tens of thousands of rows for a broad gender/category browse).

## `proxyConfiguration` (type: `object`):

Route requests through a proxy (Apify Proxy by default).

## `category` (type: `string`):

Browse a category (leave blank to search). Category ids are gender-specific and resolved from the selected gender at runtime.

## Actor input object example

```json
{
  "gender": "women",
  "languageCode": "en",
  "countryCode": "US",
  "sort": "LATEST_ARRIVALS",
  "includeDetails": false,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "q": "",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rl1987/ssense-api-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "q": "",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("rl1987/ssense-api-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "q": "",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call rl1987/ssense-api-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=rl1987/ssense-api-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "SSENSE API Scraper",
        "description": "Search and browse luxury fashion products from SSENSE via its private GraphQL API. Extract product listings with brand, price, images and category data.",
        "version": "0.0",
        "x-build-id": "zUCHdhBalsRzOQfcF"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/rl1987~ssense-api-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-rl1987-ssense-api-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/rl1987~ssense-api-scraper/runs": {
            "post": {
                "operationId": "runs-sync-rl1987-ssense-api-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/rl1987~ssense-api-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-rl1987-ssense-api-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "q": {
                        "title": "Search keyword",
                        "type": "string",
                        "description": "Search products by keyword (e.g., 'shirt', 'dress')"
                    },
                    "gender": {
                        "title": "Gender",
                        "enum": [
                            "women",
                            "men"
                        ],
                        "type": "string",
                        "description": "Product gender department",
                        "default": "women"
                    },
                    "languageCode": {
                        "title": "Language",
                        "enum": [
                            "en",
                            "fr"
                        ],
                        "type": "string",
                        "description": "Language for product names/descriptions",
                        "default": "en"
                    },
                    "countryCode": {
                        "title": "Country",
                        "enum": [
                            "US",
                            "CA"
                        ],
                        "type": "string",
                        "description": "Country for pricing and availability",
                        "default": "US"
                    },
                    "sort": {
                        "title": "Sort order",
                        "enum": [
                            "LATEST_ARRIVALS",
                            "PRICE_LOW_TO_HIGH",
                            "PRICE_HIGH_TO_LOW",
                            "DISCOUNT_HIGH_TO_LOW",
                            "DISCOUNT_LOW_TO_HIGH"
                        ],
                        "type": "string",
                        "description": "How to sort results",
                        "default": "LATEST_ARRIVALS"
                    },
                    "includeDetails": {
                        "title": "Include product details",
                        "type": "boolean",
                        "description": "Fetch full product detail for each item (adds description, composition, sizes, etc.). Increases request count by 1 per product.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max items",
                        "type": "integer",
                        "description": "Maximum number of products to fetch. 0 = unlimited (can be tens of thousands of rows for a broad gender/category browse).",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Route requests through a proxy (Apify Proxy by default).",
                        "default": {
                            "useApifyProxy": true
                        }
                    },
                    "category": {
                        "title": "Category",
                        "enum": [
                            "ACCESSORIES",
                            "ACCESSORIES > Bag Accessories",
                            "ACCESSORIES > Belts & Suspenders",
                            "ACCESSORIES > Blankets",
                            "ACCESSORIES > Cosmetic Cases",
                            "ACCESSORIES > Dog Accessories",
                            "ACCESSORIES > Eyewear",
                            "ACCESSORIES > Eyewear > Glasses",
                            "ACCESSORIES > Eyewear > Sunglasses",
                            "ACCESSORIES > Face Masks",
                            "ACCESSORIES > Fine Jewelry",
                            "ACCESSORIES > Fine Jewelry > Bracelets",
                            "ACCESSORIES > Fine Jewelry > Brooches",
                            "ACCESSORIES > Fine Jewelry > Earrings",
                            "ACCESSORIES > Fine Jewelry > Necklaces",
                            "ACCESSORIES > Fine Jewelry > Rings",
                            "ACCESSORIES > Gift Items",
                            "ACCESSORIES > Gloves",
                            "ACCESSORIES > Hats",
                            "ACCESSORIES > Hats > Aviator",
                            "ACCESSORIES > Hats > Beach Hats",
                            "ACCESSORIES > Hats > Beanies",
                            "ACCESSORIES > Hats > Caps",
                            "ACCESSORIES > Hats > Fedoras & Panama Hats",
                            "ACCESSORIES > Hats > Headbands & Hair Accessories",
                            "ACCESSORIES > Hats > Structured Hats",
                            "ACCESSORIES > Jewelry",
                            "ACCESSORIES > Jewelry > Bracelets",
                            "ACCESSORIES > Jewelry > Brooches",
                            "ACCESSORIES > Jewelry > Cufflinks",
                            "ACCESSORIES > Jewelry > Earrings",
                            "ACCESSORIES > Jewelry > Necklaces",
                            "ACCESSORIES > Jewelry > Pins",
                            "ACCESSORIES > Jewelry > Rings",
                            "ACCESSORIES > Keychains",
                            "ACCESSORIES > Pocket Squares & Tie Bars",
                            "ACCESSORIES > Scarves",
                            "ACCESSORIES > Scarves > Fur & Shearling",
                            "ACCESSORIES > Scarves > Knits",
                            "ACCESSORIES > Scarves > Silks & Cashmeres",
                            "ACCESSORIES > Socks",
                            "ACCESSORIES > Souvenirs",
                            "ACCESSORIES > Souvenirs > Books",
                            "ACCESSORIES > Souvenirs > Magazines",
                            "ACCESSORIES > Souvenirs > Markers",
                            "ACCESSORIES > Souvenirs > Notes & Sketches",
                            "ACCESSORIES > Souvenirs > Posters",
                            "ACCESSORIES > Souvenirs > Soccer Balls",
                            "ACCESSORIES > Tech",
                            "ACCESSORIES > Tech > Headphones",
                            "ACCESSORIES > Tech > Ipad Cases",
                            "ACCESSORIES > Tech > Iphone Cases",
                            "ACCESSORIES > Tech > Laptop Cases",
                            "ACCESSORIES > Ties",
                            "ACCESSORIES > Ties > Bow Ties",
                            "ACCESSORIES > Ties > Neck Ties",
                            "ACCESSORIES > Towels",
                            "ACCESSORIES > Umbrellas",
                            "ACCESSORIES > Wallets & Card Holders",
                            "ACCESSORIES > Wallets & Card Holders > Card Holders",
                            "ACCESSORIES > Wallets & Card Holders > Coin Pouches",
                            "ACCESSORIES > Wallets & Card Holders > Money Clips",
                            "ACCESSORIES > Wallets & Card Holders > Passport Holders",
                            "ACCESSORIES > Wallets & Card Holders > Wallets",
                            "ACCESSORIES > Watches",
                            "BAGS",
                            "BAGS > Backpacks",
                            "BAGS > Briefcases",
                            "BAGS > Clutches & Pouches",
                            "BAGS > Clutches & Pouches > Clutches",
                            "BAGS > Clutches & Pouches > Pouches",
                            "BAGS > Duffle & Top Handle Bags",
                            "BAGS > Messenger Bags & Satchels",
                            "BAGS > Pouches & Document Holders",
                            "BAGS > Shoulder Bags",
                            "BAGS > Tote Bags",
                            "BAGS > Travel Bags",
                            "CLOTHING",
                            "CLOTHING > Activewear",
                            "CLOTHING > Activewear > Dresses",
                            "CLOTHING > Activewear > Hoodies and Zip-Ups",
                            "CLOTHING > Activewear > Leggings",
                            "CLOTHING > Activewear > Outerwear",
                            "CLOTHING > Activewear > Pants",
                            "CLOTHING > Activewear > Sport Bras",
                            "CLOTHING > Activewear > Sport Shorts & Skirts",
                            "CLOTHING > Activewear > Tops",
                            "CLOTHING > Dresses",
                            "CLOTHING > Dresses > Long Dresses",
                            "CLOTHING > Dresses > Mid Length Dresses",
                            "CLOTHING > Dresses > Short Dresses",
                            "CLOTHING > Jackets & Coats",
                            "CLOTHING > Jackets & Coats > Blazers",
                            "CLOTHING > Jackets & Coats > Bombers",
                            "CLOTHING > Jackets & Coats > Coats",
                            "CLOTHING > Jackets & Coats > Denim Jackets",
                            "CLOTHING > Jackets & Coats > Down",
                            "CLOTHING > Jackets & Coats > Fur & Shearling",
                            "CLOTHING > Jackets & Coats > Jackets",
                            "CLOTHING > Jackets & Coats > Leather Jackets",
                            "CLOTHING > Jackets & Coats > Peacoats",
                            "CLOTHING > Jackets & Coats > Trench Coats",
                            "CLOTHING > Jackets & Coats > Vests",
                            "CLOTHING > Jeans",
                            "CLOTHING > Jumpsuits",
                            "CLOTHING > Lingerie",
                            "CLOTHING > Lingerie > Boy Shorts",
                            "CLOTHING > Lingerie > Bras",
                            "CLOTHING > Lingerie > Briefs",
                            "CLOTHING > Lingerie > Corsets",
                            "CLOTHING > Lingerie > Corsets & Bodysuits",
                            "CLOTHING > Lingerie > Robes",
                            "CLOTHING > Lingerie > Shapewear",
                            "CLOTHING > Lingerie > Sleepwear",
                            "CLOTHING > Lingerie > Tanks",
                            "CLOTHING > Lingerie > Thongs",
                            "CLOTHING > Pants",
                            "CLOTHING > Pants > Cargo Pants",
                            "CLOTHING > Pants > Leather Pants",
                            "CLOTHING > Pants > Leggings",
                            "CLOTHING > Pants > Lounge Pants",
                            "CLOTHING > Pants > Sweatpants",
                            "CLOTHING > Pants > Trousers",
                            "CLOTHING > Shirts",
                            "CLOTHING > Shorts",
                            "CLOTHING > Skirts",
                            "CLOTHING > Skirts > Long Skirts",
                            "CLOTHING > Skirts > Mid Length Skirts",
                            "CLOTHING > Skirts > Short Skirts",
                            "CLOTHING > Suits & Blazers",
                            "CLOTHING > Suits & Blazers > Blazers",
                            "CLOTHING > Suits & Blazers > Suits",
                            "CLOTHING > Suits & Blazers > Tuxedos",
                            "CLOTHING > Suits & Blazers > Waistcoats",
                            "CLOTHING > Sweaters",
                            "CLOTHING > Sweaters > Cardigans",
                            "CLOTHING > Sweaters > Crewnecks",
                            "CLOTHING > Sweaters > Hoodies & Zipups",
                            "CLOTHING > Sweaters > Shawlnecks",
                            "CLOTHING > Sweaters > Sweatshirts",
                            "CLOTHING > Sweaters > Turtlenecks",
                            "CLOTHING > Sweaters > V-Necks",
                            "CLOTHING > Swimwear",
                            "CLOTHING > Swimwear > Bikinis",
                            "CLOTHING > Swimwear > Cover Ups",
                            "CLOTHING > Swimwear > One-Piece",
                            "CLOTHING > Swimwear > Swimsuits",
                            "CLOTHING > Tops",
                            "CLOTHING > Tops > Blouses",
                            "CLOTHING > Tops > Bodysuits",
                            "CLOTHING > Tops > Henleys",
                            "CLOTHING > Tops > Polos",
                            "CLOTHING > Tops > Shirts",
                            "CLOTHING > Tops > T-Shirts",
                            "CLOTHING > Tops > Tank Tops",
                            "CLOTHING > Tops > Tank Tops & Camisoles",
                            "CLOTHING > Underwear & Loungewear",
                            "CLOTHING > Underwear & Loungewear > Boxers",
                            "CLOTHING > Underwear & Loungewear > Briefs",
                            "CLOTHING > Underwear & Loungewear > Pyjamas & Loungewear",
                            "CLOTHING > Underwear & Loungewear > Robes",
                            "SHOES",
                            "SHOES > Boat Shoes & Moccasins",
                            "SHOES > Boots",
                            "SHOES > Boots > Ankle Boots",
                            "SHOES > Boots > Biker & Combat Boots",
                            "SHOES > Boots > Chelsea Boots",
                            "SHOES > Boots > Desert Boots",
                            "SHOES > Boots > Lace-Up Boots",
                            "SHOES > Boots > Mid-Calf Boots",
                            "SHOES > Boots > Over the Knee Boots",
                            "SHOES > Boots > Tall Boots",
                            "SHOES > Boots > Wingtip Boots",
                            "SHOES > Boots > Zip Up & Buckled Boots",
                            "SHOES > Espadrilles",
                            "SHOES > Flats",
                            "SHOES > Flats > Ballerina Flats",
                            "SHOES > Flats > Espadrilles",
                            "SHOES > Flats > Lace Ups & Oxfords",
                            "SHOES > Flats > Slippers & Loafers",
                            "SHOES > Heels",
                            "SHOES > Lace Ups & Oxfords",
                            "SHOES > Monkstraps",
                            "SHOES > Sandals",
                            "SHOES > Sandals > Flat Sandals",
                            "SHOES > Sandals > Flip Flops",
                            "SHOES > Sandals > Heeled Sandals",
                            "SHOES > Sandals > Sandals",
                            "SHOES > Shoe Accessories",
                            "SHOES > Slippers & Loafers",
                            "SHOES > Sneakers",
                            "SHOES > Sneakers > High Top Sneakers",
                            "SHOES > Sneakers > Low Top Sneakers",
                            "SHOES > Sneakers > Wedge Sneakers"
                        ],
                        "type": "string",
                        "description": "Browse a category (leave blank to search). Category ids are gender-specific and resolved from the selected gender at runtime."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
