yachtworld.com APIyachtworld.com ↗
Search and retrieve boat listings from YachtWorld.com. Filter by make, class, type, location, and price. Get full specs, media, and broker contact info.
curl -X GET 'https://api.parse.bot/scraper/242b2dc6-c896-4c4c-bef5-3db255d870a9/search_boats_for_sale?page=1&limit=33&price_max=200000&price_min=50000' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for boats for sale with comprehensive filters including make, type, class, condition, location, price range, and year range. Returns paginated results with sponsored listings, facets for filtering, and ordered result records.
| Param | Type | Description |
|---|---|---|
| make | string | Boat manufacturer name (e.g., 'Beneteau', 'Sea Ray') |
| page | integer | Page number (1-based) |
| sort | string | Sort order: 'recommended', 'price_asc', 'price_desc', 'length_asc', 'length_desc', 'year_asc', 'year_desc', 'listed_date_desc' |
| type | string | Boat type: 'power', 'sail', or 'unpowered' |
| class | string | Boat class slug (e.g., 'power-center', 'sail-cruiser', 'power-motor'). Use get_boat_types to see available values. |
| limit | integer | Results per page |
| facets | string | Additional raw facet string to append |
| country | string | Country code (e.g., 'US', 'GB', 'IT') |
| owner_id | string | Broker/dealer owner ID to filter listings by a specific dealer |
| year_max | integer | Maximum model year |
| year_min | integer | Minimum model year |
| condition | string | Boat condition: 'new' or 'used' |
| fuel_type | string | Fuel type: 'gasoline', 'diesel', 'electric', or 'other' |
| price_max | integer | Maximum price in USD |
| price_min | integer | Minimum price in USD |
{
"type": "object",
"fields": {
"facets": "object with filtering facets (fuelType, make, class, hullMaterial, etc.)",
"sponsored": "object containing count and records array of sponsored listings",
"orderedResults": "object containing count, records array of listing objects, and nextFrom pagination cursor"
},
"sample": {
"data": {
"facets": {
"class": [
{
"count": 4696,
"value": "power-center"
}
],
"fuelType": [
{
"count": 18698,
"value": "gasoline"
}
]
},
"sponsored": {
"count": 4,
"records": [
{
"id": 9659202,
"make": "Azimut",
"year": 2025,
"class": "power-motor",
"model": "Grande 26M",
"price": {
"type": {
"amount": {
"USD": 6754740.65
}
},
"hidden": false
}
}
]
},
"orderedResults": {
"count": 27971,
"records": [
{
"data": {
"id": 10113175,
"make": "Sunseeker",
"year": 1998,
"class": "power-motor",
"model": "Manhattan 62",
"price": {
"type": {
"amount": {
"USD": 58736.88
}
},
"hidden": false
}
},
"type": "listing"
}
],
"nextFrom": 36
}
},
"status": "success"
}
}About the yachtworld.com API
The YachtWorld API provides access to boat listings across 6 endpoints, letting you search inventory by make, class, type, condition, location, price range, and year. The search_boats_for_sale endpoint returns paginated results with sponsored listings, filterable facets, and a pagination cursor. get_boat_detail delivers full listing data including specs, media URLs, propulsion details, pricing, and broker contact information for any individual listing.
Search and Filter Listings
The search_boats_for_sale endpoint accepts a broad set of query parameters: make (e.g., 'Beneteau', 'Sea Ray'), type ('power', 'sail', or 'unpowered'), class (a slug like 'power-center' or 'sail-cruiser'), country code, price range, year range, and sort options including recommended, price_asc, price_desc, length_asc, length_desc, year_asc, and year_desc. Results are paginated and include a nextFrom cursor for deep pagination. The facets object in the response surfaces available filter values for fuel type, hull material, make, and class, which you can feed back into subsequent queries.
Listing Detail and Taxonomy
get_boat_detail takes a numeric boat_id and returns a complete listing record: make, model, year, type, class, condition, a price object with currency amounts, a media array with asset URLs, a contact object with broker details, and additional spec fields covering propulsion and location. get_boat_types requires no inputs and returns the full taxonomy used across the platform — an array of class objects each carrying a value slug, name, count, and heading category. Use this to discover valid values for the class parameter before querying.
Focused Search Endpoints
Three endpoints provide scoped searches without requiring the full filter set. search_boats_by_make accepts a required make string and returns the same structure as the main search. search_boats_by_class accepts a required class slug (e.g., 'power-pontoon', 'power-motor') and paginates results within that class. get_broker_listings accepts a required owner_id — a numeric string identifying a broker or dealer — and returns all active listings for that seller. All three endpoints share the same response shape: facets, sponsored, and orderedResults with count, records, and nextFrom.
- Aggregate new and used boat inventory across multiple makes for a marine marketplace or comparison site
- Build a boat valuation tool using price, year, condition, and class fields from listing records
- Monitor a specific broker's active inventory by polling
get_broker_listingswith theirowner_id - Power a search UI with dynamic facet filters sourced from the
facetsresponse object (fuelType, hullMaterial, make, class) - Display media galleries for boat listings using the
mediaarray of asset URLs fromget_boat_detail - Index the full boat class taxonomy from
get_boat_typesto populate a class-browser or navigation menu - Track price changes on specific listing IDs by storing and diffing the
priceobject fromget_boat_detailover time
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does YachtWorld have an official developer API?+
What does `get_boat_detail` return beyond what appears in search results?+
get_boat_detail returns the full listing record for a single boat, including the media array of asset URLs, a contact object with broker contact information, a price object with currency breakdown, condition (new or used), and propulsion-related spec fields. Search result records contain a subset of these fields. You need the numeric boat_id from a search result to call this endpoint.How does pagination work across search endpoints?+
orderedResults object containing a count, a records array, and a nextFrom cursor string. Pass the page parameter (1-based integer) to step through results. The limit parameter controls records per page. The nextFrom cursor can be used for offset-based deep pagination when sequential page numbers are insufficient.Does the API cover boat rental listings or charter availability?+
Are there any known gaps in geographic or listing coverage?+
country filter in search_boats_for_sale accepts standard country codes (e.g., 'US', 'GB', 'IT'), but coverage density varies by market — YachtWorld's inventory skews toward North American and Western European listings. Listings that are marked inactive or sold are not returned. Historical sold-listings data and price history are not exposed by any current endpoint. You can fork this API on Parse and revise it to attempt coverage of sold or archived listings if your use case requires that data.