zooqle-api-ts
v1.0.40
Published
Promise based Zooqle Torrent Scraper written in TypeScript.
Downloads
19
Maintainers
Readme
this package has been moved to https://www.npmjs.com/package/zooqle
Overview
made with ♥️ and typescript
There is complete type support for all api returns.
Installation
install module.
npm i zooqle
include it in your project.
// node way const { zooqle } = require('zooqle') // es6 way import { zooqle } from 'zooqle'
if you are using this package with typescript you should install the cheerio types.
npm i @types/cheerio -D
Zooqle Search
Parameters:
- query: string
- params (optimal): string array
return: Promise<returns>
// (query: string, params?: string[]): Promise
zooqle.search()
Search by Query
Search zooqle for something....
You can use search parameters to sort results
return: Promise<search>
example:
zooqle.search('silicon valley').then(response => {
// code
})
Search by IMDB Id
Search zooqle for a certain Movie or Show. return: Promise<show | movie>
example:
zooqle.search('tt2575988').then(response => {
// code
})
Search by Magnet hash
Search zooqle for a certain Torrent.
return: Promise<torrent>
example:
zooqle.search('115E8B3596DE77BF6A463B2654697F47F4064DB6').then(response => {
// code
})
Search Parameters
By using search parameters you can apply zooqle link parameters to any search that you do.
example:
// using enums
const linkParameters = [
zooqle.enums.SORT.seeders,
zooqle.enums.SORT_TYPE.descending
]
zooqle.search('silicon valley', linkParameters).then(response => {
// code
}
// passing strings
const linkParameters = [
's=ns',
'sd=d'
]
zooqle.search('silicon valley', linkParameters).then(response => {
// code
}
value map:
// SORT
seeders: 's=ns'
date: 's=dt'
size: 's=sz'
// SORT_TYPE
descending: 'sd=d'
ascending: 'sd=a'
Search Returns
search
example return:
{
"type": "search",
"searchResponse": {
"searchResults": [
{
"filetype": "show",
"href": "/silicon-valley-s04e07-hdtv-x264-sva-rartv-w8suk.html",
"title": "Silicon Valley S04E07 HDTV x264-SVA[rartv]",
"size": "150 MB",
"seeders": 570,
"leechers": 17,
"magnet": "magnet:?xt=urn:btih:115E8B3596DE77BF6A463B2654697F47F4064DB6&dn=%5Bzooqle.com%5D%20Silicon%20Valley%20S04E07%20HDTV%20x264-SVA%5Brartv%5D&tr=udp://tracker.coppersurfer.tk:6969&tr=udp://tracker.leechers-paradise.org:6969&tr=http://explodie.org:6969/announce&tr=http://tracker.mg64.net:6881/announce&tr=http://mgtracker.org:2710/announce",
"hash": "115E8B3596DE77BF6A463B2654697F47F4064DB6"
},
...
],
"search": "silicon valley",
"pageSize": 30,
"total": 931
}
}
show
example return:
{
"type": "show",
"showResponse": {
"title": "Silicon Valley",
"from": "April 6, 2014",
"to": "May 27, 2018",
"summary": "Follows the struggle of Richard Hendricks, a silicon valley engineer trying to build his own company called Pied Piper",
"seasons": [
{
"season": "Season 5",
"date": "March 25, 2018",
"episodes": [
{
"episodeNumber": "*",
"episodeTitle": "Compilations & Specials",
"dataHref": "/misc/tveps.php?show=60573&se=5&ep=-1"
},
{
"episodeNumber": "1",
"episodeTitle": "Grow Fast or Die Slow",
"dataHref": "/misc/tveps.php?show=60573&se=5&ep=1"
},
...
]
},
...
]
}
}
movie
example return:
{
"type": "movie",
"movieResponse": {
"title": "The Dark Knight (2008)",
"summary": "When the menace known as the Joker emerges from his mysterious past, he wreaks havoc and chaos on the people of Gotham, the Dark Knight must accept one of the greatest psychological and physical tests of his ability to fight injustice.",
"release": "July 16, 2008",
"results": [
{
"title": "The Dark Knight 2008 IMAX BluRay 2160p x265 HDR DD 5 1[En Hi]-DT",
"torrentHref": "/the-dark-knight-2008-imax-bluray-2160p-x265-hdr-dd-5-1-en-hi-dt-wyu0g.html",
"sound": "5.1",
"language": "en,hi",
"quality": "2160p",
"size": "22.9 GB",
"seeders": 15,
"leechers": 15
},
...
]
}
}
torrent
example return:
{
"type": "torrent",
"torrentResponse": {
"filetype": "movie",
"title": "Batman.-.The.Dark.Knight.2008.(2160p.x265.10bit.S90.Joy).torrent",
"source": null,
"sourceUrl": null,
"magnet": "magnet:?xt=urn:btih:58CB561E616FA4FCCE3D5FE48AD4AB48101CDDCB&dn=%5Bzooqle.com%5D%20Batman%20-%20The%20Dark%20Knight%202008%20%282160p%20x265%2010bit%20S90%20Joy%29&tr=udp://tracker.leechers-paradise.org:6969&tr=http://explodie.org:6969/announce&tr=http://mgtracker.org:2710/announce&tr=http://tracker.mg64.net:6881/announce&tr=http://announce.xxx-tracker.com:2710/announce&xl=7262420065&tr=udp%3A%2F%2Fp4p.arenabg.com%3A1337&tr=udp%3A%2F%2F9.rarbg.to%3A2710&tr=udp%3A%2F%2Feddie4.nl%3A6969&tr=udp%3A%2F%2Fpublic.popcorn-tracker.org%3A6969&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969",
"hash": "58CB561E616FA4FCCE3D5FE48AD4AB48101CDDCB",
"size": "6.8 GB",
"date": "Mar 24, 2018"
}
}
Zooqle GetData
Sometimes the scrapper search result will return a property called "dataHref", which is more data about the current result hidden within another subpage of zooqle.
To get this data, you can simply pass the "dataHref" property to the getData function.
Parameters:
- query: string
- params (optimal): string array
return: Promise<data>
// (dataHref: string): Promise
zooqle.getData()
example:
zooqle.getData('/misc/tveps.php?show=60573&se=5&ep=1').then(response => {
// code
})
data return
example return:
[
{
"title": "Silicon Valley S05E01 (1080p AMZN WEB-DL x265 HEVC 10bit AC3 5 1 Qman) [UTR]",
"metaUrl": "/silicon-valley-s05e01-1080p-amzn-web-dl-x265-hevc-10bit-ac3-5-1-wqqje.html",
"sound": "5.1",
"language": "en",
"quality": "1080p",
"magnet": "magnet:?xt=urn:btih:FE07B9CD13412F8635616E59FCC5EF98ACD5339E&dn=%5Bzooqle.com%5D%20Silicon%20Valley%20S05E01%20%281080p%20AMZN%20WEB-DL%20x265%20HEVC%2010bit%20AC3%205%201%20Qman%29%20%5BUTR%5D&tr=udp://tracker.leechers-paradise.org:6969&tr=http://explodie.org:6969/announce&tr=http://mgtracker.org:2710/announce&tr=http://tracker.mg64.net:6881/announce&tr=http://announce.xxx-tracker.com:2710/announce",
"hash": "FE07B9CD13412F8635616E59FCC5EF98ACD5339E",
"size": "656 MB",
"seeders": 17,
"leechers": 5
},
{
"title": "Silicon Valley (2014) - S05E01 (1080p AMZN WEB-DL x265 HEVC 10bit EAC3 6 0 RZeroX)",
"metaUrl": "/silicon-valley-2014-s05e01-1080p-amzn-web-dl-x265-hevc-10bit-eac-wqpau.html",
"sound": "5.1",
"language": "en",
"quality": "1080p",
"magnet": "magnet:?xt=urn:btih:94C1F498C41DB7F8E35CF43FEAC616448E2E9E9D&dn=%5Bzooqle.com%5D%20Silicon%20Valley%20%282014%29%20-%20S05E01%20%281080p%20AMZN%20WEB-DL%20x265%20HEVC%2010bit%20EAC3%206%200%20RZeroX%29&tr=udp://tracker.leechers-paradise.org:6969&tr=http://explodie.org:6969/announce&tr=http://mgtracker.org:2710/announce&tr=http://tracker.mg64.net:6881/announce&tr=http://announce.xxx-tracker.com:2710/announce",
"hash": "94C1F498C41DB7F8E35CF43FEAC616448E2E9E9D",
"size": "660 MB",
"seeders": 11,
"leechers": 8
},
...
]
Zooqle GetTorrentData
If you have an url to a torrent subpage of Zooqle you can use getTorrentData to get meta info about the torrent.
Sometimes the scrapper will return a property called "torrentHref", which can be passed to this function.
Parameters:
- torrentHref: string
return: Promise<torrentData>
// (dataHref: string): Promise
zooqle.getTorrentData()
example:
zooqle.getTorrentData('/batman-the-dark-knight-2008-2160p-x265-10bit-s90-joy-wqipm.html').then(response => {
// code
})
torrentData return
example return:
{
"filetype": "movie",
"title": "Batman.-.The.Dark.Knight.2008.(2160p.x265.10bit.S90.Joy).torrent",
"source": null,
"sourceUrl": null,
"magnet": "magnet:?xt=urn:btih:58CB561E616FA4FCCE3D5FE48AD4AB48101CDDCB&dn=%5Bzooqle.com%5D%20Batman%20-%20The%20Dark%20Knight%202008%20%282160p%20x265%2010bit%20S90%20Joy%29&tr=udp://tracker.leechers-paradise.org:6969&tr=http://explodie.org:6969/announce&tr=http://mgtracker.org:2710/announce&tr=http://tracker.mg64.net:6881/announce&tr=http://announce.xxx-tracker.com:2710/announce&xl=7262420065&tr=udp%3A%2F%2Fp4p.arenabg.com%3A1337&tr=udp%3A%2F%2F9.rarbg.to%3A2710&tr=udp%3A%2F%2Feddie4.nl%3A6969&tr=udp%3A%2F%2Fpublic.popcorn-tracker.org%3A6969&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969",
"hash": "58CB561E616FA4FCCE3D5FE48AD4AB48101CDDCB",
"size": "6.8 GB",
"date": "Mar 24, 2018"
}