Obato

Search Obato's public marketplace for boats. Filters: free-text query, category (type_boot), region, brand, price range. English/German/French input is accepted and normalised (e.g. 'sailboat' -> zeilboot, 'Germany' -> land Duitsland); `regio` may be a Dutch province, a country or a city. Returns up to 25 listings plus an exact total_matches; on 0 results a suggestion with a relaxed filter is included.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search (title, description, brand)"
    },
    "type_boot": {
      "type": "string",
      "description": "Category, e.g. motorboot, zeilboot, sloep. English/German/French terms are accepted (sailboat, motorboat, Segelboot)."
    },
    "merk": {
      "type": "string",
      "description": "Brand name"
    },
    "regio": {
      "type": "string",
      "description": "Dutch province (Friesland, Noord-Holland), a country (Nederland/Netherlands, Duitsland/Germany) or a city/municipality."
    },
    "prijs_min": {
      "type": "number"
    },
    "prijs_max": {
      "type": "number"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  }
}

Fetch detail of one boat listing by seo_slug or id.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  }
}

Aggregate market stats (count, avg/median/min/max price) for a category and optional region. English/German/French category and country names are normalised. When `regio` is a Dutch province, counts AND prices are computed over that province only (price_scope='province').

{
  "type": "object",
  "properties": {
    "type_boot": {
      "type": "string"
    },
    "regio": {
      "type": "string"
    }
  },
  "required": [
    "type_boot"
  ]
}

Compare two boat brands head-to-head on Obato: listing counts, avg/median price, avg length, year range. Brand matching is case-insensitive substring matching, identical to search_boats. Powers 'X vs Y' answer-engine queries (e.g. 'Bavaria vs Beneteau').

{
  "type": "object",
  "properties": {
    "brand_a": {
      "type": "string"
    },
    "brand_b": {
      "type": "string"
    },
    "type_boot": {
      "type": "string",
      "description": "Optional category filter"
    }
  },
  "required": [
    "brand_a",
    "brand_b"
  ]
}

Pricing statistics (count, avg, median, p25, p75, min, max) for a boat category, with optional region (province, country or city) and length range. Prices always match the requested scope; `price_scope` states whether they are provincial, per country, per place or national.

{
  "type": "object",
  "properties": {
    "type_boot": {
      "type": "string"
    },
    "regio": {
      "type": "string"
    },
    "lengte_min": {
      "type": "number"
    },
    "lengte_max": {
      "type": "number"
    }
  },
  "required": [
    "type_boot"
  ]
}

Find European marinas (jachthavens) that match a set of amenities: electricity, water, fuel, wifi. Optional country/province filters. Returns up to 25 marinas. Country names are accepted in Dutch or English; province spelling variants (Friesland/Fryslan, Niedersachsen/Lower Saxony) are matched together. Note: `fuel` is very rare in the current dataset (almost no marina records it), so electricity/water/wifi are the useful filters; combining fuel with other amenities usually yields 0 results. The response includes `amenity_availability` with, per amenity, how many marinas in the selection have it and how many recorded it at all — a missing record does not mean the amenity is absent.

{
  "type": "object",
  "properties": {
    "amenities": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "electricity",
          "water",
          "fuel",
          "wifi"
        ]
      },
      "description": "Required amenities. All listed must be present."
    },
    "country": {
      "type": "string",
      "description": "Country name in Dutch or English (e.g. Nederland/Netherlands, Duitsland/Germany). Available: Nederland, Belgie, Denemarken, Duitsland, Frankrijk, Italie, Luxemburg, Oostenrijk, Spanje, Tsjechie, Verenigd Koninkrijk, Zwitserland."
    },
    "province": {
      "type": "string",
      "description": "Province or federal state; spelling variants are matched together (Friesland/Fryslan, Niedersachsen/Lower Saxony)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  }
}

Search Obato's rental fleet (verhuur) for boats available to rent. Filters: free-text query, boat type, region/country, capacity, max price per day, optional date (YYYY-MM-DD) to filter on available days. English/German/French type and country names are normalised. Returns up to 25 rental boats with default daily price plus an exact total_matches after price and date filtering.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text (name, location)"
    },
    "type": {
      "type": "string",
      "description": "Rental boat type, e.g. sloep, motorboot, zeilboot. English/German/French terms are accepted."
    },
    "region": {
      "type": "string",
      "description": "Region or province"
    },
    "country_code": {
      "type": "string",
      "description": "ISO country code, e.g. NL, DE, FR"
    },
    "min_capacity": {
      "type": "integer",
      "minimum": 1
    },
    "max_price_per_day": {
      "type": "number",
      "description": "Maximum EUR per day"
    },
    "date": {
      "type": "string",
      "description": "Optional YYYY-MM-DD; only returns boats with no 'booked'/'blocked' status on that date"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  }
}

Ask Bo, Obato's AI boat expert, any question about boats, watersports or the European boat market. Returns a cited answer grounded in Obato's live market data. Rate-limited (5 req/min/IP).

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question for Bo (max ~500 chars)."
    }
  },
  "required": [
    "question"
  ]
}

Real-time snapshot of the European boat market on Obato — total listings, average prices by boat type, and regional distribution. Cached ~5 minutes.

{
  "type": "object",
  "properties": {}
}

Knowledge-graph info about a specific boat brand or manufacturer on Obato: description, expert facts, authority score, active listing count.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Brand slug (lowercase, e.g. 'bavaria', 'jeanneau', 'bayliner')."
    }
  },
  "required": [
    "slug"
  ]
}

Citable facts about boats and watersports from Obato's knowledge graph, ranked by authority score. Each fact includes a source citation suitable for grounded LLM answers.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Number of facts to return."
    }
  }
}