This is the unofficial custom API of 1337x. It supports all proxies of 1337x and almost all functions of 1337x. You can search, get trending, top and popular torrents. Furthermore, you can browse torrents of a certain category. It also supports filtering on result by category, supports sorting and caching. Tor requests are now integrated with no more action to do. Works great and smoothly !
- Install from the source
git clone https://github.com/LeGeRyChEeSe/1337x.git && cd 1337x && python setup.py sdist && pip install dist/* && sudo apt-get install tor build-essential libssl-dev libffi-dev python-dev
- Generate a password that you should store at a safe place and remember it
tor --hash-password your-password- Copy the output of the previous command, it should looks like
16:05B7B9E8F3D0AB3160E030928F9517EDA5348ECD1CDCE2D95F0D230016- Configure the Tor controller to permit identity renewall requests
sudo nano /etc/tor/torrc- Uncomment those three lines
ControlPort 9051
CookieAuthentication 1
HashedControlPassword- Paste the hashed password you previously copied next to HashedControlPassword. If there is a password already, replace it with the newer. Now it should looks like
ControlPort 9051
CookieAuthentication 1
HashedControlPassword 16:05B7B9E8F3D0AB3160E030928F9517EDA5348ECD1CDCE2D95F0D230016- Save and exit the file and now it's time to start Tor service
sudo service tor start- If you did all well then you can run the following command from a terminal to check if it works
curl --socks5 localhost:9050 --socks5-hostname localhost:9050 -s https://check.torproject.org/ | cat | grep -m 1 Congratulations | xargs- This command will display
Congratulations. This browser is configured to use Tor.- The reason is probably because your Tor IP has been detected has SPAM so the solution is to reset a new Tor IP
>>> from py1337x import py1337x
# Trying with 11337x.st proxy but we don't get any info of the torrent
>>> torrents = py1337x('1337x.to')
>>> torrents.search('harry potter')
None # Or possibly some errors
# Try to do the following
>>> torrents.getNewIp(passwd)
# passwd parameter is the clear password you've set in the Installation of Tor at the beginning of this guide.
# CLEAR password, not Hashed one.
# Then it should fix the issue temporarly until you need to renew the Tor IP again
# Of course you can do a for loop with many checks before you renew the IP
>>> torrents.search('harry potter')
{'items': [...], 'currentPage': 1, 'itemCount': 20, 'pageCount': 50}- You should call this method once if you're getting no torrents for a while
torrents.setNewProxy(other_proxy)- If you don't want to do it manually so you can do a for loop in the new attribute
torrents.proxieswhich is a list
>>> from py1337x import py1337x
# Trying with 11337x.st proxy but we don't get any info of the torrent
>>> torrents = py1337x('11337x.st')
>>> torrents.info(torrentId=258188)
{'items': [], 'currentPage': 0, 'itemCount': 0, 'pageCount': 0}
# We can do a for loop to try every proxy until one returns the infos of the torrent.
# Useful when you don't remember which proxy you've used for searching or getting a torrent.
>>> for proxy in torrents.proxies:
>>> torrents.setNewProxy(proxy)
>>> torrents.info(torrentId=258188)
# Possible Output
{'items': [], 'currentPage': 0, 'itemCount': 0, 'pageCount': 0}
{'items': [], 'currentPage': 0, 'itemCount': 0, 'pageCount': 0}
.
.
.
{'items': [...], 'currentPage': 1, 'itemCount': 20, 'pageCount': 50} # So we've finally got our torrent data>>> from py1337x import py1337x
# Using 1337x.tw and saving the cache in sqlite database which expires after 500 seconds
>>> torrents = py1337x(proxy='1337x.to', cache='py1337xCache', cacheTime=500)
>>> torrents.search('harry potter')
{'items': [...], 'currentPage': 1, 'itemCount': 20, 'pageCount': 50}
# Searching harry potter in category movies and sort by seeders in descending order
>>> torrents.search('harry potter', category='movies', sortBy='seeders', order='desc')
{'items': [...], 'currentPage': 1, 'itemCount': 40, 'pageCount': 50}
# Viewing the 5th page of the result
>>> torrents.search('harry potter', page=5)
{'items': [...], 'currentPage': , 'itemCount': 20, 'pageCount': 50}>>> from py1337x import py1337x
# Using the default proxy (1337x.to) Without using cache
>>> torrents = py1337x()
# Today's trending torrents of all category
>>> torrents.trending()
{'items': [...], 'currentPage': 1, 'itemCount': 50, 'pageCount': 1}
# Trending torrents this week of all category
>>> torrents.trending(week=True)
{'items': [...], 'currentPage': 1, 'itemCount': 50, 'pageCount': 1}
# Todays trending anime
>>> torrents.trending(category='anime')
{'items': [...], 'currentPage': 1, 'itemCount': 50, 'pageCount': 1}
# Trending anime this week
>>> torrents.trending(category='anime', week=True)
{'items': [...], 'currentPage': 1, 'itemCount': 50, 'pageCount': 1}>>> from py1337x import py1337x
# Using 11337x.st and passing the cookie since 11337x.st is cloudflare protected
>>> torrents = py1337x('11337x.st', cookie='<cookie>')
# Getting the information of a torrent by its link
>>> torrents.info(link='https://www.1337xx.to/torrent/258188/h9/')
{'name': 'Harry Potter and the Half-Blood Prince', 'shortName': 'Harry Potter', 'description': "....", 'category': 'Movies', 'type': 'HD', 'genre': ['Adventure', 'Fantasy', 'Family'], 'language': 'English', 'size': '3.0 GB', 'thumbnail': '...', 'images': [...], 'uploader': ' ...', 'uploaderLink': '...', 'downloads': '5310', 'lastChecked': '44 seconds ago', 'uploadDate': '4 years ago', 'seeders': '36', 'leechers': '3', 'magnetLink': '...', 'infoHash': '...'}
# Getting the information of a torrent by its link
>>> torrents.info(torrentId='258188')
{'name': 'Harry Potter and the Half-Blood Prince', 'shortName': 'Harry Potter', 'description': "....", 'category': 'Movies', 'type': 'HD', 'genre': ['Adventure', 'Fantasy', 'Family'], 'language': 'English', 'size': '3.0 GB', 'thumbnail': '...', 'images': [...], 'uploader': ' ...', 'uploaderLink': '...', 'downloads': '5310', 'lastChecked': '44 seconds ago', 'uploadDate': '4 years ago', 'seeders': '36', 'leechers': '3', 'magnetLink': '...', 'infoHash': '...'}from py1337x import py1337x
torrents = py1337x(proxy='1337x.st', cookie='<cookie>', cache='py1337xCache', cacheTime=86400, backend='sqlite')Proxy
If the default domain is banned in your country, you can use an alternative domain of 1337x, or you can use the new Tor Request system.
All categories are now accessible via the torrents.proxies attribute.
1337x.to(default)1337x.tw1377x.to1337xx.to1337x.stx1337x.wsx1337x.eux1337x.se1337x.is1337x.gd
cookie
Some of the proxies are protected with Cloudflare. For such proxies you need to pass a cookie value. To get a cookie go the the protected site from your browser, solve the captcha and copy the value of cf_clearance.
Firefox: Inspect element > Storage > Cookies
Chrome: Inspect element > Application > Storage > Cookies
cache
Py1337x uses requests-cache for caching to store data so that future requests for that data can be served faster. cache can be any of the following.
- A boolean value:
Truefor using cache andFalsefor not using cache. (cache is not used by default) - Directory for storing the cache.
cacheTime
By default the cache expires after one day. You can change the cache expiration time by setting a custom cacheTime.
-
-1(to never expire) -
0(to “expire immediately,” e.g. bypass the cache) -
A positive number (in seconds [defaults to 86400])
-
A
datetime
backend
The backend for storing the cache can be any of the following.
-
'sqlite': SQLite database (default) -
'redis': Redis cache (requires redis) -
'mongodb': MongoDB database (requires pymongo) -
'gridfs': GridFS collections on a MongoDB database (requires pymongo) -
'dynamodb': Amazon DynamoDB database (requires boto3) -
'memory': A non-persistent cache that just stores responses in memory
from py1337x import py1337x
torrents = py1337x()| Method | Description | Arguments |
|---|---|---|
| torrents.search(query) | Search for torrents | self, query: Keyword to search for,page (Defaults to 1): Page to view,category (optional): category, sortBy (optional): Sort by, Order (optional): order |
| torrents.trending() | Get trending torrents | self, category (optional): category, week (Defaults to False): True for weekely, False for daily |
| torrents.top() | Get top torrents | self, category (optional): category |
| torrents.popular(category) | Get popular torrents | self, category: category, week (Defaults to False): True for weekely, False for daily |
| torrents.browse(category) | Browse browse of certain category | self, category: category, page (Defaults to 1): Page to view |
| torrents.info(link or torrentId) | Get information of a torrent | self, link: Link of a torrent ortorrentId: ID of a torrent |
| torrents.setNewProxy(proxy) | Set a new proxy for the instance | self, proxy: Proxy string of type '1337x.to' |
| torrents.getNewIp(passwd) | Set a new IP for Tor requests | self, passwd: Clear Password set in Requirements (2./3.) |
All categories are now accessible via the torrents.categories attribute.
'movies''tv''games''music''apps''anime''documentaries''xxx''others'
'time''size''seeders''leechers'
'desc'(for descending order)'asc'(for ascending order)
Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Thanks to every contributors who have contributed in this project.
- Torrent Hunt - Telegram bot to search torrents.
Want to list your project here? Just make a pull request.
Distributed under the MIT License. See LICENSE for more information.
Author/Maintainer: Hemanta Pokharel | Youtube: @H9Youtube