{"name":"BoatListing.com.au public API","version":"v1","description":"Read-only JSON API exposing active boat listings on BoatListing.com.au — Australia's boat marketplace. Built for AI agents and developers. GET requests only; no authentication required.","baseUrl":"https://boatlisting.com.au/api/v1","openapi":"https://boatlisting.com.au/api/v1/openapi.json","rateLimits":{"perMinutePerIp":60,"perDayPerIp":100,"note":"Abusive callers (rate-limit flooding, write attempts, injection probes) are automatically blocked."},"endpoints":[{"method":"GET","path":"/boats","description":"Search and list boats.","parameters":{"q":"Keyword search across title, description, make, model","make":"Filter by make (comma-separated for multiple, case-insensitive)","model":"Filter by model (comma-separated, substring match)","category":"Filter by category e.g. Power, Sail (comma-separated)","boat_type":"Filter by boat type (comma-separated). Aliases: boatType, type","usage":"Usage type any-of filter e.g. Fishing, Family (comma-separated). Alias: usage_type","condition":"New or Used","state":"Australian state code e.g. NSW, QLD (comma-separated)","country":"ISO country code, e.g. AU","city":"City/suburb substring match","price_min":"Minimum price (AUD). Forgiving formats accepted: 1000000, $1,000,000, 1m, 500k. Aliases: priceMin, min_price, price_from","price_max":"Maximum price (AUD). Same formats/aliases as price_min","length_min":"Minimum length in metres","length_max":"Maximum length in metres","year_min":"Minimum build year","year_max":"Maximum build year","sort":"price_desc (default) | price_asc | length_desc | length_asc | year_desc | year_asc","limit":"Page size, max 100","offset":"Pagination offset; use pagination.nextOffset from the response"},"example":"https://boatlisting.com.au/api/v1/boats?q=catamaran&state=QLD&price_max=200000&limit=10","moreExamples":["https://boatlisting.com.au/api/v1/boats?price_min=1000000 (boats over $1,000,000)","https://boatlisting.com.au/api/v1/boats?category=Sail&length_min=10&sort=length_desc"],"notes":"Number filters accept human formats ($, commas, k/m suffixes) and common parameter aliases (camelCase, min_/max_, _from/_to). Unknown sort values fall back to price_desc."},{"method":"GET","path":"/boats/{id}","description":"Full details for one boat, including all photos and full description.","example":"https://boatlisting.com.au/api/v1/boats/123"},{"method":"GET","path":"/brokers/{id}","description":"Public broker profile: company name, about, address, website and current listings. Contact fields respect the broker's visibility settings.","example":"https://boatlisting.com.au/api/v1/brokers/42"},{"method":"GET","path":"/facets","description":"Popular makes, categories and states with counts — useful for building filters."},{"method":"GET","path":"/openapi.json","description":"This API as a standard OpenAPI 3.0 specification (machine-readable)."}],"terms":"Data is provided for discovery. Link back to the listing url when presenting boats. No bulk redistribution or resale of data. Respect rate limits.","contact":"support@boatlisting.com.au"}