API version 1

The first iteration of an API interface, version 1

The API url is:

https://api.knaben.eu

The API takes a POST request with a JSON body

The following fields can be set when searching:

Name Type Default Example Description
search_type "score" | percentage value 100% score search_type can either be score, referring to scoring based on best hit a percentage value from 0% - 100% referring to Elasticsarch's minimum_should_match
search_field String None title If set, will match the query search on the set field. The available fields are mentioned below.
query String None Debian Linux ISO This is the search query itself
order_by String None seeders The field to order by. Normally most people order by seeders or peers in descending order.
order_direction "desc" | "asc" desc asc This is the direction you want to order by in. Descending, biggest number first. Ascending, Smallest number first.
categories Integer[] None [5001000, 5004000] The category ids you want to search on. There are so many ids, better have a look at the RSS page, clicking on Toggle show categories to find the IDs
from Integer 0 0 This is the scroll offset. If you have a size of 10, and want to scroll to the next page, you can do from: 10, size: 10. Then from: 20, size 10 etc...
size Integer 150 50 The amount of results to return. Maximum size is 300
hide_unsafe Boolean true false Filters out very old results, and results that has a relative high potential virus score.
hide_xxx Boolean false true To hide porn or not to hide porn.
seconds_since_last_seen Integer None 86400 Relative seconds since last seen by Knaben. Documents are updated fast. For reference, the db contains 5804463 documents seen the last week, 2923199 seen the last day and 637823 seen in the last hour

Example request:

POST /v1
{
  "search_type": "100%",
  "search_field": "title",
  "query": "dubioza kolektiv",
  "order_by": "peers",
  "order_direction": "desc",
  "categories": [
    1004000, 1001000
  ],
  "from": 0,
  "size": 150,
  "hide_unsafe": true,
  "hide_xxx": true,
  "seconds_since_last_seen": 86400
}
        

Example response:

{
  "max_score": null,
  "total": {
    "relation": "eq",
    "value": 7
  },
  "hits": [
    {
      "bytes": 8734638,
      "cachedOrigin": "The Pirate Bay (proxy)",
      "category": "Audio / MP3",
      "categoryId": [
        1000000,
        1001000
      ],
      "date": "2015-11-08T00:00:00",
      "details": "https://knaben.xyz/thepiratebay/description.php?id=12724322",
      "hash": "B06B8470FF02B031433C94D5434C6795B5FA092E",
      "id": "918da9da460250d3d1bd166e8ddb4704f3a6adb3",
      "lastSeen": "2024-11-04T17:55:15",
      "magnetUrl": "magnet:?xt=urn:btih:B06B8470FF02B031433C94D5434C6795B5FA092E&dn=Dubioza+Kolektiv+-+Free+MP3.mp3&tr=http%3A%2F%2Fp4p.arenabg.com%3A1337%2Fannounce&tr=udp%3A%2F%2F47.ip-51-68-199.eu%3A6969%2Fannounce&tr=udp%3A%2F%2F9.rarbg.me%3A2780%2Fannounce&tr=udp%3A%2F%2F9.rarbg.to%3A2710%2Fannounce&tr=udp%3A%2F%2F9.rarbg.to%3A2730%2Fannounce&tr=udp%3A%2F%2F9.rarbg.to%3A2920%2Fannounce&tr=udp%3A%2F%2Fopen.stealth.si%3A80%2Fannounce&tr=udp%3A%2F%2Fopentracker.i2p.rocks%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.cyberia.is%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.dler.org%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.internetwarriors.net%3A1337%2Fannounce&tr=udp%3A%2F%2Ftracker.leechers-paradise.org%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.openbittorrent.com%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.opentrackr.org%3A1337&tr=udp%3A%2F%2Ftracker.pirateparty.gr%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.tiny-vps.com%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.torrent.eu.org%3A451%2Fannounce",
      "peers": 1,
      "score": null,
      "seeders": 0,
      "title": "Dubioza Kolektiv - Free MP3.mp3",
      "tracker": "The Pirate Bay",
      "trackerId": "thepiratebay",
      "virusDetection": 0.16737702077833227
    },
    {
      "bytes": 76902560,
      "cachedOrigin": "1337x",
      "category": "Audio / MP3",
      "categoryId": [
        1001000,
        1000000
      ],
      "date": "2018-08-11T00:00:00+02:00",
      "details": "https://1337x.to/torrent/3168985/Dubioza-Kolektiv-Pjesmice-za-djecu-i-odrasle-MP3-320kbps-2017-MRSK/",
      "hash": null,
      "id": "edab57e04c7a0d9c62521bc4fe17e16d2daa11cc",
      "lastSeen": "2024-11-04T18:34:44",
      "link": "https://knaben.eu/live/dl/1337x/?path=Q2ZESjhDWHZSYU9Hcm9sQWdfMURDakxrWldKcDZKdmo4UjNmTzQtUFdWZUdibnB5N0lnckVoY0RZS0o3N2Y3ZFR1NHdrQlduVmhWazBEY0pFUl9jYjd5QzBoZUVjR1dJVGw5ZGN3RlBQS011dkVNZ19KaVU2My1BY0RyRjItdTRCSHNzTVE5QjROVE5XMi1PWXFJR0piQXg4UDI3U3k0NVpReEdKazhiQi1qTlo2UmVHeE1tcElFUlNjN3B5MTJxMmdnbXVzWWxtUE1NX3lPc25xSldZZkIxTm5oVXhrbmdrdXVZMERmRnN6d2ZYaHM5LVl5anFVaXRoVVk5VDZaNjhHWTRTQQ&file=Dubioza+Kolektiv+++Pjesmice+za+djecu+i+odrasle+%5BMP3+320kbps%5D+(2017)+%5BMRSK%5D&knabensource=https%3A%2F%2F1337x.to%2Ftorrent%2F3168985%2FDubioza-Kolektiv-Pjesmice-za-djecu-i-odrasle-MP3-320kbps-2017-MRSK%2F",
      "magnetUrl": null,
      "peers": 0,
      "score": null,
      "seeders": 4,
      "title": "Dubioza Kolektiv   Pjesmice za djecu i odrasle [MP3 320kbps] (2017) [MRSK]",
      "tracker": "1337x",
      "trackerId": "1337x",
      "virusDetection": 0.28133041133809267
    },
    {
      ...
    }
  ]
}