# Corsair — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and filter Corsair's gaming peripherals and PC components catalog by keywords, category, and product attributes like price and specs. Browse detailed product information, compare options, and easily navigate through results with sorting and pagination to find exactly what you need.

**Category:** E-commerce | **Website:** [www.corsair.com/](https://www.corsair.com/) | **Docs:** [parse.bot/marketplace/6f54bceb-e85a-4085-88df-58e6671f619c/corsair-com-api](https://parse.bot/marketplace/6f54bceb-e85a-4085-88df-58e6671f619c/corsair-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-corsair-com-api-6f54bceb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_detail

Get detailed product information by SKU. Returns comprehensive product data including description, media gallery, variants (for configurable products), categories, and pricing. A single round-trip; no pagination. SKU values can be obtained from search_products or list_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU identifier (e.g. 'CH-91E911E-NA'). Obtained from search_products.items[*].sku or list_products.items[*].sku. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-corsair-com-api-6f54bceb/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku":"<string>"}'
```

### list_products

List products by category with optional stock filtering. Returns paginated results with available filter facets and sort options. Category values correspond to category_url_key values used by the Corsair site catalog. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category URL key to filter by. Confirmed working values: keyboards, mousepads, monitors, hubs-docks, data-storage. Additional category keys can be discovered from the categories field in search_products or get_product_detail responses (url_path values). |
| `in_stock_only` | boolean | No | When true, only returns products that are currently in stock. |
| `page` | integer | No | Page number (1-indexed). |
| `page_size` | integer | No | Number of results per page. |
| `sort` | string | No | Sort field. |
| `sort_direction` | string | No | Sort direction. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-corsair-com-api-6f54bceb/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","in_stock_only":"<boolean>","page":"<integer>","page_size":"<integer>","sort":"<string>","sort_direction":"<string>"}'
```

### search_products

Full-text search over Corsair's product catalog. Returns paginated product summaries, available filter facets (aggregations), and sort options. Each result carries enough info for display; drill into get_product_detail for full specs. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed). |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search query string (e.g. 'keyboard', 'mouse', 'headset', 'ram'). |
| `sort` | string | No | Sort field. Omitting returns results sorted by relevance. |
| `sort_direction` | string | No | Sort direction. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-corsair-com-api-6f54bceb/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>","sort":"<string>","sort_direction":"<string>"}'
```