The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Rarbg::torrentapi - Wrapper around Rarbg torrentapi (https://torrentapi.org/apidocs_v2.txt)

SYNOPSIS

use Rarbg::torrentapi;
my $tapi = Rarbg::torrentapi->new();

# list lastest torrents
my $last_added = $tapi->list();

# list torrents sorted by seeders
my $last_added = $tapi->list({
    sort => 'seeders',
    limit => 50,
    category => 'tv'
});

# search by string
# You can use all attributes also
my $search = $tapi->search({
    search_string => 'the beatles',
    category => '23;24;25;26',
    min_seeders => 20
});

# search by imdb id
my $search = $tapi->search({
    search_imdb => 'tt123456'
});

# search by themoviedb id
my $search = $tapi->search({
    search_themoviedb => '123456'
});

# search by tvdb id
my $search = $tapi->search({
    search_tvdb => '123456'
});

DESCRIPTION

Rarbg::torrentapi is a simple wrapper around Rarbg's torrentapi.

ATTRIBUTES

Those attributes can be used on all public methods. In fact you can use them also when creating the object. Some of them make more sense at creation time, some others when calling the method. It's your call.

The only difference is that you should pass them as an anonymous hash if you pass them to a method.

You can find more info about their values at https://torrentapi.org/apidocs_v2.txt

search_string

search_imdb

This is the Imdb id (http://imdb.com) in the form 'tt123456'

search_themoviedb

search_tvdb

category

Category can be quite confusing. It accepts 'tv' and 'movies'. But, for the rest of categories only accepts its id numbers (or a semi-colon separated list of them).

  • XXX (18+) => 4

  • Movies/XVID => 14

  • Movies/XVID/720 => 48

  • Movies/x264 => 17

  • Movies/x264/1080 => 44

  • Movies/x264/720 => 45

  • Movies/x264/3D => 47

  • Movies/x264/4k => 50

  • Movies/x265/4k => 51

  • Movies/x264/4k/HDR => 52

  • Movies/Full BD => 42

  • Movies/BD Remux => 46

  • TV Episodes => 18

  • TV HD Episodes => 41

  • TV UHD Episodes => 49

  • Movies/MP3 => 23

  • Movies/FLAC => 25

  • Games/PC ISO => 27

  • Games/PC RIP => 28

  • Games/PS3 => 40

  • Games/XBOX-360 => 32

  • Software/PC ISO => 33

  • Games/PS4 => 53

limit

It can be 25, 50 or 100.

sort

It can be seeders, leechers or last

min_seeders

min_leechers

ranked

This marks if you want to get all indexed torrents or just the ones from rarbg team. Defaults to all (0).

METHODS

new

Just a simple constructor.

Makes a call to the API in 'search' mode. It returns either a Rarbg::torrentapi::Error or an array of Rarbg::torrentapi::Res.

list

Makes a call to the API in 'list' mode. It returns either a Rarbg::torrentapi::Error or an array of Rarbg::torrentapi::Res.

AUTHORS

Paco Esteban <paco@onna.be> Baptiste C. https://github.com/baptistecdr

COPYRIGHT

Copyright 2015- Paco Esteban

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.