{"name":"Torrgle P2P & Torrent Search API","version":"1.0.0","description":"REST API dla wyszukiwarki torrentów i sieci Mainline DHT wzorowanej na Google","endpoints":{"search":{"method":"GET","path":"/api/search","description":"Wyszukiwanie pełnotekstowe po nazwie, opisie, plikach lub 40-znakowym InfoHash","params":{"q":"fraza wyszukiwania (opcjonalna, np. ubuntu, blender, sha-1 infohash)","category":"kategoria: all, os, video, audio, software, archive, books","sort":"sortowanie: relevance, seeders, size, date","page":"numer strony (domyślnie 1)","limit":"wyników na stronę (domyślnie 10, max 50)","minSeeders":"minimalna liczba seedów (np. 100)","verifiedOnly":"tylko zweryfikowane wydania (true/false)"},"example":"/api/search?q=linux&category=os&sort=seeders"},"torrentById":{"method":"GET","path":"/api/torrents/[id]","description":"Szczegóły konkretnego torrenta (lista plików, trackery, infohash) po ID lub Hash","example":"/api/torrents/ubuntu-24-04-desktop"},"torrentsCollection":{"method":"POST","path":"/api/torrents","description":"Dodawanie/indeksowanie nowego torrenta lub linku magnet do wyszukiwarki","body":{"name":"Nazwa pliku/wydania (wymagana jeśli brak magnetLink)","magnetLink":"Opcjonalny link magnet:?xt=urn:btih:...","infoHash":"Opcjonalny 40-znakowy hash SHA-1","category":"os | video | audio | software | archive | books","size":"np. 4.2 GB","seeders":"liczba seedów (number)","trackers":"tablica stringów z trackerami"}},"magnetHelper":{"method":"GET | POST","path":"/api/magnet","description":"GET: parsuje magnet URI na parametry. POST: buduje magnet URI z hash, nazwy i trackerów."},"stats":{"method":"GET","path":"/api/stats","description":"Statystyki indeksu, liczba seedów, węzły DHT"},"trending":{"method":"GET","path":"/api/trending","description":"Popularne zapytania i najczęściej seedowane pozycje"}}}