# Yachtbuyer — 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 thousands of used and new yachts, boats, and tenders with detailed listings and specifications. Stay informed with the latest maritime news and intelligence while discovering top-rated vessels in the market.

**Category:** Marketplaces | **Website:** [yachtbuyer.com/](https://yachtbuyer.com/) | **Docs:** [parse.bot/marketplace/363f4e2e-6ce5-4df1-84cb-3f28c6e73af2/yachtbuyer-com-api](https://parse.bot/marketplace/363f4e2e-6ce5-4df1-84cb-3f28c6e73af2/yachtbuyer-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-yachtbuyer-com-api-363f4e2e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Get full details for a yacht or boat listing by its URL, including specifications organized by category, images, broker information, amenities, structured LD+JSON data, and description. Specifications are grouped into categories like 'Principal Characteristics', 'Dimensions', 'Hull & Superstructure', etc.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full listing URL on yachtbuyer.com (e.g. 'https://www.yachtbuyer.com/en/benetti/for-sale/mar-536a44c3'). |

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

### get_news

Get the latest yacht news articles from YachtBuyer including new model launches, fleet updates, industry news, and event coverage. Articles include title, URL, publication date, and summary when available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yachtbuyer-com-api-363f4e2e/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top100_yachts

Get the Top 100+ longest yachts list ranked by length. Returns yacht names with their rank position and vessel ID. The list includes the world's largest superyachts and megayachts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yachtbuyer-com-api-363f4e2e/get_top100_yachts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### resolve_overlay

Resolve an overlay link to get direct listing URLs and broker information. Overlay IDs appear in search results for yachts listed by multiple brokers. Returns the available listing URLs with their associated broker details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `overlay_id` | string | Yes | Overlay ID from search results (e.g. '2199048158'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yachtbuyer-com-api-363f4e2e/resolve_overlay \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"overlay_id":"<string>"}'
```

### search_boats

Search for boats for sale from builders. Returns paginated results. Boat listings typically include name, url, and brand but not price, location, year, engines, or features.

**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-yachtbuyer-com-api-363f4e2e/search_boats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_new_yachts

Search for new yachts (builder models) available from manufacturers. Returns paginated results. New yacht listings typically include name, url, and brand but not price, location, year, engines, or features.

**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-yachtbuyer-com-api-363f4e2e/search_new_yachts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_used_yachts

Search for used yachts for sale with optional filters for length, budget, cabins, geography, and sorting. Returns paginated results with yacht details including price, location, year, engines, and features. Each page returns up to ~30 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `budget_from` | string | No | Minimum budget filter in currency units. |
| `budget_to` | string | No | Maximum budget filter in currency units. |
| `cabins_from` | string | No | Minimum number of cabins. |
| `cabins_to` | string | No | Maximum number of cabins. |
| `geo` | string | No | Geographic filter (e.g. 'int' for international). |
| `length_from` | string | No | Minimum length in meters. |
| `length_to` | string | No | Maximum length in meters. |
| `page` | integer | No | Page number for pagination. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yachtbuyer-com-api-363f4e2e/search_used_yachts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"budget_from":"<string>","budget_to":"<string>","cabins_from":"<string>","cabins_to":"<string>","geo":"<string>","length_from":"<string>","length_to":"<string>","page":"<integer>","sort_by":"<string>"}'
```