Skip to content

Torrents Search Parameters

The API has endpoints for querying our data in which you can use free text search together with one or more of the filters listed below.

Notes

Free Text: not specifying a field will search on the full records, which can include other information not stated below. Although free text search without specifying fields is available, it might be processed differently from searching on specific fields. For better results, always specify search fields.

Conditionals: the following conditionals are available: NOT, AND, OR. Must be UPPERCASE. You can also use the minus sign (-) as a replacement for the NOT conditional. By default, a sequence of search terms without conditionals will be interpreted as if using the AND conditional.

Comparison: you can use comparison operators on number fields. E.g. field:>100.

Field existence or omission: you can search for records that have a specific field by using _exists_:field. Conversely, for records missing a field it would be NOT _exists_:field.

Wildcards: you can use wildcards on your query terms. However, for the best results and performance, try to be as specific as you can. E.g. field:security*

String fields: if the string is expected to have spaces, some kind of punctuation in the middle, or special symbols, try quoting the search terms, i.e. instead of querying field:value try field:"value". You can also try instead field.keyword:"value". The first one will search for any occurrence of any of the words in value, while the second one will search for an exact match of the string. Finally, in the case of some special symbols, you might require escaping in order to make the query valid.

Regular Expressions: regular expressions are not supported at the moment.

Fields

as_name: (string)

Search by AS name.

e.g. as_name:amazon

asn: (int)

Search by ASN.

e.g. asn:4812

category: (string)

Search by torrent category.

e.g. category:video

country: (string)

Search using ISO2 Country Codes.

e.g. country:ES

created_at: (date)

Search by timestamp.

e.g.
    created_at:[2018-09-01 TO 2018-10-01]
    created_at:2018-09-01

infohash: (string)

Search by torrent infohash.

e.g infohash:d5380fcda66b48fb8b521d5c3b5e61b91c94775e

ip: (string)

Search by IP address or CIDR.

e.g ip:"192.168.1.1/24" or ip:192.168.1.1

geoip.city_name: (string)

Search using city names.

e.g. geoip.city_name:madrid

geoip.country_name: (string)

Search using country names.

e.g. geoip.country_name:spain

port: (int)

Search by port number.

e.g. port:80

rdns: (string)

Search by RDNS.

e.g. rdns:static-206-162-231-219.wireless.unwiredbb.net

rdns_parent: (string)

Search by RDNS root.

e.g. rdns_parent:unwiredbb.net

source: (string)

Search by torrent source.

e.g. source:thepiratebay

subcategory: (string)

Search by torrent subcategory.

e.g. subcategory:tv