{"name":"TradeMV API","description":"Buy & sell across the Maldives — free public read-only JSON API for the Maldives' online marketplace (trademv.com). No authentication or API key required for the endpoints below. Posting, messaging, and account actions are only available through the website.","base_url":"https://trademv.com/api","contact":"support@trademv.com","llms_txt":"https://trademv.com/llms.txt","endpoints":[{"method":"GET","path":"/api/listings","description":"Search and filter active listings. Returns { count, limit, offset, listings: [...] }.","params":{"q":"Full-text search over title + description (e.g. q=yamaha).","category":"Category slug (includes all descendant categories). Get slugs from GET /api/categories.","atoll":"Atoll code (e.g. K, R, HA). Listings carry both `atoll` (code) and `atollName`.","island":"Exact island name (e.g. Ungoofaaru).","priceMin":"Minimum price, in the listing's own currency (alias: min_price).","priceMax":"Maximum price, in the listing's own currency (alias: max_price).","promoted":"true/false (or 1/0) — only promoted/featured listings.","attr_<key>":"Filter by a category attribute, e.g. attr_brand=MSI or attr_condition=Used. Valid keys per category come from attribute_schema in GET /api/categories.","sort":"newest (default) | oldest | price_asc | price_desc | title_asc | title_desc.","limit":"Page size, default 50, max 100.","offset":"Rows to skip (use with limit for paging)."},"example":"https://trademv.com/api/listings?category=monitors&attr_brand=MSI&sort=price_asc&limit=20","notes":"Prices are in the listing's own currency (MVR or USD — check the `currency` field); priceMin/priceMax compare raw numbers and do not convert between currencies. Unknown params are ignored."},{"method":"GET","path":"/api/listings/{id}","description":"Single listing by its public id (e.g. l-35). Returns { listing } or a JSON 404 { error }.","example":"https://trademv.com/api/listings/l-35"},{"method":"GET","path":"/api/categories","description":"Full category tree. Every leaf category carries attribute_schema: the typed, filterable attributes (enum options, number units, booleans) used by listings in that category and by attr_<key> filters.","example":"https://trademv.com/api/categories"}],"notes":["These three endpoints are the entire public API surface — there is no /api/search, /api/atolls, /api/shops, or OpenAPI document.","Listing pages for humans live at /listing/{id}; category pages at /c/{slug}; global search at /c/all?q=…","Be a good citizen: cache responses where you can and keep request rates modest."]}