JSON Documentation
Dear Broker / Dealership
To register one or more boats automaticaly in our system, please create a JSON file containing a list of boat objects. Each boat object must follow the structure and data types described below:
Example JSON for Submission:
Important
To import your boats into our system, please follow these steps:
-
Create a Broker / Dealership profile on our website.
-
Save your JSON file in a publicly accessible location online.
This can be on your own server or on a platform that provides a full URL to the file (for example: http://example.com/your-boats.json).
-
Email the URL to info@boatsonthemarket.com.
Make sure to include the email address you used to register on our website and your company name.
Important Note: Our system checks this file daily (4am GMT) to keep your listings in sync.
Every time you add or remove a boat listing, you must generate a new JSON file and update it at the same URL.
Data Structure:
Important Note: Some fields are marked as required, while others are optional.
However, we strongly recommend filling in as much information as possible, as this helps your listings appear higher in user searches and improves their SEO visibility.
For any optional fields where a value is not available, please use an empty string ("") for text fields and 0 for numeric fields.
Listing id (required)
| Field | Type | Required | Description |
|---|---|---|---|
id |
Integer | Yes | Unique identifier for the boat listing. |
Images (required)
| Field | Type | Required | Description |
|---|---|---|---|
picture_url |
String | Yes | URL of the main boat image. |
Please note: The image URLs must be separated by commas (,).
For example:
https://example.com/image1.jpg, https://example.com/image2.jpg, https://example.com/image3.jpg
This format ensures that each URL is correctly recognized and processed.
Base Category (required)
| Field | Type | Required | Description |
|---|---|---|---|
category |
String | Yes | Category of the boat (e.g., "Super Yachts"). |
Please note: The Base Category must include one of the following options:
-
Super Yachts
-
Motor Yachts
-
Sailing Yachts
-
PWC
-
Commercial
Make sure to enter the category exactly as shown above (including proper capitalization) to ensure it is recognized correctly.
Sub Category (required)
| Field | Type | Required | Description |
|---|---|---|---|
subcategory_level_1 |
String | Yes | Subcategory level 1 (e.g., "Explorer"). |
You can find the full list of subcategories at the bottom of this page/document.
Make (required)
| Field | Type | Required | Description |
|---|---|---|---|
make |
String | Yes | Boat manufacturer.(e.g., "Beneteau"). |
Model (required)
| Field | Type | Required | Description |
|---|---|---|---|
model |
String | Yes | Boat model.(e.g., "Oceanis 373"). |
Length (required)
| Field | Type | Required | Description |
|---|---|---|---|
length |
Number | Yes | Length of the boat. |
length_unit |
String | Yes | Unit of length (e.g., "foot", "meter"). |
Year Manufactured (required)
| Field | Type | Required | Description |
|---|---|---|---|
year_manufactured |
Integer | Yes | Year of manufacture. (e.g., "2025"). |
Price (required)
| Field | Type | Required | Description |
|---|---|---|---|
price |
Number | Yes | Boat price.(e.g., "189000"). |
price_unit |
String | Yes | Currency unit for the price (e.g., "USD", "EUR" , "GBP"). |
Condition (required)
| Field | Type | Required | Description |
|---|---|---|---|
condition |
String | Yes | Condition of the boat (e.g., "New", "Used"). |
| Field | Type | Required | Description |
|---|---|---|---|
tax_/_vat_status |
String | No | Tax/VAT status (e.g., "Not Paid", "Paid"). |
Year of Last Refit
| Field | Type | Required | Description |
|---|---|---|---|
year_of_last_refit |
Integer | No | Year of the last refit.(e.g., "2018"). |
Flag
| Field | Type | Required | Description |
|---|---|---|---|
flag_registered |
String | No | Country of registration flag.(e.g., "Panama"). |
| Field | Type | Required | Description |
|---|---|---|---|
boat_location_country |
String | No | Current country of boat location.(e.g., "Italy"). |
| Field | Type | Required | Description |
|---|---|---|---|
boat_location_address |
String | No | Location address of the boat. |
Please include an approximate country, city, and street address whenever possible.
This information helps improve search results by distance and allows your listing to appear with a pinpoint on map-based searches.
Title (required)
| Field | Type | Required | Description |
|---|---|---|---|
title |
String | Yes | Title or name of the boat listing. |
| Field | Type | Required | Description |
|---|---|---|---|
main_description |
String | Yes | Main description of the boat. |
| Field | Type | Required | Description |
|---|---|---|---|
accommodations |
String | No | Accommodations description. |
| Field | Type | Required | Description |
|---|---|---|---|
galley_equipment |
String | No | Galley Equipment description. |
| Field | Type | Required | Description |
|---|---|---|---|
deck_and_hull_equipment |
String | No | Deck and Hull Equipment description. |
| Field | Type | Required | Description |
|---|---|---|---|
mechanical_equipment |
String | No | Mechanical Equipment description. |
| Field | Type | Required | Description |
|---|---|---|---|
navigation_system |
String | No | Navigation System description. |
| Field | Type | Required | Description |
|---|---|---|---|
safety_equipment |
String | No | Safety Equipment description. |
| Field | Type | Required | Description |
|---|---|---|---|
additional_equipment |
String | No | Additional Equipment description. |
Beam
| Field | Type | Required | Description |
|---|---|---|---|
beam |
Number | No | Beam (width) of the boat. |
beam_unit |
String | No | Unit of beam (e.g., "foot", "meter"). |
Draft
| Field | Type | Required | Description |
|---|---|---|---|
draft |
Number | No | Draft of the boat. |
draft_unit |
String | No | Unit of draft (e.g., "foot", "meter"). |
Air Draft
| Field | Type | Required | Description |
|---|---|---|---|
air_draft |
Number | No | Air draft of the boat. |
air_draft_unit |
String | No | Unit of air draft (e.g., "foot", "meter"). |
| Field | Type | Required | Description |
|---|---|---|---|
bridge_clearance |
Number | No | Bridge clearance. (e.g., "45"). |
bridge_clearance_unit |
String | No | Unit of bridge clearance (e.g., "foot", "meter"). |
LOA
| Field | Type | Required | Description |
|---|---|---|---|
loa_(length_overall) |
Number | No | Length Overall (LOA). (e.g., "45"). |
loa_(length_overall)_unit |
String | No | Unit of length overall (e.g., "foot", "meter"). |
LOL
| Field | Type | Required | Description |
|---|---|---|---|
lol_(length_on_deck) |
Number | No | Length on Deck (LOL). (e.g., "45"). |
lol_(length_on_deck)_unit |
String | No | Unit of length on deck (e.g., "foot", "meter"). |
LWL
| Field | Type | Required | Description |
|---|---|---|---|
lwl_(length_waterline) |
Number | No | Length Waterline (LWL). (e.g., "40"). |
lwl_(length_waterline)_unit |
String | No | Unit of length waterline (e.g., "foot", "meter"). |
Freeboard
| Field | Type | Required | Description |
|---|---|---|---|
freeboard |
Number | No | Freeboard. (e.g., "10"). |
freeboard_unit |
String | No | Unit of freeboard (e.g., "foot", "meter"). |
Displacement
| Field | Type | Required | Description |
|---|---|---|---|
displacement |
Number | No | Displacement of the boat. (e.g., "5000"). |
displacement_unit |
String | No | Unit of displacement (e.g., "kg", "lbs", "Tons"). |
| Field | Type | Required | Description |
|---|---|---|---|
dry_weight |
Number | No | Dry weight of the boat. |
dry_weight_unit |
String | No | Unit of dry weight (e.g., "kg", "lbs", "Tons"). |
Ballast
| Field | Type | Required | Description |
|---|---|---|---|
ballast |
Number | No | Ballast of the boat. |
ballast_unit |
String | No | Unit of ballast (e.g., "kg", "lbs", "Tons"). |
Fuel Tank
| Field | Type | Required | Description |
|---|---|---|---|
fuel_capacity |
Number | No | Fuel tank capacity. |
fuel_capacity_unit |
String | No | Unit of fuel tank capacity (e.g., "gallon", "liter"). |
| Field | Type | Required | Description |
|---|---|---|---|
holding_tank_capacity |
Number | No | Holding tank capacity. |
holding_tank_capacity_unit |
String | No | Unit of holding tank capacity (e.g., "gallon", "liter"). |
| Field | Type | Required | Description |
|---|---|---|---|
water_capacity |
Number | No | Water tank capacity. |
water_capacity_unit |
String | No | Unit of water tank capacity (e.g., "gallon", "liter"). |
Speed
| Field | Type | Required | Description |
|---|---|---|---|
cruising_speed |
Number | No | Cruising speed. |
max_speed |
Number | No | Maximum speed. |
Construction
| Field | Type | Required | Description |
|---|---|---|---|
hull_material |
String | No | Hull material (e.g., "Carbon Fiber", "Fiberglass"). |
Hull Type
| Field | Type | Required | Description |
|---|---|---|---|
hull_type |
String | No | Hull type (e.g., "V Shape", "Catamaran"). |
Keel
| Field | Type | Required | Description |
|---|---|---|---|
keel_type |
String | No | Keel type (e.g., "Bilge Keel", "Fin Keel"). |
Rig
| Field | Type | Required | Description |
|---|---|---|---|
rig_type |
String | No | Rig type (e.g., "Ketch", "Sloop"). |
Crew Accommodations
| Field | Type | Required | Description |
|---|---|---|---|
crew_berths |
Integer | No | Number of crew berths. |
crew_cabins |
Integer | No | Number of crew cabins. |
crew_heads |
Integer | No | Number of crew heads. |
Guest Accommodations
| Field | Type | Required | Description |
|---|---|---|---|
guest_berths |
Integer | No | Number of guest berths. |
guest_cabins |
Integer | No | Number of guest cabins. |
guest_heads |
Integer | No | Number of guest heads. |
Designer
| Field | Type | Required | Description |
|---|---|---|---|
designer |
String | No | Boat designer. |
HIM Number
| Field | Type | Required | Description |
|---|---|---|---|
12_digit_him |
Integer | No | 12-digit HIM identifier. |
Boats Sub Category level 1
| Super Yachts | Motor Yachts | Sailing Yachts | PWC | Commercial |
|---|---|---|---|---|
| Antique and Classic | Aft Cabin | Aft Cabin | Air Chair | AHTS Vessel |
| Explorer | Airboat | Antique and Classic | Airboat | Barge |
| Giga Yacht | Aluminium Fish | Beach Catamaran | Aquabike | Cable Layer Vessel |
| High Performance | Antique and Classic | Bowrider | Bass | Container Ship |
| Mega Yacht | Barge | Catamaran | Canoe | Crane Jack Up |
| Motor Yacht | Bass | Centre Cockpit | Canoe Polo Boat | Crane Vessel |
| Motorsailer | Bay | Cruiser | Catamaran | Crew Transfer Vessel |
| Multi-Hull | Beach Catamaran | Cutter | Dinghy | Cruise Ship |
| Super Yacht | Bowrider | Daysailer | Dinghy (Power) | Dredger |
| Canal and River Cruiser | Deck Saloon | Dinghy (Sail) | Drill Rig | |
| Catamaran | Dinghy | Dinghy (Unpowered) | Ferry | |
| Centre Cockpit | Gulet | Dragon Boat | Fishing Vessel | |
| Centre Console | Ketch | Flats | General Cargo Ship | |
| Commercial Boat | Motorsailer | Hoverboard (Water) | Guard Vessel / Pilot Boat | |
| Convertible | Multi-Hull | Hydrobike | Hospital Ship | |
| Cruiser | Other | Hydrocycle | Hovercraft | |
| Cuddy Cabin | Performance Sailing Boat | Hydrofoil Board | Icebreaker | |
| Deck Saloon | Pilothouse (Sail) | Inflatable | Landing Craft | |
| Dinghy | Racer | Inflatable Boat | Livestock Carrier | |
| Dive | Racer/Cruiser | Inflatable Kayak | Other | |
| Downeast | Schooner | Inflatable Stand-Up Paddleboard | Passenger Ship | |
| Dual Console | Sloop | Jet Ski | Research Vessel | |
| Express Cruiser | Trimaran | Jon Boat | Rigid Dive and Rescue Inflatable | |
| Flats | Unspecified | Kayak | Ro-Ro Ship (Roll-on/Roll-off) | |
| Flybridge | Yawl | Kitesurfing Board | Supply Vessel | |
| Freshwater Fishing | Other (Power) | Survey Vessel | ||
| High Performance | Outboard Skiff | TUG / Anchor Handling Vessel | ||
| House | Outrigger Canoe | Tanker / Bunkering | ||
| Inflatable | Paddleboard | |||
| Jet | Personal Sailboat | |||
| Jon | Personal Watercraft | |||
| Llaut | Pontoon | |||
| Motor Yacht | Rowboat | |||
| Motorsailer | Rowing Shell | |||
| Multi-Hull | Sailing Canoe | |||
| Narrowboat | Sailing Kayak | |||
| Other (Power) | Sit-down PWC | |||
| Pilothouse | Stand-up PWC | |||
| Pontoon | Surf Ski | |||
| Power Catamaran | Tender (Power) | |||
| Rigid Inflatable Boats (RIB) | Trimaran | |||
| Runabout | Unspecified | |||
| Saltwater Fishing | Utility Boat | |||
| Schooner | Water Scooter | |||
| Ski and Wakeboard | Waterbike | |||
| Skiff | WaveRunner | |||
| Sports Cruiser | Windsurfer | |||
| Sports Fishing | ||||
| Tender (Power) | ||||
| Trawler | ||||
| Trimaran | ||||
| Tug | ||||
| Unspecified | ||||
| Utility Boat | ||||
| Walkaround | ||||
| Widebeam |
| Keel Type | Rig Type | Hull Type | Hull Material |
|---|---|---|---|
| Bilge Keel | Barque (Bark) | V Shape | Aluminium |
| Bulb Keel | Barquentine | V Deep | Carbon Fiber |
| Canting Keel | Bermuda Rig | V Shallow | Composite |
| Centerboard Keel | Brig | Plaining | Fiberglass |
| Daggerboard Keel | Brigantine | Semi Plaining | Hypalon |
| Deep Keel | Cat Rig | Displacement | PVC |
| Encapsulated Keel | Chinese Lug Rig | Semi Displacement | Steel |
| Fin Keel | Crab Claw Rig | Multi Hull | Wood |
| Fixed Keel | Cutter | Round Bottom | Other |
| Full Keel | Cutter Rigged Sloop | Flat Bottom | |
| Hydrofoil Keel | Dhow Rig | Bulbous Bow | |
| Keel & Centerboard | Fractional Rig Sloop | Inverted Bow | |
| Lifting Bulb Keel | Full-Rigged Ship | ||
| Lifting Keel | Gaff-Rigged Schooner | ||
| Long Keel | Gaff-Rigged Sloop | ||
| Modified Full Keel | Gunter Rig | ||
| Retractable Keel | Junk Rig | ||
| Retracting Bulb Keel | Ketch | ||
| Scheel Keel | Lateen Rig | ||
| Shoal Keel | Lug Rig | ||
| Spade Keel | Masthead Rig | ||
| Stub Keel | Polynesian Crab Claw Rig | ||
| Swing Bulb Keel | Proa Rig | ||
| Swing Keel | Schooner | ||
| Swing Wing Keel | Sharpie Rig | ||
| Triple Keel | Sloop | ||
| Twin Keel | Spritsail Rig | ||
| Wing Keel | Square Rig | ||
| Ballast Keel | Topsail Rig | ||
| Drop Keel | Wishbone Rig | ||
| Hydraulic Lifting Keel | Yawl | ||
| Vertical Lifting Keel | |||
| Rotating Keel | |||
| Tandem Keel | |||
| Twin Daggerboards | |||
| Winged Bulb Keel | |||
| Centerline Keel | |||
| Pivoting Keel | |||
| Adjustable Keel | |||
| Foiling Keel |