boats.com APIboats.com ↗
Search boat listings by type, make, year, and condition. Retrieve specs, pricing, seller info, and full descriptions from boats.com via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/99ad4dc1-13f5-486d-8294-95eea0f35502/search_boats?make=boston-whaler&page=2&query=boats' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for boat listings with various filters. Returns a paginated list of matching boats including title, price, year, location, and image URL.
| Param | Type | Description |
|---|---|---|
| make | string | Boat manufacturer/make as a lowercase slug (e.g. 'boston-whaler', 'tracker', 'sea-ray'). |
| page | integer | Page number for pagination. |
| year_to | integer | Maximum year of manufacture. |
| boat_type | string | Type of boat. Accepted values: 'power', 'sail', 'unpowered'. |
| condition | string | Condition of the boat. Accepted values: 'used', 'new'. |
| year_from | integer | Minimum year of manufacture. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"listings": "array of objects containing boat summary data (id, title, year, price, location, url, image_url)",
"total_results": "integer, count of listings on current page"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "10090371",
"url": "https://www.boats.com/power-boats/2020-carver-c52-10090371/",
"year": "2020",
"price": "$974,000",
"title": "Carver C52",
"location": "HUNTINGTON HARBOUR, California",
"image_url": "https://images.boats.com/resize/1/3/71/2020-carver-c52-power-10090371-20260308143857149-0.jpg?t=1773005921000"
}
],
"total_results": 24
},
"status": "success"
}
}About the boats.com API
The Boats.com API provides 2 endpoints to search and retrieve boat and yacht listings from boats.com. Use search_boats to filter listings by manufacturer, boat type, condition, and year range, or call get_boat_details to pull full specifications, pricing, seller contact information, and the complete listing description for any individual vessel. Each listing in a search result includes the boat's ID, title, year, price, location, and image URL.
Search Boat Listings
The search_boats endpoint accepts up to six optional filter parameters: make (as a lowercase slug, e.g. boston-whaler), boat_type (power, sail, or unpowered), condition (new or used), year_from, year_to, and a page number for pagination. Each response returns a listings array of boat summaries — each containing id, title, year, price, location, url, and image_url — along with the page integer and a total_results count reflecting the number of listings on that page. Combining year_from and year_to lets you target specific model-year ranges within any filtered set.
Boat Detail Records
The get_boat_details endpoint takes a single required url parameter — either the full listing URL or its path — and returns a detailed record for that vessel. Fields include name, price, location, description (the full listing text), a specs object of key-value technical specification pairs (covering dimensions, engine, hull type, and similar attributes depending on the listing), seller_name, and seller_location. The seller fields expose the dealer or private party name and their address, which is useful for building contact workflows or lead generation pipelines.
Coverage and Scope
Listings span new and used vessels across power, sail, and unpowered categories. The make filter uses slug format, so manufacturer names must be lowercased and hyphenated (e.g. sea-ray not Sea Ray). Because total_results reflects the count on the current page rather than the global total, iterating all results requires incrementing the page parameter until the returned listings array is empty.
- Aggregate new and used powerboat inventory across multiple makes into a single searchable database using
search_boatswithconditionandmakefilters. - Build a sailboat price-tracking tool by periodically calling
search_boatswithboat_type=sailand storing the returnedpriceandyearfields over time. - Populate a dealer lead-generation tool with
seller_nameandseller_locationfromget_boat_detailsfor listings matching specific criteria. - Create a vintage vessel finder by combining
year_fromandyear_toparameters insearch_boatsto surface boats from a target decade. - Sync boat listing images and titles into a content CMS using the
image_urlandtitlefields returned bysearch_boats. - Compare technical specifications across competing models by calling
get_boat_detailson multiple listing URLs and diffing thespecsobjects.
| 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 boats.com have an official developer API?+
What does `total_results` represent in the `search_boats` response?+
page parameter until the listings array comes back empty.Does `get_boat_details` return a standardized set of specification fields in the `specs` object?+
specs object is a flexible key-value map whose keys depend on the individual listing — a powerboat and a sailboat will expose different attribute names. There is no guaranteed fixed schema across all listings, so consumers should handle missing keys defensively.Does the API return user reviews or ratings for boat listings?+
search_boats and get_boat_details, but does not expose user reviews or ratings. You can fork this API on Parse and revise it to add an endpoint targeting review data if it becomes available on a listing page.Can I filter search results by price range or geographic location?+
search_boats endpoint does not expose price-range or location-based filter parameters. Available filters are make, boat_type, condition, year_from, year_to, and page. You can fork this API on Parse and revise it to add price or location filter parameters to the search endpoint.