Torrents¶
Endpoints related to torrents.
Torrent¶
Request
api.php?action=torrent
&id= — torrent’s id (required)
&hash= — torrent’s hash (must be uppercase)
Response
{
"status": "success",
"response": {
"group": {
"description": "HTML",
"picture": "https://i.imgur.com/sF40cxi.png",
"id": 1,
"name": "Alcohol dehydrogenase ADH1",
"organism": "Saccharomyces cerevisiae",
"strain": "S288C",
"authors": [
{
"id": 2,
"name": "David Schild"
},
{
"id": 1,
"name": "Robert K. Mortimer"
}
],
"year": 1985,
"accession": "YOL086C",
"categoryId": 1,
"categoryName": "Sequences",
"time": "2019-12-10 01:48:07",
"isBookmarked": false,
"tags": [
"coding",
"fungi",
"one.shot",
"organic.chemistry",
"protocol.available"
]
},
"torrent": {
"id": 1,
"infoHash": "6A5413B9A0C5EF5B68BED6ABBB8112CBE3870647",
"platform": "Sanger",
"format": "FASTA",
"license": "Public Domain",
"scope": "Contig",
"annotated": false,
"archive": "None",
"fileCount": 4,
"size": 5754,
"seeders": 5,
"leechers": 0,
"snatched": 3,
"freeTorrent": false,
"reported": false,
"time": "2019-12-10 01:48:08",
"description": "HTML",
"fileList": "S288C_YOL086C_ADH1_coding.fsa{{{1095}}}|||S288C_YOL086C_ADH1_flanking.fsa{{{3157}}}|||S288C_YOL086C_ADH1_genomic.fsa{{{1117}}}|||S288C_YOL086C_ADH1_protein.fsa{{{385}}}",
"filePath": "ADH1 - YOL086C",
"userId": 0,
"username": "Anonymous"
}
}
}
Torrent group¶
Request
api.php?action=torrentgroup
&id= — torrent’s group id (required)
&hash= — hash of a torrent in the torrent group (must be uppercase)
Response
{
"status": "success",
"response": {
"group": {
"description": "HTML",
"picture": "https://i.imgur.com/SVFU8bC.jpg",
"id": 37,
"name": "RSNA Pneumonia Detection Challenge",
"organism": "",
"strain": "",
"authors": [
{
"id": 93,
"name": "Radiological Society of North America"
}
],
"year": 2020,
"accession": "",
"categoryId": 8,
"categoryName": "Images",
"time": "2020-04-23 05:48:14",
"isBookmarked": true,
"tags": [
"data.science",
"epidemiology",
"grayscale",
"humans",
"machine.learning",
"nurse.practitioner",
"public.health"
]
},
"torrents": [
{
"id": 46,
"infoHash": "76E026CAA529CED7ECEE99A74E2C060DDEC01F22",
"platform": "X-Rays",
"format": "DICOM",
"license": "Unspecified",
"scope": "Whole Genome",
"annotated": true,
"archive": "ZIP",
"fileCount": 4,
"size": 3934053123,
"seeders": 4,
"leechers": 0,
"snatched": 3,
"freeTorrent": false,
"reported": false,
"time": "2020-04-23 05:44:51",
"description": "Mirror of http://academictorrents.com/details/a0d80e1bb03ef8357d71e058ef9471b4468cd18e",
"fileList": "stage_2_detailed_class_info.csv{{{1647396}}}|||stage_2_test_images.dcm.zip{{{395756780}}}|||stage_2_train_images.dcm.zip{{{3535158913}}}|||stage_2_train_labels.csv{{{1490034}}}",
"filePath": "RSNA Pneumonia Detection Challenge - DICOM",
"userId": 0,
"username": "Anonymous"
},
{
"id": 47,
"infoHash": "EFAB8510ED24FC5953AD00993FB62FDDE0013D1D",
# etc.
},
# etc.
]
}
}
Browse (search)¶
Note that BioTorrents.de still uses Oppaitime metadata behind the scenes. These docs are also adapted from What.CD, an older and different distribution. The advanced search options are certain to change in the future.
Request
api.php?action=browse
&searchstr= — string to search for
&page= — page to display (default: 1)
taglist, tags_type, order_by, order_way, filter_cat, freetorrent, vanityhouse, scene, haslog, releasetype, media, format, encoding, artistname, filelist, groupname, recordlabel, cataloguenumber, year, remastertitle, remasteryear, remasterrecordlabel, remastercataloguenumber — as in advanced search
Response
{
"status": "success",
"response": {
"currentPage": 1,
"pages": 1,
"results": [
{
"groupId": 57,
"groupName": "Massachusetts 1:5,000 Color Ortho Imagery",
"author": "Production Sanborn LLC",
"picture": "",
"tags": [
"data.science",
"one.shot",
"true.color",
"massachusetts",
"geography"
],
"bookmarked": true,
"groupYear": 2005,
"groupTime": 1605710633,
"accession": "",
"lab": "MassGIS",
"location": "",
"maxSize": 24759011328,
"totalSnatched": 0,
"totalSeeders": 2,
"totalLeechers": 0,
"torrents": [
{
"torrentId": 67,
"authors": [
{
"id": 152,
"name": "Production Sanborn LLC"
}
],
"platform": "Other",
"format": "JPEG 2000",
"license": "Unspecified",
"scope": "Whole Genome",
"annotated": 0,
"archive": "ZIP",
"fileCount": 1555,
"time": "2020-11-18 15:43:53",
"size": 24759011328,
"snatches": 0,
"seeders": 2,
"leechers": 0,
"isFreeleech": false,
"isNeutralLeech": true,
"isPersonalFreeleech": false,
"canUseToken": false,
"hasSnatched": false
}
]
},
{
"groupId": 52,
"groupName": "Massachusetts 1:10,000 Coastal Color Orthophoto Images",
"author": "NOAA Photogrammetry Division, National Geodetic Survey, Massachusetts Coastal Zone Management Office",
"picture": "",
# etc.
},
# etc.
]
}
}
Comments¶
Fetch comments from torrent pages.
Request
api.php?action=tcomments
&id= — torrent’s id (required)
Response
{
"status": "success",
"response": {
"page": 1,
"pages": 1,
"comments": [
{
"postId": 2,
"addedTime": "2020-01-16 05:31:08",
"bbBody": "Thanks!",
"body": "Thanks!",
"editedUserId": 0,
"editedTime": "",
"editedUsername": "",
"userinfo": {
"authorId": 2,
"authorName": "me",
"artist": false,
"donor": false,
"warned": false,
"avatar": "https://i.imgur.com/OdSSWrw.png",
"enabled": true,
"userTitle": null
},
# etc.
}
]
}
}
Torrent features¶
Various features around the torrents themselves.
Collage¶
Request
api.php?action=collage
&id= — collage’s id (required)
Response
{
"status": "success",
"response": {
"id": 3,
"name": "Kratom Genome Project",
"description": "HTML",
"creatorID": 2,
"deleted": false,
"collageCategoryID": 1,
"collageCategoryName": "Theme",
"locked": false,
"maxGroups": 0,
"maxGroupsPerUser": 0,
"hasBookmarked": false,
"subscriberCount": 0,
"torrentGroupIDList": [
7,
8,
9,
10
],
"torrentgroups": [
{
"id": 7,
"name": "Final peer review",
"year": 2017,
"categoryId": 11,
"accession": "",
"vanityHouse": null,
"tagList": "plants drug_discovery genomics organic_chemistry one_shot next_gen",
"picture": "https://i.imgur.com/19Jjdtn.jpg",
"torrents": [
{
"torrentid": 7,
"platform": "Literature",
"fileCount": 6,
"size": 488699,
"seeders": 5,
"leechers": 0,
"snatched": 4,
"freeTorrent": false,
"reported": false,
"time": "2019-12-10 04:18:54"
}
]
},
{
"id": 8,
"name": "DNA batch 1",
# etc.
},
# etc.
]
}
}
Artist¶
Under construction as of 2020-11-24. Currently not returning the artist’s torrent groups. Please see the response below for details.
Request
api.php?action=artist
&id= — artist’s id (required)
&artistname= — artist’s name
&artistreleases= — if set, only include groups where the artist is the main artist
Response
{
"status": "success",
"response": {
"id": 94,
"name": "Jackie Treehorn",
"notificationsEnabled": false,
"hasBookmarked": false,
"image": "",
"body": "",
"vanityHouse": false,
"tags": [],
"statistics": {
"numGroups": 0,
"numTorrents": 0,
"numSeeders": 0,
"numLeechers": 0,
"numSnatches": 0
},
"torrentgroup": [],
"requests": []
}
}
Request¶
Request
api.php?action=request
&id= — request id (required)
&page= — page of the comments to display (default: last page)
Response
{
"status": "success",
"response": {
"requestId": 2,
"requestorId": 2,
"requestorName": "me",
"isBookmarked": false,
"requestTax": 0.1,
"timeAdded": "2020-04-23 02:02:37",
"canEdit": true,
"canVote": true,
"minimumVote": 20971520,
"voteCount": 1,
"lastVote": "2020-11-15 06:51:56",
"topContributors": [
{
"userId": 2,
"userName": "me",
"bounty": 15461882266
}
],
"totalBounty": 15461882266,
"categoryId": 10,
"categoryName": "Models",
"title": "Markov State Model Database of Protein Folding Datasets",
"year": 0,
"image": "",
"bbDescription": "BBcode",
"description": "HTML",
"artists": [
{
"id": 88,
"name": "Thomas Lane"
}
],
"isFilled": false,
"fillerId": 0,
"fillerName": "",
"torrentId": 0,
"timeFilled": "",
"tags": [
"coding",
"proteomics",
"biochemistry",
"data.science",
"gene.expression"
],
"comments": [],
"commentPage": 1,
"commentPages": 0
}
}
Request search¶
If no arguments are specified then the most recent requests are shown.
Request
api.php?action=requests
&page= — page to display (default: 1)
&search= — search term
&show_filled= — include filled requests in results true or false (default: false)
&tag= — tags to search by (comma separated)
&tags_type= — 0 for any, 1 for match all
filter_cat[], releases[], bitrates[], formats[], media[] — as used on requests.php
Response
{
"status": "success",
"response": {
"currentPage": 1,
"pages": 1,
"results": [
{
"requestId": 3,
"requestorId": 2,
"requestorName": "me",
"timeAdded": "2020-11-15 06:49:10",
"lastVote": "2020-11-15 06:49:27",
"voteCount": 1,
"bounty": 7825312768,
"categoryId": 8,
"categoryName": "Images",
"authors": [
{
"id": 148,
"name": "Oliver Batchelor"
}
],
"title": "trees.tar.gz",
"year": 0,
"picture": "",
"description": "BBcode",
"isFilled": false,
"fillerId": 0,
"fillerName": "",
"torrentId": 0,
"timeFilled": ""
},
{
"requestId": 2,
"requestorId": 2,
# etc.
},
# etc.
]
}
}
Top 10¶
Fetch the Top 10 torrents, tags, or users.
Torrents¶
Request
api.php?action=top10
&limit= — one of 10, 100, 250 (default: 10)
&type= — one of: torrents, tags, users (default: torrents)
Response
{
"status": "success",
"response": [
{
"caption": "Most Active Torrents Uploaded in the Past Day",
"tag": "day",
"limit": 10,
"results": [
{
"torrentId": 67,
"groupId": 57,
"author": "Production Sanborn LLC",
"groupName": "Massachusetts 1:5,000 Color Ortho Imagery",
"groupCategory": 9,
"groupYear": 2005,
"platform": "Other",
"tags": [
"data.science",
"one.shot",
"true.color",
"massachusetts",
"geography"
],
"snatched": 0,
"seeders": 2,
"leechers": 0,
"data": 0,
"size": 24759011328,
"picture": ""
},
{
"torrentId": 18,
"groupId": 18,
# etc.
},
# etc.
]
},
{
"caption": "Most Active Torrents Uploaded in the Past Week",
"tag": "week",
"limit": 10,
"results": [
{
"torrentId": 30,
"groupId": 15,
# etc.
},
{
"torrentId": 32,
"groupId": 27,
# etc.
},
# etc.
]
},
{
"caption": "Most Active Torrents of All Time",
"tag": "overall",
"limit": 10,
"results": [
{
"torrentId": 1,
"groupId": 1,
# etc.
},
{
"torrentId": 25,
"groupId": 25,
# etc.
},
# etc.
]
},
{
"caption": "Most Snatched Torrents",
"tag": "snatched",
"limit": 10,
"results": [
{
"torrentId": 40,
"groupId": 32,
# etc.
},
{
"torrentId": 43,
"groupId": 34,
# etc.
},
# etc.
]
},
{
"caption": "Most Data Transferred Torrents",
"tag": "data",
"limit": 10,
"results": [
{
"torrentId": 28,
"groupId": 17,
# etc.
},
{
"torrentId": 10,
"groupId": 10,
# etc.
},
# etc.
]
},
{
"caption": "Best Seeded Torrents",
"tag": "seeded",
"limit": 10,
"results": [
{
"torrentId": 50,
"groupId": 40,
# etc.
},
{
"torrentId": 48,
"groupId": 38,
# etc.
},
# etc.
]
}
]
}
Tags¶
{
"status": "success",
"response": [
{
"caption": "Most Used Torrent Tags",
"tag": "ut",
"limit": 10,
"results": [
{
"name": "one.shot",
"uses": 24
},
{
"name": "humans",
"uses": 22
},
{
"name": "data.science",
"uses": 20
},
# etc.
]
},
{
"caption": "Most Used Request Tags",
"tag": "ur",
"limit": 10,
"results": [
{
"name": "coding",
"uses": 2
},
{
"name": "biochemistry",
"uses": 2
},
{
"name": "plants",
"uses": 1
},
# etc.
]
}
]
}
Users¶
Usernames are masked to null in the output unless you have moderator permissions.
{
"status": "success",
"response": [
{
"caption": "Uploaders",
"tag": "ul",
"limit": 10,
"results": [
{
"id": 28,
"username": "seedbox",
"uploaded": 100918879562,
"upSpeed": 4893.906,
"downloaded": 12327881516,
"downSpeed": 600.9437,
"numUploads": 0,
"joinDate": "2020-04-01 15:50:04"
},
# etc.
]
},
{
"caption": "Downloaders",
"tag": "dl",
"limit": 10,
"results": [
{
"id": 28,
"username": "seedbox",
# etc.
},
# etc.
]
},
{
"caption": "Torrents Uploaded",
"tag": "numul",
"limit": 10,
"results": [
{
"id": 28,
"username": "seedbox",
# etc.
},
# etc.
]
},
{
"caption": "Fastest Uploaders",
"tag": "uls",
"limit": 10,
"results": [
{
"id": 28,
"username": "seedbox",
# etc.
},
# etc.
]
},
{
"caption": "Fastest Downloaders",
"tag": "dls",
"limit": 10,
"results": [
{
"id": 28,
"username": "seedbox",
# etc.
},
# etc.
]
}
]
}