# Encheres Publiques — 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 browse real estate, vehicle, art, and equipment auctions across France, viewing detailed lot information and upcoming auction events from various organizers. Filter auction listings by category and type to find specific items and compare auction details to make informed bidding decisions.

**Category:** Marketplaces | **Website:** [encheres-publiques.com/](https://encheres-publiques.com/) | **Docs:** [parse.bot/marketplace/e370c383-8ea1-4b3e-b3ee-fe92cb66bc02/encheres-publiques-com-api](https://parse.bot/marketplace/e370c383-8ea1-4b3e-b3ee-fe92cb66bc02/encheres-publiques-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-encheres-publiques-com-api-e370c383/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_auction_event_detail

Retrieve full details of a single auction event by its numeric ID. Returns the event schedule, organizer, address, and a mosaique of its lots. Returns input_not_found when the event does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique numeric ID of the event. Obtainable from list_auction_events results collection[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encheres-publiques-com-api-e370c383/get_auction_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_auction_lot_detail

Retrieve full details of a single auction lot by its numeric ID. Returns pricing, description, address, event info, organizer, photos, and property-specific criteria. Returns input_not_found when the lot does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_id` | string | Yes | Unique numeric ID of the lot. Obtainable from search_auction_lots results collection[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encheres-publiques-com-api-e370c383/get_auction_lot_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_id":"<string>"}'
```

### list_auction_events

List upcoming and recent auction events sorted by opening date (furthest future first). Supports filtering by category and location. Paginates via the last item's ID as cursor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter events. |
| `cursor` | string | No | Pagination cursor (last item's id from a previous response) to fetch the next page. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | No | Location slug to filter by geographic area (e.g. paris-75). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encheres-publiques-com-api-e370c383/list_auction_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>"}'
```

### list_organizer_profiles

List auction organizer profiles (tribunals, notaries, auction houses, bailiffs) sorted by trending popularity. Returns a single page of up to limit profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encheres-publiques-com-api-e370c383/list_organizer_profiles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### search_auction_lots

Full-text search over French public auction lots. Returns results sorted by trending popularity. Supports filtering by category, sub-category, location, and whether to include past/sold lots. Each lot includes pricing, status, event info, and organizer. Paginates via the last item's ID as cursor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter lots. |
| `cursor` | string | No | Pagination cursor (last item's id from a previous response) to fetch the next page. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | No | Location slug to filter by geographic area (e.g. paris-75). |
| `sub_category` | string | No | Sub-category slug to narrow results within a category (e.g. appartements, maisons, terrains). |
| `termine` | boolean | No | Whether to include past/sold lots in results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encheres-publiques-com-api-e370c383/search_auction_lots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>","sub_category":"<string>","termine":"<boolean>"}'
```