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

> Explore Rolex's complete watch catalog to compare models, editions, and specifications, then check pricing and locate nearby authorized stores. Access user guides and brochures to learn more about any timepiece.

**Category:** E-commerce | **Website:** [rolex.com/](https://rolex.com/) | **Docs:** [parse.bot/marketplace/22eb18da-f5ff-4cb8-be70-19a1a286ffc4/rolex-com-api](https://parse.bot/marketplace/22eb18da-f5ff-4cb8-be70-19a1a286ffc4/rolex-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-rolex-com-api-22eb18da/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### find_store_locator

Find Rolex retailers and service centers filtered by country. Returns establishment names, addresses, coordinates, opening hours, contact information, and store type (STORE or SERVICECENTER).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO 2-letter country code to filter results (e.g. 'US', 'GB', 'FR', 'DE', 'JP'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/find_store_locator \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>"}'
```

### get_all_watch_models

Get all Rolex watch model families with their names, slugs, taglines, categories, and image URLs. Returns classic, professional, and 'find your Rolex' category models. Each model includes a slug that can be used to fetch detailed model pages or edition listings.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_all_watch_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_brochures_list

Get all available brochures metadata including titles, subtitles, family codes, reference numbers, and file paths. Returns page components containing cover headings and download sections with brochure elements.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_brochures_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_user_guides_list

Get all available user guides metadata including titles, family codes, and file paths for Rolex watch models and accessories. Returns page components containing cover headings and download sections with user guide elements.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_user_guides_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_watch_edition_detail

Get full specifications and pricing for a specific watch reference. Returns detailed case, dial, bracelet, movement specs, editorial mapping, and US pricing including formatted price string.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `reference` | string | Yes | The watch reference number (e.g. 'm124060-0001', 'm126613lb-0002'). Obtain from get_watch_editions_by_model results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_watch_edition_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference":"<string>"}'
```

### get_watch_editions_by_model

List all individual watch editions/references for a given model family via Coveo search. Returns reference numbers, case descriptions, image URLs, and product page URLs for each edition in the family.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `family_code` | string | Yes | The family code of the model (e.g. 'submariner', 'cosmograph-daytona', 'datejust'). Obtain from get_all_watch_models results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_watch_editions_by_model \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"family_code":"<string>"}'
```

### get_watch_model_detail

Get the full CMS page data for a specific model family, including cover media, editorial content, navigation structure, and metadata. Returns rich content components such as covers, video players, roller galleries, and sub-navigation items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_slug` | string | Yes | The slug of the model family (e.g. 'submariner', 'cosmograph-daytona', 'datejust'). Obtain from get_all_watch_models results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/get_watch_model_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_slug":"<string>"}'
```

### search_watches

Search for watches and other Rolex content by keyword via Coveo search. Returns matching results including watches, articles, and retailer listings with title, URI, excerpt, and raw metadata fields. Results are ranked by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Daytona', 'gold', 'submariner') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolex-com-api-22eb18da/search_watches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```