# Christies — 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 and search Christie's auction catalogs to discover artworks, explore lots across live and online auctions, and access detailed information about specific pieces and their departments. Quickly find auction results, compare items, and research private sales all in one place.

**Category:** Marketplaces | **Website:** [christies.com/](https://christies.com/) | **Docs:** [parse.bot/marketplace/67cb2c45-62bd-4eee-b9fb-a4634ff1caba/christies-com-api](https://parse.bot/marketplace/67cb2c45-62bd-4eee-b9fb-a4634ff1caba/christies-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-christies-com-api-67cb2c45/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_auction_detail

Fetch detailed metadata for a specific auction page including title, description, sale ID, and image URL. Requires the full auction landing page URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the auction landing page (e.g., https://www.christies.com/en/auction/post-war-to-present-30686/) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_auction_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_auction_lots

Paginate through all lots in an auction. Requires either a sale_id or a valid auction URL from which the sale_id can be extracted. Returns up to 100 lots per page with estimate and price realized data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (starts at 1) |
| `sale_id` | string | No | Numeric sale ID of the auction (from get_auction_detail or URL). Either sale_id or url must be provided. |
| `url` | string | No | Auction URL (used to extract sale_id if sale_id not provided) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_auction_lots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sale_id":"<string>","url":"<string>"}'
```

### get_auction_results_overview

Fetch auctions held in a specific month and year. Returns a list of auctions with metadata including title, date, location, sale total, and type. Covers both live and online-only sales that have closed in the given period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | integer | No | Month (1-12) |
| `year` | integer | No | Year (e.g., 2025) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_auction_results_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<integer>","year":"<integer>"}'
```

### get_departments

List all departments/categories at Christie's. Returns department names and URLs. Departments represent collecting areas such as Impressionist Art, Jewellery, Watches, etc.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_departments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_lot_detail

Fetch full details for an individual lot/artwork including artist, medium, dimensions, estimates, price realized, provenance, exhibition history, literature references, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the lot detail page (e.g., https://www.christies.com/en/lot/lot-6569871) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_lot_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_private_sales

List available private sale categories with their images and URLs. Private sales are works available for immediate purchase outside the auction process.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/get_private_sales \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_lots

Search Christie's database for lots matching a keyword. Returns paginated results sorted by relevance. Can search sold (past) lots or upcoming (available) lots.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_past` | boolean | No | Whether to search sold lots (true) or upcoming/available lots (false) |
| `page` | integer | No | Page number (starts at 1) |
| `query` | string | Yes | Search keyword (e.g., Picasso, Monet, landscape) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-christies-com-api-67cb2c45/search_lots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_past":"<boolean>","page":"<integer>","query":"<string>"}'
```