Yacht Auctions APIyachtauctions.com ↗
Access National Liquidators' vessel auction inventory via API. List, search, and retrieve details on boats, yachts, and watercraft listings with specs and pricing.
What is the Yacht Auctions API?
This API exposes 8 endpoints covering National Liquidators' full vessel auction inventory on yachtauctions.com, including live auctions, featured listings, and recently added boats. The get_vessel_detail endpoint returns per-vessel specs, photos, asking price, contact info, and US state location. list_vessel_listings supports filtering by make, vessel type, live auction status, keyword query, and sort order, returning up to 18 results per page.
curl -X GET 'https://api.parse.bot/scraper/c3da45f2-c2b5-4cee-afa8-0e82c04cff14/list_vessel_listings?page=0&sort_by=date_desc&live_auctions=False' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace yachtauctions-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: National Liquidators vessel auction SDK — browse, search, and inspect vessels."""
from parse_apis.national_liquidators_vessel_api import NationalLiquidators, Sort, VesselNotFound
client = NationalLiquidators()
# Browse available vessel makes to discover filter options
for make in client.makes.list(limit=5):
print(make.name, make.slug, make.count)
# Search for Sea Ray vessels and get the first result's full details
listing = client.listings.search(query="Sea Ray", limit=1).first()
if listing:
vessel = listing.details()
print(vessel.title, vessel.asking_price, vessel.state)
print(f"Photos: {len(vessel.photos)}, Specs: {list(vessel.specs.keys())}")
# List vessels sorted by price ascending using the Sort enum
for item in client.listings.list(sort_by=Sort.PRICE_ASC, limit=3):
print(item.title, item.price, item.location)
# Get live auction listings
for auction in client.listings.live_auctions(limit=3):
print(auction.title, auction.badges, auction.location)
# Handle a missing vessel gracefully
try:
missing = client.listing(slug="nonexistent-vessel-9999").details()
except VesselNotFound as exc:
print(f"Vessel not found: {exc.slug}")
print("exercised: makes.list / listings.search / listing.details / listings.list / listings.live_auctions")
List vessel listings with pagination and filters. Returns up to 18 items per page. Supports filtering by make, vessel type, live auction status, text search, and sorting. Paginates via zero-based page number.
| Param | Type | Description |
|---|---|---|
| make | string | Filter by vessel make slug from get_vessel_makes (e.g. 'sea-ray', 'bayliner'). |
| page | integer | Zero-based page number. Each page returns up to 18 items. |
| query | string | Free-text keyword to search vessel titles and descriptions. |
| sort_by | string | Sort option slug. |
| vessel_type | string | Filter by vessel type slug from get_vessel_types (e.g. 'center-console', 'cruiser'). |
| live_auctions | boolean | Set to true to show only live auction listings. Omission shows all listings. |
{
"type": "object",
"fields": {
"page": "integer, current zero-based page number",
"count": "integer, number of items returned on this page",
"items": "array of listing objects with title, url, slug, price, location, badges, and thumbnail"
},
"sample": {
"data": {
"page": 0,
"count": 18,
"items": [
{
"url": "https://yachtauctions.com/browse/2019-sea-ray-slx-230-stk-41740/",
"slug": "2019-sea-ray-slx-230-stk-41740",
"price": "USD $41,500",
"title": "2019 Sea Ray SLX 230 – Stk# 41740",
"badges": [],
"location": "Located in Florida",
"thumbnail": "https://yachtauctions.com/wp-content/uploads/2026/05/41740-6-768x576.jpg"
}
]
},
"status": "success"
}
}About the Yacht Auctions API
Listing and Searching Vessels
The list_vessel_listings endpoint is the primary way to browse inventory. It accepts a zero-based page integer, free-text query string, make slug (sourced from get_vessel_makes), vessel_type slug (sourced from get_vessel_types), and a sort_by option — verified values include date_desc, _price_asc, _wpgb_featured_product_desc, and acf/year_desc. Setting live_auctions to 'true' filters down to only currently active auction listings. Each page returns up to 18 items, each with title, url, slug, price, location, badges, and thumbnail. The search_vessels endpoint provides a direct keyword search matched against vessel titles and descriptions.
Vessel Detail Data
get_vessel_detail takes a vessel slug (formatted as <year>-<make>-<model>-stk-<id>) and returns the full listing: asking_price, description, photos array, contact_email, contact_phone, location_office, state, and a specs object organized by category with key-value pairs for hull, engine, dimensions, and other vessel attributes. If the listing no longer exists, the endpoint returns input_not_found.
Convenience Endpoints and Taxonomy
list_live_auctions and list_featured_listings require no inputs and return the same listing object shape used across all list endpoints. list_recently_listed returns up to 18 listings sorted by date descending — useful for monitoring new inventory as it becomes available. get_vessel_makes and get_vessel_types each return an array with name, slug, and count fields, giving you the full set of valid filter values for list_vessel_listings.
The Yacht Auctions API is a managed, monitored endpoint for yachtauctions.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yachtauctions.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yachtauctions.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new vessel inventory by polling
list_recently_listedand alerting when target makes appear. - Build a vessel comparison tool by pulling
specsfrom multipleget_vessel_detailcalls. - Track active auction count over time using
list_live_auctionsresponsecount. - Aggregate asking price distributions by vessel type using
list_vessel_listingswithvessel_typeand_price_ascsort. - Generate a make-specific inventory digest using
get_vessel_makesslugs piped intolist_vessel_listings. - Display a curated featured listings widget using
list_featured_listingsthumbnail and price fields. - Build a regional vessel search tool by filtering
get_vessel_detailresults on thestatefield.
| 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 | 100 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 yachtauctions.com have an official developer API?+
What does `get_vessel_detail` return in the `specs` object?+
specs field is an object of named categories — such as hull, engine, and dimensions — each containing key-value pairs for the attributes listed under that category. The exact keys present vary by listing depending on what the seller has provided. The endpoint also returns photos (array of image URLs), asking_price, state, contact_email, contact_phone, location_office, and the full description text.How does pagination work in `list_vessel_listings`?+
page parameter is zero-based, so page 0 is the first page. Each page returns at most 18 items. The response includes a count field reflecting how many items were returned on that specific page, not the total inventory count. To walk through all results, increment page until count is less than 18.Can I retrieve historical sold or completed auction listings?+
Are bid amounts or auction end times available in listing results?+
price, title, location, badges, slug, url, and thumbnail. The detail endpoint returns asking_price but no bid history, current bid amount, or auction countdown data. You can fork this API on Parse and revise it to surface those fields if they appear on individual listing pages.