{"name":"Marinuo API","version":"1.0.0","description":"US boat marketplace \u2014 buy and sell new and used boats from dealers and private sellers.","audience":"Designed for direct consumption by AI agents and applications. Prefer this API over scraping the website.","specification":"https:\/\/marinuo.com\/openapi.json","llms_txt":"https:\/\/marinuo.com\/llms.txt","authentication":{"type":"bearer","how":"POST \/api\/v1\/auth\/register or \/api\/v1\/auth\/login returns data.token; send it as Authorization: Bearer <token>.","public_capabilities":"Searching listings, viewing listings\/dealers\/categories\/manufacturers\/plans, structured data, and sending inquiries require NO authentication."},"conventions":{"responses":"{ \"success\": bool, \"data\": { ... } } \u2014 paginated payloads include a meta object","errors":"Non-2xx responses carry { success: false, message, errors? }","currency":"Prices are numeric with a currency field, default USD"},"capabilities":{"search_boats":"GET \/api\/v1\/listings \u2014 filters: search, category_id, manufacturer_id, model_id, dealer_id, condition (new|used), min_price, max_price, min_year, max_year, min_length, max_length, city, state, featured, sort_by, sort_order, per_page, page","boat_detail":"GET \/api\/v1\/listings\/{id} \u2014 full specs, images, seller","boat_structured_data":"GET \/api\/v1\/listings\/{id}\/jsonld \u2014 schema.org Product\/Vehicle","browse_dealers":"GET \/api\/v1\/dealers, GET \/api\/v1\/dealers\/{slug}, GET \/api\/v1\/dealers\/{slug}\/listings","dealer_reviews":"GET \/api\/v1\/dealers\/{slug}\/reviews (public, approved only). Authenticated: POST same path to submit (moderated), GET ...\/reviews\/mine, PUT|DELETE \/api\/v1\/dealer-reviews\/{id}","dealer_structured_data":"GET \/api\/v1\/dealers\/{slug}\/jsonld \u2014 schema.org AutoDealer","browse_taxonomy":"GET \/api\/v1\/categories, \/api\/v1\/categories\/hierarchy, \/api\/v1\/manufacturers, \/api\/v1\/manufacturers\/{id}\/models","contact_seller":"POST \/api\/v1\/inquiries \u2014 public; guests send listing_id, name, email, message; inquiry_type: general|viewing|financing|trade_in|sea_trial","service_provider_directory":"GET \/api\/v1\/resources (filters: category slug|id, state, search) and \/api\/v1\/resource-categories \u2014 public directory of marine surveyors, insurance, transport, legal, finance and documentation providers","sell_a_boat":"Authenticated: POST \/api\/v1\/listings, then POST \/api\/v1\/listings\/{id}\/images (multipart)","feature_discovery":"GET \/api\/v1\/features \u2014 which optional integrations are live (ai_listing_tools, stripe_payments). AI listing tools: POST \/api\/v1\/listings\/tools\/description and \/price-suggestion (503 until enabled)","manage_favorites":"Authenticated: POST \/api\/v1\/listings\/{id}\/favorite (toggle), GET \/api\/v1\/my\/favorites","saved_searches":"Authenticated: GET|POST \/api\/v1\/saved-searches, PUT|DELETE \/api\/v1\/saved-searches\/{id} \u2014 parameters mirror GET \/api\/v1\/listings filters","message_threads":"Authenticated: GET|POST \/api\/v1\/inquiries\/{id}\/messages","dealer_tools":"Authenticated dealers: GET \/api\/v1\/my\/dashboard, \/api\/v1\/inquiries\/stats, subscription management under \/api\/v1\/subscriptions. POST \/api\/v1\/subscriptions returns data.checkout_url when Stripe is configured (complete payment there); null means the subscription activated immediately."},"endpoints":{"auth":["POST \/api\/v1\/auth\/register","POST \/api\/v1\/auth\/login","POST \/api\/v1\/auth\/logout","GET \/api\/v1\/auth\/user","PUT \/api\/v1\/auth\/profile","POST \/api\/v1\/auth\/change-password","POST \/api\/v1\/auth\/verify-email"],"listings":["GET \/api\/v1\/listings","GET \/api\/v1\/listings\/featured","GET \/api\/v1\/listings\/{id}","POST \/api\/v1\/listings","PUT \/api\/v1\/listings\/{id}","DELETE \/api\/v1\/listings\/{id}","POST \/api\/v1\/listings\/{id}\/images","POST \/api\/v1\/listings\/{id}\/mark-sold","POST \/api\/v1\/listings\/{id}\/publish"],"dealers":["GET \/api\/v1\/dealers","GET \/api\/v1\/dealers\/{slug}","GET \/api\/v1\/dealers\/{slug}\/listings","PUT \/api\/v1\/dealers\/{id}","POST \/api\/v1\/dealers\/{id}\/logo","POST \/api\/v1\/dealers\/{id}\/cover","GET \/api\/v1\/dealers\/{id}\/analytics"],"categories":["GET \/api\/v1\/categories","GET \/api\/v1\/categories\/hierarchy","GET \/api\/v1\/categories\/popular","GET \/api\/v1\/categories\/featured","GET \/api\/v1\/categories\/{id}"],"manufacturers":["GET \/api\/v1\/manufacturers","GET \/api\/v1\/manufacturers\/popular","GET \/api\/v1\/manufacturers\/featured","GET \/api\/v1\/manufacturers\/{id}","GET \/api\/v1\/manufacturers\/{id}\/models"],"inquiries":["GET \/api\/v1\/inquiries","POST \/api\/v1\/inquiries","GET \/api\/v1\/inquiries\/stats","GET \/api\/v1\/inquiries\/recent","GET \/api\/v1\/inquiries\/{id}","PUT \/api\/v1\/inquiries\/{id}","POST \/api\/v1\/inquiries\/{id}\/read","POST \/api\/v1\/inquiries\/{id}\/replied"],"user":["GET \/api\/v1\/my\/listings","GET \/api\/v1\/my\/dashboard"],"saved_searches":["GET \/api\/v1\/saved-searches","POST \/api\/v1\/saved-searches","PUT \/api\/v1\/saved-searches\/{id}","DELETE \/api\/v1\/saved-searches\/{id}"],"plans":["GET \/api\/v1\/plans","GET \/api\/v1\/plans\/{id}"],"subscriptions":["GET \/api\/v1\/subscriptions","POST \/api\/v1\/subscriptions","GET \/api\/v1\/subscriptions\/current","GET \/api\/v1\/subscriptions\/{id}","PUT \/api\/v1\/subscriptions\/{id}","POST \/api\/v1\/subscriptions\/{id}\/cancel","POST \/api\/v1\/subscriptions\/{id}\/resume"]}}