# Revolve — 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.

> Browse Revolve.com's fashion inventory by searching products, filtering by category or sale status, and discovering new arrivals in real-time. Access detailed product information including pricing, descriptions, and availability to power your shopping app or fashion platform.

**Category:** E-commerce | **Website:** [revolve.com/](https://revolve.com/) | **Docs:** [parse.bot/marketplace/7c161602-6c8c-427d-b042-8385f2517689/revolve-com-api](https://parse.bot/marketplace/7c161602-6c8c-427d-b042-8385f2517689/revolve-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-revolve-com-api-7c161602/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_new_arrivals

Fetch new arrival products. Returns a page of recently added items across all categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-revolve-com-api-7c161602/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_detail

Fetch full product details by product code. Returns brand, name, price, available sizes with stock status, image URLs, description bullet points, and 'complete the look' recommendations. Each product code is a short alphanumeric identifier visible in Revolve URLs (e.g. /dp/437R-WD2/).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_code` | string | Yes | Revolve product code (alphanumeric with hyphens, e.g. '437R-WD2') |

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

### get_products_by_category

Browse products in a category. Resolves the category name via site navigation and returns a page of product listings. Categories include clothing types like dresses, shoes, tops, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category name as it appears in site navigation (e.g. 'dresses', 'shoes', 'tops', 'jeans') |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-revolve-com-api-7c161602/get_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_sale_items

Fetch sale items. Returns a page of discounted products with both regular and sale prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-revolve-com-api-7c161602/get_sale_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_products

Search for products by keyword. Supports single and multi-word queries. Returns a page of product listings sorted by relevance. Each product includes code, name, brand, price, image URL, and product page URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (e.g. 'dress', 'black dress', 'maxi skirt') |

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