The Marine Data API

Accurate boat specifications and marine data for developers. Power your marketplace, website builder, or app with Marinebase.

Built for the Marine Industry

Marinebase provides a unified REST API to access comprehensive sailboat specifications. No more scraping outdated websites or manual data entry. We maintain the database so you can focus on building great products.

  • 10,000+ Sailboat models and counting
  • Standardized technical specifications
  • High-performance REST endpoints
  • Regularly updated manufacturer data

Centralized

One source for all marine technical data.

Developer First

Clean JSON responses and clear documentation.

Scalable

Built to handle thousands of requests per second.

Accurate

Verified specs from manufacturers and experts.

Who is Marinebase for?

Our API is designed to power the next generation of marine software.

Marketplaces

Auto-populate boat listings with technical specs to improve listing quality and SEO.

Website Builders

Offer boat comparison tools and technical spec widgets to your marine clients.

App Builders

Build navigation, maintenance, or racing apps with accurate boat dimensions and data.

Example Use Cases

See how you can leverage Marinebase data to build intelligent marine tools.

Mooring Fees

Calculate dockage costs instantly using accurate LOA and Beam data from our API.

Maintenance

Predict annual maintenance budgets based on displacement and boat age.

Insurance

Automate risk assessment by pulling technical specs directly into your quote engine.

Market Value

Estimate resale value by comparing specs with historical market data.

Developer Spotlight

Building a Price Calculator?

Fetch length_overall and beam for any boat model to calculate marina fees, winter storage, or transport costs with 100% accuracy.

Used by 10+ marine businesses
calculator.js Live Preview

const res = await fetch('https://api.marinebase.dev/v1/sailboats/sun-fast-3300-jeanneau', {

headers: { 'Authorization': 'Bearer mb_...' }

});

const boat = await res.json();

const loa = boat.specs.find(s => s.key === 'length_overall')?.value.numeric;

const monthlyFee = loa * 45.00; // €45.00/meter

// Result: €454.95 / month (10.11 m × €45.00)

REST API v0.1.0

API Reference

Direct access to verified sailboat specifications, dimensions, and technical metadata. Fully documented with OpenAPI 3.1.

Base URL: https://api.marinebase.dev
Interactive Swagger Docs OpenAPI JSON
Authentication

Private endpoints require a Bearer token passed in the Authorization header:

Authorization: Bearer mb_<your_token>
  • server: For backend and server-side callers. Must NOT be used from a browser.
  • browser: For frontend callers. Restricted to declared allowed origins (similar to Google Maps API keys).
Quotas & Rate Limits

Requests are metered per tenant per calendar month (UTC). Exceeding your quota triggers HTTP 429 Too Many Requests.

Public Endpoint
/v1/specs/fields
No API token required
Private Endpoints
/v1/sailboats/*
Bearer token required
GET /v1/specs/fields Public

List Specification Fields

Public endpoint. Returns the customer-facing field catalog used by the API, including 10 categorized sections, canonical keys, labels, descriptions, and preferred units.

Query Parameters

units string (optional)
metric | imperial (default: metric)
Sections Covered (10):
Dimensions Weight Production Classification Ratios Propulsion Rigging Accommodations Performance Other
Response (200 OK)
{
  "version": "1.0",
  "units": "metric",
  "total": 55,
  "sections": [
    { "name": "Dimensions", "description": "Physical boat measurements" },
    { "name": "Weight", "description": "Boat mass and ballast" },
    { "name": "Production", "description": "Boat manufacturing and design attribution" },
    { "name": "Classification", "description": "Boat category and class descriptors" },
    { "name": "Ratios", "description": "Derived performance metrics" }
  ],
  "fields": [
    {
      "key": "length_overall",
      "name": "Length Overall",
      "section": "Dimensions",
      "description": "Total length from bow to stern",
      "unit_preferences": ["meters", "feet"]
    },
    {
      "key": "beam",
      "name": "Beam",
      "section": "Dimensions",
      "description": "Maximum width of the boat",
      "unit_preferences": ["meters", "feet"]
    },
    {
      "key": "displacement",
      "name": "Displacement",
      "section": "Weight",
      "description": "Total weight of water displaced by the boat",
      "unit_preferences": ["kilograms", "pounds"]
    }
  ]
}
GET /v1/sailboats/search Bearer Auth

Search Sailboats

Private endpoint. Search by title, slug, builder, or first-built year. Returns summary rows with structured measure objects, modification timestamps, and query metadata.

Query Parameters

q string (optional)
Search query text (e.g. "sun-fast")
limit integer (1–100)
default: 20
offset integer (min 0)
default: 0
units string
metric | imperial (default: metric)
include_available_fields boolean
default: false
additional_fields array<string>
Additional canonical keys to inline
updated_since integer
Filter by Unix epoch seconds
Response (200 OK)
{
  "data": [
    {
      "id": 7914,
      "slug": "sun-fast-3300-jeanneau",
      "title": "SUN FAST 3300 (JEANNEAU)",
      "builder": "Jeanneau",
      "loa": {
        "text": "10.11 m",
        "numeric": 10.11,
        "unit": "m",
        "type": "length",
        "confidence": "high"
      },
      "beam": {
        "text": "3.4 m",
        "numeric": 3.4,
        "unit": "m",
        "type": "length",
        "confidence": "high"
      },
      "updated_at": "2026-04-13T22:22:54Z",
      "updated_at_epoch": 1776118974
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "query": "sun-fast",
    "units": "metric"
  }
}
GET /v1/sailboats/{slug} Bearer Auth

Get Sailboat Detail

Private endpoint. Returns comprehensive sailboat technical specifications with canonical spec keys, structured measure values, confidence scores, source links, and update timestamps.

Parameters

slug path (required)
e.g. sun-fast-3300-jeanneau
units query (optional)
metric | imperial (default: metric)
Standardized Specs Array:

Each specification in specs provides key, name, section, description, and a typed value with raw numeric values, formatted display text, and data confidence rating.

Response (200 OK)
{
  "id": 7914,
  "slug": "sun-fast-3300-jeanneau",
  "title": "SUN FAST 3300 (JEANNEAU)",
  "units": "metric",
  "specs": [
    {
      "key": "length_overall",
      "name": "Length Overall",
      "section": "Dimensions",
      "description": "Total length from bow to stern",
      "value": {
        "text": "10.11 m",
        "numeric": 10.11,
        "unit": "m",
        "type": "length",
        "confidence": "high"
      }
    },
    {
      "key": "beam",
      "name": "Beam",
      "section": "Dimensions",
      "description": "Maximum width of the boat",
      "value": {
        "text": "3.4 m",
        "numeric": 3.4,
        "unit": "m",
        "type": "length",
        "confidence": "high"
      }
    },
    {
      "key": "displacement",
      "name": "Displacement",
      "section": "Weight",
      "description": "Total weight of water displaced",
      "value": {
        "text": "3492.66 kg",
        "numeric": 3492.66,
        "unit": "kg",
        "type": "weight",
        "confidence": "high"
      }
    },
    {
      "key": "ballast",
      "name": "Ballast",
      "section": "Weight",
      "description": "Weight of ballast (keel or bulb)",
      "value": {
        "text": "1399.79 kg",
        "numeric": 1399.79,
        "unit": "kg",
        "type": "weight",
        "confidence": "high"
      }
    }
  ],
  "links": [],
  "updated_at": "2026-04-13T22:22:54Z",
  "updated_at_epoch": 1776118974
}

Ready to build with Marinebase?

We are currently in private beta. Request access today to get your API key and start building.

Request Access Now