YachtLuma
Développeurs

Documentation API

Interrogez modèles, chantiers, lieux et annonces publiés via REST ou MCP. Examinez la réponse dans votre langue avant l’intégration.

Ressources

Modèles de yachts
GET /api/v1/models
Chantiers navals
GET /api/v1/builders
Ports de plaisance
GET /api/v1/marinas
Équipements à bord
GET /api/v1/equipment
Départs en yacht
GET /api/v1/departures
Prestataires de services
GET /api/v1/providers
Médias sous licence
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=fr'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=fr'

Pagination et filtres

Utilisez limit de 1 à 100 et offset à partir de 0. Réutilisez nextOffset jusqu’à null. Filtrez les modèles par builder ou type et les annonces par category.

curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=fr&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=fr&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/departures?mode=seat&guests=2&location=Palma&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/providers?service=maintenance&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/media?entityType=model&entityId=lagoon-46&locale=fr'

Disponibilité des champs

Les droits de chaque source distinguent Web, API et IA. Le tableau de spécifications peut être vide. Gardez statut, unité, date et configuration avec la valeur.

specifications_status · available / not_available_for_this_channel

Applications et quotas

Les requêtes anonymes partagent 10 000 appels par jour UTC. Chaque application approuvée dispose de son quota, de ses canaux et de ses ressources. Envoyez la clé dans l’en-tête Authorization.

Authorization: Bearer <APPLICATION_KEY>
Mes applications

MCP

Connectez le client MCP en Streamable HTTP. Appelez initialize puis tools/list pour les schémas actuels. Les outils lisent les fiches publiées.

POST https://yachtluma.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_models",
    "arguments": {
      "q": "Lagoon",
      "locale": "fr",
      "limit": 3
    }
  }
}
  • search_models
  • search_builders
  • search_listings
  • find_marinas
  • search_equipment
  • search_knowledge
  • get_model
  • get_listing
  • get_equipment
  • get_care_guide
  • compare_models
  • search_yacht_pages
  • get_market_counts
  • search_departures
  • get_departure
  • search_providers
  • get_provider
  • search_media
  • get_media
  • estimate_charter_budget