Safe Haskell	Safe-Infered

IsoHunt.Search

Contents

The main function
Query
Response
Exceptions

Description

IsoHunt API; see http://ca.isohunt.com/forum/viewtopic.php?p=433527#433527.

Sample use:

 resp <- search (simpleQuery "ubuntu")

The following terms and conditions apply to the IsoHunt API, as stated in the above link:

In using our search API, you are free to do with it as you wish on condition that if your app is available publicly to users, you must link to torrent details pages on isoHunt.com, whether you link to the .torrent files or not. We reserve the right to ban you from using our API if you don't follow this simple rule. Refer to Louish's iPhone app for a good example of including links to our torrent details pages. Our torrent details pages have URLs like this: http://isohunt.com/torrent_details/28289948/ubuntu?tab=summary

While we don't require developer tokens or place hard limits on api calls usage, excessive calls will also result in bans. If you think your app will consistently sustain multiple calls per second to our api, email admin at this site's domain first.

You are free to promote your app using our API, by replying under this post (http://ca.isohunt.com/forum/viewtopic.php?p=433527#433527) or post under this forum (http://isohunt.com/forum/viewforum.php?f=19). If your app is really good, we'll likely want to spotlight it on isoHunt's frontpage. Multiple posts to promote your app on our forum or comments is not allowed however, and will be treated as spam.

Synopsis

The main function

search :: Query -> IO Response Source

Search IsoHunt with the given query.

Throws MalformedJSON or MalformedResponse if the result is of an expected format.

Query

data Query Source

See also simpleQuery and def for constructing queries

Constructors

Query
Fields searchTerm :: !String start :: !Int start+rows <= 1000 rows :: !Int <= 100 sort :: !Sort order :: !Order

Instances

Eq Query
Ord Query
Show Query
Typeable Query
Default Query

simpleQuery :: String -> Query Source

A default query for the given search term

data Sort Source

Constructors

Composite	Overall factors such as age, query relevance seed/leechers counts and vots
Seeds	Seeds + leechers
Age
Size

Instances

Eq Sort
Ord Sort
Show Sort
Typeable Sort

data Order Source

Constructors

Descending
Ascending

Instances

Eq Order
Ord Order
Show Order
Typeable Order

Response

The Response, Item, Image data types all share some field names, such as title. To resolve ambiguity in these fields, use qualified imports as follows:

 import qualified IsoHunt.Response as Response
 import qualified IsoHunt.Item as Item
 import qualified IsoHunt.Image as Image

 ... Response.title r ... Item.title i ... Image.title im ...

The fields in these datatypes are mostly undocumented; see http://ca.isohunt.com/js/json.php?ihq=ubuntu&start=1&rows=4 for an example response.

data Response Source

Instances

Eq Response
Ord Response
Show Response
Typeable Response
Generic Response
FromJSON Response

data Item Source

Instances

Eq Item
Ord Item
Show Item
Typeable Item
Generic Item
FromJSON Item

data Image Source

Instances

Eq Image
Ord Image
Show Image
Typeable Image
Generic Image
FromJSON Image

Exceptions

data MalformedJSON Source

The response was invalid JSON. The unparsed contents are included.

Constructors

MalformedJSON !ByteString

Instances

Show MalformedJSON
Typeable MalformedJSON
Exception MalformedJSON

data MalformedResponse Source

The response was valid JSON, but not of the expected format. Error message and the JSON value are included.

Constructors

MalformedResponse !String !Value

Instances

Show MalformedResponse
Typeable MalformedResponse
Exception MalformedResponse