Arts populaires | Selena Gomez – Seven Heavens New Album | I’m Dying Up Here
Zooqle APIS

We at Zooqle believe in sharing information. So we will be doing public APIs to the data we collect (in addition to already available OpenSearch RSS feeds, mind you).

The only thing we ask is not to abuse these (they're rate-limited at 1 request per second) and maybe put up a back link (no pressure!).

#01 – Torrent and media info

This endpoint allows your to get detailed information about specific torrent.

Request Format

Requests should use GET method with URL http://kit4en.com/api/media/<infohash_here>

As you might've guessed, <infohash_here> should be replaced with infohash of torrent you're asking about. In base-16 ("hex") or base-32 encodings.

Response Format

If everything is fine and dandy (and it should!), you will get JSON response, with UTF-8 encoding.

Below is a "kitchen sink" example:

{
  "infohash": "<base-16 infohash>",
  "name": "<Torrent name>",
  "category": "<Category name>",
  "url": "<Link to torrent's page on Zooqle>",
  "seeders": <Number of seeders>,
  "leechers": <Number of leechers>,
  "size": <Torrent files size>,
  "num_files": <Torrent files number>,
  "time_indexed": <Unix timestamp – when torrent was found by Zooqle, UTC>, // We regualarily import torrents from different sources, so some of them can be backdated.
  "video_quality": "<Overall video quality, same as displayed on site>",
	// Next element will appear only for torrents with mediainfo. It shows data for the biggest file in torrent.
	// We're indexing actively, so if there is a decent amount (say, 4+) of seeds mediainfo will apper here soon(ish), usually within an hour or two.
  "media_info": {
     "video_format": "<Video codec used>",
     "video_width": <Duh!>,
     "video_height": <Duh! again>,
     "video_fps": <And yet another Duh!>,
     "duration": <Duration of longest stream in videofile, seconds>,
     "audio_channels": <Maximum number of audio channels of all audio streams>,
		 // Next element will appear if there are detected audio languages, 2-letter ISO codes
		 "audio_lang": [ "en", "es", "pt" ],
		 // Next element will appear if there are detected subtitle languages, 2-letter ISO codes
		 "subtitle_lang": [ "en" ],
  },
	// Next element will appear only for torrents associated with TV episodes.
  "tv": {
     "show": "<TV show name>",
     "show_started": <Year of TV show first episode>,
     "imdb": "<IMDB ID>",
     "season": <Season number>,
     "episode": <Episode number>,
     "time_aired": <Unix timestamp of episode airing day, UTC>,
     "episode_name": "<Episode title>"
  },
	// Next element will appear only for torrents associated with movies.
  "movie": {
		"name": "<Movie title>",
    "year": <Movie release year>,
    "imdb": "<IMDB ID>"
  }
}

Responses are cached for 4 hours, no need to re-query faster than that. Please note that TV/movie analysis is done asynchronously – new torrents can be tagged as TV/movies with a delay (up to half an hour for TV, up to 4 hours for movies).

Errors

If the request is malformed or hash is not found, you will get error 404. If we're doing something with servers or there in an attack of internet-eating gremlins, you might get 5xx error. Just retry in several seconds. So there.

Scrapers & Abuse

We might block abusive ASes or subnets (in some cases even whole hosting providers get blocked, like Amazon EC2, which is basically a free-for-all botnet). If IP of your server appears to be blocked and you didn't do bad things, drop us a line, we'll add it to the whitelist.

As long as you're just using APIs within limits – no problems. If you set up web proxy which does not alter Zooqle's content – no problems as well. If you run meta-search engine and link back to our site – no problems too (but you might want to drop us an email, so your IP will be whitelisted and allowed higher rate limits).

It's better to use OpenSearch XML feeds, these work a bit faster and consume less bandwidth. Applying some basic XSLT to turn them into HTML of your liking should be trivial.

If you set up traffic-stealing proxy, which rewrites pages, adds obscene amount of advertising and does not link back – your AS will get banned. Server resources and bandwidth are cheap, but not free – pay for yours yourself please.

If you need our data for legit purpose – just ask nicely, it can be arranged.