2021-10-22 08:20:47 +00:00
---
id : aither-api
name : Aither (API)
description : "Aither is a Private Torrent Tracker for HD MOVIES / TV"
language : en-US
type : private
encoding : UTF-8
links :
- https://aither.cc/
caps :
2021-10-22 17:01:22 +00:00
# dont forget to update the case block in the search fields category
2021-10-22 08:20:47 +00:00
categorymappings :
- {id: 1, cat: Movies, desc : "Movie" }
- {id: 9, cat: TV/Sport, desc : "Sport" }
- {id: 2, cat: TV, desc : "TV" }
- {id: 3, cat: Audio, desc : "Music" }
- {id: 4, cat: Console, desc : "Games" }
- {id: 10, cat: PC, desc : "Software & Apps" }
- {id: 11, cat: Books, desc : "Ebooks & Magazines" }
- {id: 14, cat: Audio/Audiobook, desc : "Audiobooks" }
- {id: 15, cat: Other, desc : "Education" }
- {id: 6, cat: XXX, desc : "XXX" }
modes :
search : [ q]
tv-search : [ q, season, ep, imdbid, tvdbid]
movie-search : [ q, imdbid, tmdbid]
music-search : [ q]
book-search : [ q]
settings :
- name : apikey
type : text
label : APIKey
- name : info_key
type : info
label : About your API key
default : "Find or Generate a new API Token by accessing your <a href=\"https://aither.cc/\" target =_blank>Aither</a> account <i>My Security</i> page and clicking on the <b>API Token</b> tab."
- name : freeleech
type : checkbox
label : Search freeleech only
default : false
- name : sort
type : select
label : Sort requested from site
default : created_at
options :
created_at : created
seeders : seeders
size : size
name : title
- name : type
type : select
label : Order requested from site
default : desc
options :
desc : desc
asc : asc
2022-01-16 19:16:53 +00:00
login :
path : /api/torrents
method : get
inputs :
api_token : "{{ .Config.apikey }}"
error :
- selector : a[href*="/login"]
2022-01-16 20:18:17 +00:00
message :
text : "The API key was not accepted by {{ .Config.sitelink }}."
2022-01-16 19:16:53 +00:00
2021-10-22 08:20:47 +00:00
search :
paths :
# https://hdinnovations.github.io/UNIT3D-Community-Edition-Docs/api_endpoints.html
2021-11-17 05:01:44 +00:00
# https://github.com/HDInnovations/UNIT3D-Community-Edition/blob/master/app/Http/Controllers/API/TorrentController.php
- path : "/api/torrents/filter?api_token={{ .Config.apikey }}&name={{ if .Query.IMDBID }}{{ else }}{{ .Keywords }}{{ end }}{{ if .Query.TMDBID }}&tmdbId={{ .Query.TMDBID }}{{ else }}{{ end }}{{ if .Query.IMDBIDShort }}&imdbId={{ .Query.IMDBIDShort }}{{ else }}{{ end }}{{ if .Query.TVDBID }}&tvdbId={{ .Query.TVDBID }}{{ else }}{{ end }}&sortField={{ .Config.sort }}&sortDirection={{ .Config.type }}&perPage=100&page=1{{ range .Categories }}&categories[]={{.}}{{end}}{{ if .Config.freeleech }}&free=1{{ else }}{{ end }}"
2021-10-22 08:20:47 +00:00
response :
type : json
attribute : attributes
rows :
selector : data
count :
selector : meta.total
fields :
category :
selector : category
case :
"Movie": 1
"Sport": 9
"TV": 2
"Music": 3
"Games": 4
"Software & Apps": 10
"Ebooks & Magazines": 11
"Audiobooks": 14
"Education": 15
"XXX": 6
title :
selector : name
details :
selector : details_link
download :
selector : download_link
poster :
selector : poster
filters :
- name : replace
args : [ "https://via.placeholder.com/90x135" , "" ]
- name : replace
args : [ "https://via.placeholder.com/400x600" , "" ]
imdbid :
selector : imdb_id
tmdbid :
selector : tmdb_id
tvdbid :
selector : tvdb_id
files :
selector : num_file
seeders :
selector : seeders
leechers :
selector : leechers
grabs :
selector : times_completed
date :
# 2021-10-18T00:34:50.000000Z"
selector : created_at
size :
selector : size
downloadvolumefactor :
# api returns 0=false, 1=true
selector : freeleech
case :
0 : 1 # not free
1 : 0 # freeleech
uploadvolumefactor :
# api returns 0=false, 1=true
selector : double_upload
case :
0 : 1 # normal
1 : 2 # double
# global MR is 0.4 but torrents must be seeded for 3 days regardless of ratio
# minimumratio:
# text: 0.4
minimumseedtime :
# 3 days (as seconds = 3 x 24 x 60 x 60)
text : 259200
# json UNIT3D 5.3.0