{"version":"0.5.0","routes":[{"method":"GET","path":"/search","description":"Search for magnets by text query","parameters":{"query":{"text":{"type":"string","required":true,"description":"Search text query"},"format":{"type":"string","required":false,"description":"Format filter"},"page":{"type":"number","required":false,"description":"Page number"},"tld":{"type":"string","required":false,"description":"Domain TLD (e.g. com -> <DOMAIN>.com, lu -> <DOMAIN>.lu)"}}},"example":"/search?text=harry+potter&format=mp3&page=1&tld=lu","response":{"item":{"id":"string","title":"string","author":"string","read":"string","format":"string","bitrate":"string","createdAt":"string","lang":"string","size":"string","hash":"string","magnetUrl":"string"},"_":"array","_or":"When many results, item shape is: title, id, categories, lang, cover, posted, info: { format, unit, size, sizeUnit }"}},{"method":"GET","path":"/id","description":"Get magnet by ID","parameters":{"query":{"id":{"type":"string","required":true,"description":"Magnet ID"},"tld":{"type":"string","required":false,"description":"Domain TLD (e.g. com -> <DOMAIN>.com, lu -> <DOMAIN>.lu)"}}},"example":"/id?id=12345&tld=lu","response":{"id":"string","title":"string","author":"string","read":"string","format":"string","bitrate":"string","createdAt":"string","lang":"string","size":"string","hash":"string","magnetUrl":"string"}},{"method":"GET","path":"/explore","description":"Explore audiobooks by category or tag. Returns list with pagination.","parameters":{"query":{"grouping":{"type":"string","required":true,"description":"Category or tag (e.g. fantasy, sci-fi, english, bestsellers)"},"type":{"type":"string","required":false,"description":"'category' or 'tag'"},"page":{"type":"number","required":false,"description":"Page number"},"tld":{"type":"string","required":false,"description":"Domain TLD (e.g. com -> <DOMAIN>.com, lu -> <DOMAIN>.lu)"}}},"example":"/explore?grouping=fantasy&type=category&page=1&tld=lu","response":{"data":{"item":{"title":"string","id":"string","categories":"string[]","lang":"string","cover":"string","posted":"string","info":{"format":"string","unit":"string","size":"string","sizeUnit":"string"}},"_":"array"},"pagination":{"currentPage":"number","totalPages":"number"}}}]}