16colo.rs v1 API
API endpoint: https://api.16colo.rs/
The API attempts to deliver as much data as possible, however most data can be selected to be in the response or not so the answers can be tailored and optimized for speed.
page
When a list is returned, the results may be paged. With the 'pagesize' parameter the number of rows returned can be adjusted while 'page' allows for selecting a certain page.
page parameters
| name | value(s) | default | description |
|---|---|---|---|
| page | page number | 1 | values smaller than 1 or larger than 'pages' will be ignored |
| pagesize | number from 1 till 500 | 50 |
page return values
| name | value | description |
|---|---|---|
| page | page number | current page number |
| pagesize | current pagesize (1-500) | |
| total | integer | the total number of rows in the current selection |
| offset | integer | the offset where the current page starts |
| sort | alpanumeric | the field which was used to sort the results |
| order | asc/dec | the order of the sort: ascending or descending |
| options | array | array of options affecting data selection |
example response
"page": {
"total": 837,
"sort": "pack",
"order": "asc",
"pagesize": 60,
"page": 1,
"pages": 14,
"offset": 0,
"options": {
"filter": null,
"archive": true,
"groups": true,
"artists": false
}
},
/v1/pack/
Retrieve a list of all packs. Optional filtering on pack name. Other optional switches can provide download link for the archive, group tags and artists tagged within the pack.
parameters
| name | value(s) | default | description |
|---|---|---|---|
| archive | true/false | true | download link for the file archive |
| groups | true/false | true | list tagged groups for this pack |
| artists | true/false | false | list tagged artists in this pack |
example request
curl "https://api.16colo.rs/v1/pack/?pagesize=5&page=3&filter=ice95"
example response
{
"page": {
"total": 19,
"sort": "pack",
"order": "asc",
"pagesize": 5,
"page": 3,
"pages": 4,
"offset": 10,
"options": {
"filter": "ice95",
"archive": true,
"groups": true,
"artists": false
}
},
"results": [
{
"year": 1995,
"name": "ice9509a",
"download": "https:\/\/16colo.rs\/archive\/1995\/ice9509a.zip",
"gallery": "https:\/\/16colo.rs\/pack\/ice9509a",
"archive": "ice9509a.zip",
"groups": [
"ice"
]
},
{
"year": 1995,
"name": "ice9509b",
"download": "https:\/\/16colo.rs\/archive\/1995\/ice9509b.zip",
"gallery": "https:\/\/16colo.rs\/pack\/ice9509b",
"archive": "ice9509b.zip",
"groups": [
"ice"
]
},
{
"year": 1995,
"name": "ice9510a",
"download": "https:\/\/16colo.rs\/archive\/1995\/ice9510a.zip",
"gallery": "https:\/\/16colo.rs\/pack\/ice9510a",
"archive": "ice9510a.zip",
"groups": [
"ice"
]
},
{
"year": 1995,
"name": "ice9510b",
"download": "https:\/\/16colo.rs\/archive\/1995\/ice9510b.zip",
"gallery": "https:\/\/16colo.rs\/pack\/ice9510b",
"archive": "ice9510b.zip",
"groups": [
"ice"
]
},
{
"year": 1995,
"name": "ice9511a",
"download": "https:\/\/16colo.rs\/archive\/1995\/ice9511a.zip",
"gallery": "https:\/\/16colo.rs\/pack\/ice9511a",
"archive": "ice9511a.zip",
"groups": [
"ice"
]
}
]
}
/v1/pack/:name
Retrieve all details of a pack.
parameters
| name | value(s) | default | description |
|---|---|---|---|
| archive | true/false | true | filename of the compressed pack |
| sauce | true/false | false | fetch SAUCE record from file |
| dimensions | true/false | true | fetch image dimensions (where applicable) |
| content | true/false | true | list content tags for each file |
| groups | true/false | false | list tagged groups for each file |
| artists | true/false | false | list tagged artists for each file |
| fileid | true/false | false | include a lost of file_id files per pack |
return values
| name | value(s) | description |
|---|---|---|
| name | name of the artpack | (cleaned) name of the pack, in general this is the filename without the file extension but some characters might have been removed, allowed characters in the packname are [a-z0-9-\.\_]. |
| year | YYYY | release year of the pack |
| archive | true/false | filename of the compressed pack |
| gallery | URL | URL for the 'gallery' page of this pack |
| download | URL | download link for the file archive |
| fileid | filename | the filename considered to be the most prominent FILE_ID.DIZ, in case of multiple files, the extentions priority is ANS, DIZ, ASC |
| fileids | array of filename | filenames of files that could server as a FILE_ID |
example request
curl "https://api.16colo.rs/v1/pack/twi-9703?sauce=true"
example response
{
"page":{
"options":{
"filter":null,
"archive":true,
"sauce":true,
"dimensions":true,
"artists":true,
"content":true,
"groups":false
}
},
"results":[
{
"files":{
"CG-MALP.ANS":{
"file":{
"raw":"CG-MALP.ANS"
},
"artists":[
"coug"
],
"tn":{
"file":"CG-MALP.ANS.png",
"width":160,
"height":84
},
"x1":{
"file":"CG-MALP.ANS.png",
"width":720,
"height":453
},
"x2":{
"file":"CG-MALP.ANS.png",
"width":720,
"height":453
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Malpractice",
"Author":"Coug",
"Group":"Twilight",
"Date":"199703 9",
"Filesize":4315,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":25,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"DD-TREG.ANS":{
"file":{
"raw":"DD-TREG.ANS"
},
"artists":[
"deeply disturbed"
],
"tn":{
"file":"DD-TREG.ANS.png",
"width":160,
"height":980
},
"x1":{
"file":"DD-TREG.ANS.png",
"width":720,
"height":5292
},
"x2":{
"file":"DD-TREG.ANS.png",
"width":720,
"height":5292
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"The Regency",
"Author":"Deeply Disturbed",
"Group":"Twilight",
"Date":19970316,
"Filesize":55062,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":245,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"EN-OLD12.JPG":{
"file":{
"raw":"EN-OLD12.JPG"
},
"tn":{
"file":"EN-OLD12.JPG",
"width":160,
"height":232
},
"x1":{
"file":"EN-OLD12.JPG",
"width":640,
"height":928
}
},
"EQ-R666.ANS":{
"file":{
"raw":"EQ-R666.ANS"
},
"artists":[
"egoteq"
],
"tn":{
"file":"EQ-R666.ANS.png",
"width":160,
"height":1004
},
"x1":{
"file":"EQ-R666.ANS.png",
"width":720,
"height":5421
},
"x2":{
"file":"EQ-R666.ANS.png",
"width":720,
"height":5421
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Route 666",
"Author":"Egoteq",
"Group":"Twilight",
"Date":19970316,
"Filesize":71227,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":251,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"EQ-TWFNT.ANS":{
"file":{
"raw":"EQ-TWFNT.ANS"
},
"artists":[
"egoteq"
],
"tn":{
"file":"EQ-TWFNT.ANS.png",
"width":160,
"height":92
},
"x1":{
"file":"EQ-TWFNT.ANS.png",
"width":720,
"height":496
},
"x2":{
"file":"EQ-TWFNT.ANS.png",
"width":720,
"height":496
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Twilight Promotional",
"Author":"Egoteq",
"Group":"Twilight",
"Date":19970316,
"Filesize":4128,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":23,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ESC!-003.ZIP":{
"file":{
"raw":"ESC!-003.ZIP"
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Escape Net Application",
"Author":"Mutiple Dudes",
"Group":"Twilight",
"Date":19970315,
"Filesize":34589,
"Datatype":7,
"Filetype":0,
"Tinfo1":0,
"Tinfo2":0,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"Comments":""
}
},
"FILE_ID.DIZ":{
"file":{
"raw":"FILE_ID.DIZ"
},
"tn":{
"file":"FILE_ID.DIZ.png",
"width":351,
"height":280
},
"x1":{
"file":"FILE_ID.DIZ.png",
"width":351,
"height":280
},
"x2":{
"file":"FILE_ID.DIZ.png",
"width":351,
"height":280
}
},
"MX-TECH.JPG":{
"file":{
"raw":"MX-TECH.JPG"
},
"artists":[
"malcolm x"
],
"tn":{
"file":"MX-TECH.JPG",
"width":160,
"height":129
},
"x1":{
"file":"MX-TECH.JPG",
"width":592,
"height":478
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Twilight Promotional",
"Author":"Malcolm X",
"Group":"Twilight",
"Date":19970316,
"Filesize":72075,
"Datatype":2,
"Filetype":11,
"Tinfo1":592,
"Tinfo2":478,
"Tinfo3":24,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"Comments":""
}
},
"NWS-0397.EXE":{
"file":{
"raw":"NWS-0397.EXE"
}
},
"NWS-0397.NFO":{
"file":{
"raw":"NWS-0397.NFO"
},
"tn":{
"file":"NWS-0397.NFO.png",
"width":160,
"height":216
},
"x1":{
"file":"NWS-0397.NFO.png",
"width":640,
"height":864
},
"x2":{
"file":"NWS-0397.NFO.png",
"width":1280,
"height":1728
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Distorded 9703 News",
"Author":"Private Parts",
"Group":"Twilight",
"Date":19970316,
"Filesize":3113,
"Datatype":0,
"Filetype":0,
"Tinfo1":0,
"Tinfo2":0,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"Comments":""
}
},
"RA-TWIL.ANS":{
"file":{
"raw":"RA-TWIL.ANS"
},
"artists":[
"reanimator"
],
"tn":{
"file":"RA-TWIL.ANS.png",
"width":160,
"height":304
},
"x1":{
"file":"RA-TWIL.ANS.png",
"width":720,
"height":1641
},
"x2":{
"file":"RA-TWIL.ANS.png",
"width":720,
"height":1641
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Twilight Promotional",
"Author":"Reanimator",
"Group":"Twilight",
"Date":"199703 7",
"Filesize":15339,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":76,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"SG-FC1.ANS":{
"file":{
"raw":"SG-FC1.ANS"
},
"artists":[
"snake grunger"
],
"tn":{
"file":"SG-FC1.ANS.png",
"width":160,
"height":600
},
"x1":{
"file":"SG-FC1.ANS.png",
"width":720,
"height":3240
},
"x2":{
"file":"SG-FC1.ANS.png",
"width":720,
"height":3240
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Free Coke",
"Author":"Snake Grunger",
"Group":"Twilight",
"Date":"199703 6",
"Filesize":30217,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":150,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"SG-LV3.ANS":{
"file":{
"raw":"SG-LV3.ANS"
},
"artists":[
"snake grunger"
],
"tn":{
"file":"SG-LV3.ANS.png",
"width":160,
"height":1012
},
"x1":{
"file":"SG-LV3.ANS.png",
"width":720,
"height":5464
},
"x2":{
"file":"SG-LV3.ANS.png",
"width":720,
"height":5464
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Lethal Vengeance",
"Author":"Snake Grunger",
"Group":"Twilight",
"Date":19970316,
"Filesize":49844,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":253,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"SG-TA1.ANS":{
"file":{
"raw":"SG-TA1.ANS"
},
"artists":[
"snake grunger"
],
"tn":{
"file":"SG-TA1.ANS.png",
"width":160,
"height":92
},
"x1":{
"file":"SG-TA1.ANS.png",
"width":720,
"height":496
},
"x2":{
"file":"SG-TA1.ANS.png",
"width":720,
"height":496
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Thin Air",
"Author":"Snake Grunger",
"Group":"Twilight",
"Date":19970310,
"Filesize":5316,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":25,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"SG-TREG2.ANS":{
"file":{
"raw":"SG-TREG2.ANS"
},
"artists":[
"snake grunger"
],
"tn":{
"file":"SG-TREG2.ANS.png",
"width":160,
"height":96
},
"x1":{
"file":"SG-TREG2.ANS.png",
"width":720,
"height":518
},
"x2":{
"file":"SG-TREG2.ANS.png",
"width":720,
"height":518
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"The Regency",
"Author":"Snake Grunger",
"Group":"Twilight",
"Date":19970222,
"Filesize":5634,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":25,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"STY-ABX.ANS":{
"file":{
"raw":"STY-ABX.ANS"
},
"artists":[
"stygian"
],
"tn":{
"file":"STY-ABX.ANS.png",
"width":160,
"height":536
},
"x1":{
"file":"STY-ABX.ANS.png",
"width":720,
"height":2894
},
"x2":{
"file":"STY-ABX.ANS.png",
"width":720,
"height":2894
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Abraxas",
"Author":"Stygian",
"Group":"Twilight",
"Date":19970316,
"Filesize":24147,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":134,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"UNS-TWI.ANS":{
"file":{
"raw":"UNS-TWI.ANS"
},
"artists":[
"unsane"
],
"tn":{
"file":"UNS-TWI.ANS.png",
"width":160,
"height":80
},
"x1":{
"file":"UNS-TWI.ANS.png",
"width":720,
"height":432
},
"x2":{
"file":"UNS-TWI.ANS.png",
"width":720,
"height":432
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Twilight Promotional",
"Author":"Unsane",
"Group":"Twilight",
"Date":19970315,
"Filesize":1709,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":25,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"US-EI1.ANS":{
"file":{
"raw":"US-EI1.ANS"
},
"tn":{
"file":"US-EI1.ANS.png",
"width":160,
"height":96
},
"x1":{
"file":"US-EI1.ANS.png",
"width":720,
"height":518
},
"x2":{
"file":"US-EI1.ANS.png",
"width":720,
"height":518
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Evil Intentions",
"Author":"Multiple Artists",
"Group":"Twilight",
"Date":19970310,
"Filesize":4180,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":25,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"US-RHH1.ANS":{
"file":{
"raw":"US-RHH1.ANS"
},
"tn":{
"file":"US-RHH1.ANS.png",
"width":160,
"height":112
},
"x1":{
"file":"US-RHH1.ANS.png",
"width":720,
"height":604
},
"x2":{
"file":"US-RHH1.ANS.png",
"width":720,
"height":604
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Reverend Horton Heat",
"Author":"Multiple Artists",
"Group":"Twilight",
"Date":"199703 8",
"Filesize":7041,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":28,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"US-SE.ANS":{
"file":{
"raw":"US-SE.ANS"
},
"tn":{
"file":"US-SE.ANS.png",
"width":160,
"height":472
},
"x1":{
"file":"US-SE.ANS.png",
"width":720,
"height":2548
},
"x2":{
"file":"US-SE.ANS.png",
"width":720,
"height":2548
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Savage Exile",
"Author":"Multiple Artists",
"Group":"Twilight",
"Date":19970315,
"Filesize":23018,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":118,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ZII-IMP.ANS":{
"file":{
"raw":"ZII-IMP.ANS"
},
"artists":[
"zeusii"
],
"tn":{
"file":"ZII-IMP.ANS.png",
"width":160,
"height":496
},
"x1":{
"file":"ZII-IMP.ANS.png",
"width":720,
"height":2678
},
"x2":{
"file":"ZII-IMP.ANS.png",
"width":720,
"height":2678
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Impure",
"Author":"Zeus II",
"Group":"Twilight",
"Date":19970308,
"Filesize":20405,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":124,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ZII-SP3D.ANS":{
"file":{
"raw":"ZII-SP3D.ANS"
},
"artists":[
"zeusii"
],
"tn":{
"file":"ZII-SP3D.ANS.png",
"width":160,
"height":204
},
"x1":{
"file":"ZII-SP3D.ANS.png",
"width":720,
"height":1101
},
"x2":{
"file":"ZII-SP3D.ANS.png",
"width":720,
"height":1101
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Speed Loader",
"Author":"Zeus II",
"Group":"Twilight",
"Date":19970309,
"Filesize":12136,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":51,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ZII-TCO2.ANS":{
"file":{
"raw":"ZII-TCO2.ANS"
},
"artists":[
"zeusii"
],
"tn":{
"file":"ZII-TCO2.ANS.png",
"width":160,
"height":84
},
"x1":{
"file":"ZII-TCO2.ANS.png",
"width":720,
"height":453
},
"x2":{
"file":"ZII-TCO2.ANS.png",
"width":720,
"height":453
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Tycoon",
"Author":"Zeus II",
"Group":"Twilight",
"Date":19970313,
"Filesize":2930,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":21,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ZK-FC.ANS":{
"file":{
"raw":"ZK-FC.ANS"
},
"tn":{
"file":"ZK-FC.ANS.png",
"width":160,
"height":540
},
"x1":{
"file":"ZK-FC.ANS.png",
"width":720,
"height":2916
},
"x2":{
"file":"ZK-FC.ANS.png",
"width":720,
"height":2916
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Free Coke",
"Author":"zaerkon",
"Group":"Twilight",
"Date":19970316,
"Filesize":26592,
"Datatype":1,
"Filetype":1,
"Tinfo1":80,
"Tinfo2":135,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"ZK-OLDSC.BIN":{
"file":{
"raw":"ZK-OLDSC.BIN"
},
"tn":{
"file":"ZK-OLDSC.BIN.png",
"width":320,
"height":424
},
"x1":{
"file":"ZK-OLDSC.BIN.png",
"width":1440,
"height":2289
},
"x2":{
"file":"ZK-OLDSC.BIN.png",
"width":1440,
"height":2289
},
"sauce":{
"Id":"SAUCE",
"Version":0,
"Title":"Old School",
"Author":"zaerkon",
"Group":"Twilight",
"Date":19970316,
"Filesize":33920,
"Datatype":5,
"Filetype":80,
"Tinfo1":0,
"Tinfo2":0,
"Tinfo3":0,
"Tinfo4":0,
"Tflags":0,
"Tinfos":"",
"f":{
"ice":0,
"blink":0,
"ls":0,
"ar":0
},
"Comments":""
}
},
"\u00b7ANSI\u00b7.\u00b7\u00b7\u00b7":{
"file":{
"raw":"\u00b7ANSI\u00b7.\u00b7\u00b7\u00b7"
},
"tn":{
"file":"\u00b7ANSI\u00b7.\u00b7\u00b7\u00b7.png",
"width":160,
"height":4
},
"x1":{
"file":"\u00b7ANSI\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
},
"x2":{
"file":"\u00b7ANSI\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
}
},
"\u00b7MISC\u00b7.\u00b7\u00b7\u00b7":{
"file":{
"raw":"\u00b7MISC\u00b7.\u00b7\u00b7\u00b7"
},
"tn":{
"file":"\u00b7MISC\u00b7.\u00b7\u00b7\u00b7.png",
"width":160,
"height":4
},
"x1":{
"file":"\u00b7MISC\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
},
"x2":{
"file":"\u00b7MISC\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
}
},
"\u00b7PUB\u00b7\u00b7.\u00b7\u00b7\u00b7":{
"file":{
"raw":"\u00b7PUB\u00b7\u00b7.\u00b7\u00b7\u00b7"
},
"tn":{
"file":"\u00b7PUB\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":160,
"height":4
},
"x1":{
"file":"\u00b7PUB\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
},
"x2":{
"file":"\u00b7PUB\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
}
},
"\u00b7VGA\u00b7\u00b7.\u00b7\u00b7\u00b7":{
"file":{
"raw":"\u00b7VGA\u00b7\u00b7.\u00b7\u00b7\u00b7"
},
"tn":{
"file":"\u00b7VGA\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":160,
"height":4
},
"x1":{
"file":"\u00b7VGA\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
},
"x2":{
"file":"\u00b7VGA\u00b7\u00b7.\u00b7\u00b7\u00b7.png",
"width":720,
"height":21
}
}
},
"fileid":"FILE_ID.DIZ",
"fileids":[
"FILE_ID.DIZ"
],
"archive":"twi-9703.zip"
}
]
}
/v1/year/
Retrieve a list of the amount of packs and magazines in the archive by year
parameters
no parameters, no pagination
example request
curl "https://api.16colo.rs/v1/year/"
example response
{
"1990": {
"packs": 3,
"mags": 2
},
"1991": {
"packs": 6,
"mags": 29
},
"1992": {
"packs": 43,
"mags": 18
},
"1993": {
"packs": 224,
"mags": 27
},
"1994": {
"packs": 589,
"mags": 61
},
"1995": {
"packs": 663,
"mags": 115
},
"1996": {
"packs": 837,
"mags": 203
},
"1997": {
"packs": 868,
"mags": 114
},
"1998": {
"packs": 680,
"mags": 113
},
"1999": {
"packs": 500,
"mags": 106
},
"2000": {
"packs": 254,
"mags": 51
},
"2001": {
"packs": 195,
"mags": 18
},
"2002": {
"packs": 185,
"mags": 22
},
"2003": {
"packs": 140,
"mags": 33
},
"2004": {
"packs": 106,
"mags": 0
},
"2005": {
"packs": 45,
"mags": 0
},
"2006": {
"packs": 15,
"mags": 0
},
"2007": {
"packs": 6,
"mags": 0
},
"2008": {
"packs": 8,
"mags": 0
},
"2009": {
"packs": 4,
"mags": 0
},
"2010": {
"packs": 4,
"mags": 0
},
"2011": {
"packs": 5,
"mags": 0
},
"2012": {
"packs": 2,
"mags": 0
},
"2013": {
"packs": 10,
"mags": 0
},
"2014": {
"packs": 21,
"mags": 0
},
"2015": {
"packs": 24,
"mags": 0
},
"2016": {
"packs": 22,
"mags": 0
},
"2017": {
"packs": 43,
"mags": 0
},
"2018": {
"packs": 38,
"mags": 3
},
"2019": {
"packs": 14,
"mags": 2
}
}
/v1/year/:year
Retrieve a list of packs or mags for a given year
parameters
| name | value(s) | default | description |
|---|---|---|---|
| sort | pack | pack | sort by pack name |
| type | packs/mags | packs | |
| groups | true/false | true | include list of groups tags for this pack/mag (usually only 1) |
return values
| name | value(s) | description |
|---|---|---|
example request
curl "https://api.16colo.rs/v1/year/1996?groups=true&filter=acdu&pagesize=5"
example response
{
"page":{
"total":8,
"sort":"pack",
"order":"asc",
"pagesize":5,
"page":1,
"pages":2,
"offset":0,
"options":{
"filter":"acdu",
"type":"packs",
"groups":true
}
},
"results":[
{
"year":1996,
"name":"acdu0196",
"download":"https:\/\/16colo.rs\/archive\/1996\/acdu0196.zip",
"gallery":"https:\/\/16colo.rs\/pack\/acdu0196",
"archive":"acdu0196.zip",
"groups":[
"acid"
]
},
{
"year":1996,
"name":"acdu0396",
"download":"https:\/\/16colo.rs\/archive\/1996\/acdu0396.zip",
"gallery":"https:\/\/16colo.rs\/pack\/acdu0396",
"archive":"acdu0396.zip",
"groups":[
"acid"
]
},
{
"year":1996,
"name":"acdu0496",
"download":"https:\/\/16colo.rs\/archive\/1996\/acdu0496.zip",
"gallery":"https:\/\/16colo.rs\/pack\/acdu0496",
"archive":"acdu0496.zip",
"groups":[
"acid"
]
},
{
"year":1996,
"name":"acdu0596",
"download":"https:\/\/16colo.rs\/archive\/1996\/acdu0596.zip",
"gallery":"https:\/\/16colo.rs\/pack\/acdu0596",
"archive":"acdu0596.zip",
"groups":[
"acid"
]
},
{
"year":1996,
"name":"acdu0696",
"download":"https:\/\/16colo.rs\/archive\/1996\/acdu0696.zip",
"gallery":"https:\/\/16colo.rs\/pack\/acdu0696",
"archive":"acdu0696.zip",
"groups":[
"acid"
]
}
]
}
/v1/group
Retrieve a list of groups and their release count. Optionally linked packs and artists are available.
parameters
| name | value(s) | default | description |
|---|---|---|---|
| sort | name/packs | name | sort by group name or pack count |
| artists | true/false | false | list tagged artists in packs of this group |
| packs | true/false | false | list packs of this group (grouped by year) |
return values
| name | value(s) | description |
|---|---|---|
| releases | number | the number of releases attributed to this group |
| packs | array of packnames | a list of packs released by this group |
| artists | array of names | a list of artists linked to this group |
example request
curl "https://api.16colo.rs/v1/group/?pagesize=10&sort=packs&order=desc&filter=legion&packs=true&artists=true"
example response
{
"page":{
"total":2,
"sort":"packs",
"order":"desc",
"pagesize":10,
"page":1,
"pages":1,
"offset":0,
"options":{
"filter":"legion",
"packs":true,
"artists":true
}
},
"results":[
{
"the legion":{
"releases":7,
"packs":{
"1998":[
"legion01",
"legion02",
"legion03",
"legion04",
"legion05",
"legion06",
"legion07"
]
},
"artists":[
"acid or heroin",
"angel of hell",
"dieznyik",
"eerie",
"fever",
"filth",
"haji",
"kitiara",
"kleenex",
"konami",
"lord drakul",
"lord jazz",
"maestro",
"milkmang",
"nail",
"reanimator",
"riddler",
"silver rat",
"snake grunger",
"sultan",
"the knight",
"trip",
"zeusii"
]
}
}
}
}
/v1/group/:name
Retrieve details about a group
parameters
| name | value(s) | default | description |
|---|---|---|---|
| packs | true/false | false | list packs of this group (grouped by year) |
| artist-releases | true/false | false | number of releases by this artist in this groups |
| artist-years | true/false | false | years active in this group |
| artist-packs | true/false | false | packs in which this artist has released |
return values
| name | value(s) | description |
|---|---|---|
| releases | ||
| longname | ||
| description | ||
| logo | ||
| web | ||
| wiki | ||
| fb | ||
| ig | ||
| demozoo |
example request
curl "https://api.16colo.rs/v1/group/legend?artist-items=true&packs=true&artist-years=true&artist-packs=true"
example response
{
"page":{
"total":3,
"sort":"packs",
"order":"desc",
"pagesize":10,
"page":1,
"pages":1,
"offset":0,
"options":{
"filter":"legion",
"packs":true,
"artists":true
}
},
"results":[
{
"the legion":{
"releases":7,
"longname":"The Legion",
"logo":"\/pack\/legion04\/x1\/MAE-SUX1.ANS.png",
"twitter":"https:\/\/twitter.com\/thelegionlegacy",
"packs":{
"1998":[
"legion01",
"legion02",
"legion03",
"legion04",
"legion05",
"legion06",
"legion07"
]
},
"artists":[
"acid or heroin",
"angel of hell",
"aoh",
"big yellow man",
"bizzarro",
"cthulu",
"dieznyik",
"eerie",
"fever",
"filth",
"haji",
"kitiara",
"kleenex",
"konami",
"lord drakul",
"lord jazz",
"maestro",
"milkmang",
"nail",
"reanimator",
"riddler",
"silver rat",
"snake grunger",
"sq2",
"sultan",
"taintedx",
"the knight",
"trip",
"zeus ii"
]
}
},
{
"alien legion":{
"releases":1,
"packs":{
"1994":[
"ale-0894"
]
},
"artists":[
"mage"
]
}
},
{
"legion":{
"releases":0,
"packs":{
"":[
null
]
},
"artists":[
]
}
}
]
}
/v1/artist/
Retrieve a list of artists
parameters
| name | value(s) | default | description |
|---|---|---|---|
| details | true/false | true | include details such as packs and groups linked to this artist and years active |
| aliases | true/false | false | retrieve all aliases (alter egos) for this artist |
return values
| name | value(s) | description |
|---|---|---|
| releases |
example request
curl "https://api.16colo.rs/v1/artist/?details=true&filter=misfit&aliases=true"
example response
{
"page":{
"total":1,
"sort":"name",
"order":"asc",
"pagesize":50,
"page":1,
"pages":1,
"offset":0,
"options":{
"filter":"misfit",
"details":true,
"aliases":true
}
},
"results":[
{
"artist":{
"groups":[
"amish",
"apathy",
"blocktronics",
"devious",
"fuel",
"glue",
"ice",
"mistigris",
"mop",
"saga",
"samsara",
"trank",
"union",
"vagina"
],
"packs":[
"amish-0717",
"amish-rumspringa",
"apathy01",
"apathy02",
"apathy03",
"apathy04",
"apathy05",
"apathy06",
"apathy07",
"apathy08",
"apathy09",
"apathy10",
"apathy11",
"apathy12",
"apathy13",
"apathy14",
"apathy15",
"blocktronics-2019-calendar",
"blocktronics-420",
"blocktronics-6710",
"blocktronics-67rpm",
"blocktronics-b-movies",
"blocktronics-b-sides",
"blocktronics_1010",
"blocktronics_16colors",
"blocktronics_1980",
"blocktronics_acid_trip",
"blocktronics_ansi_love",
"blocktronics_baud_dudes",
"blocktronics_block_n_roll",
"blocktronics_block_to_the_future",
"blocktronics_blocktober",
"blocktronics_darker-image-2",
"blocktronics_detention_block_aa-23",
"blocktronics_miracle_on_67th_street",
"blocktronics_space_invaders",
"blocktronics_there_will_be_blocks",
"blocktronics_wtf4",
"blocktronics_yotb",
"dvs-0395",
"fuel21",
"glue-36",
"ice0010a",
"ice9512a",
"ice9602a",
"ice9606a",
"ice9612a",
"ice9703a",
"ice9705a",
"ice9904a",
"ice9905a",
"ice9907a",
"mist0418",
"mop-9509",
"saga9510",
"saga9511",
"sms-9610",
"trank-07",
"uni-0995",
"vagina01",
"vagina03"
],
"years":[
1995,
1996,
1997,
1999,
2000,
2001,
2013,
2014,
2015,
2016,
2017,
2018,
2019
],
"name":"misfit",
"releases":235
}
}
]
}
/v1/artist/:name
Retrieve a list of artists
parameters
| name | value(s) | default | description |
|---|---|---|---|
| view | artpack/artwork | artpack | structure output by artpack or by artwork |
return values
| name | value(s) | description |
|---|---|---|
| file | filename | filename as it appears in the artpack |
| raw | URL | URL for the 'raw' file as it appears in the artpack |
| release | release date | release date in YYYY-MM format (only in artwork view) |
| gallery | URL | URL for the 'gallery' page for this file |
| thumbnail | URL | thumbnail image (width: 160 px) |
example request
curl "https://api.16colo.rs/v1/artist/jed"
example response
/v1/latest/releases
Retrieve a list of the latest releases (20 packs)
parameters
nonereturn values
| name | value(s) | description |
|---|---|---|
| name | name of the artpack | (cleaned) name of the pack, in general this is the filename without the file extension but some characters might have been removed, allowed characters in the packname are [a-z0-9-\.\_]. |
| archive | true/false | filename of the compressed pack |
| upload-date | ISO 8601 date | date and time the pack was uploaded to the archive |
| group-tag | group tag(s) | comma seperated list of tagged group(s) for this pack |
| group-tag | group name(s) | comma seperated list of tagged long groupname(s) for this pack |
| year | integer | the year the pack was released in YYYY format |
| gallery | URL | URL for the 'gallery' page of this pack |
| download | URL | download link for the file archive |
| fileid | filename | the filename considered to be the most prominent FILE_ID.DIZ, in case of multiple files, the extentions priority is ANS, DIZ, ASC |
| fileids | array of filenames | filenames of files that could server as a FILE_ID |
example request
curl "https://api.16colo.rs/v1/latest/releases"
example response
this example has been truncated to 3 items.
{
"results":[
{
"pack":"mist0521",
"archive":"mist0521.zip",
"year":2021,
"upload-date":"2021-05-04T16:24:13+02:00",
"group-tag":"mistigris",
"group-name":"Mistigris",
"gallery":"https:\/\/16colo.rs\/pack\/mist0521",
"download":"https:\/\/16colo.rs\/archive\/2021\/mist0521.zip",
"fileid":"FILE_ID.ANS",
"fileids":[
"FILE_ID.ANS",
"FILE_ID.DIZ"
]
},
{
"pack":"impure79",
"archive":"impure79.zip",
"year":2021,
"upload-date":"2021-04-25T22:32:30+02:00",
"group-tag":"impure",
"group-name":"Impure!ASCII 1940",
"gallery":"https:\/\/16colo.rs\/pack\/impure79",
"download":"https:\/\/16colo.rs\/archive\/2021\/impure79.zip",
"fileid":"FILE_ID.ANS",
"fileids":[
"FILE_ID.DIZ"
]
},
{
"pack":"blndr2021b",
"archive":"blndr2021b.zip",
"year":2021,
"upload-date":"2021-04-20T00:11:16+02:00",
"group-tag":"blender",
"group-name":"The Blender",
"gallery":"https:\/\/16colo.rs\/pack\/blndr2021b",
"download":"https:\/\/16colo.rs\/archive\/2021\/blndr2021b.zip",
"fileid":"FILE_ID.ANS",
"fileids":[
"FILE_ID.DIZ"
]
}
]
}
/v1/paste
Upload a file and retrieve a sharing link
parameters
| name | value(s) | default | description |
|---|---|---|---|
| key | alphanumeric string | n/a | API keys for public write operations |
| file | base64 encoded file (POST parameter) | n/a | a PNG, ANS, ASC, XBIN, BIN, ADF or RIP file, base64 encoded |
| extension | file extension | ANS | file extension matching the filetype: PNG, ANS, ASC, XBIN, BIN, ADF or RIP |
| retention | 86400 | retention time in seconds | |
| filename | filename | n/a | optional: original filename |
return values
| name | value(s) | description |
|---|---|---|
| warnings | array of warnings | non fatal warning messages |
| errors | array of errors | fatal error messages |
| id | alpanumeric string | unique id for this paste |
| filename | alphanumeric filename with extension | filename for the 'raw' file |
| extension | alphanumeric file extensions | |
| gallery | URL | URL for the 'gallery' page for this file |
| x1 | URL | 1X image |
| thumbnail | URL | thumbnail image (width: 160 px) |
example request
curl -X POST --data "file=G1swOzE7NDA7MzJtIBtbMzFtMTYbWzMybWNvG1szM21sbxtbMzFtLhtbMzRtcnMNCg==" "https://api.16colo.rs/v1/paste?key=abc123&extension=ans&retention=86400"
example response
{
"results":{
"errors":[
],
"warnings":[
],
"id": "56d0de12",
"filename": "56d0de12.ans",
"extension": "ans",
"thumbnail": "https:\/\/16colo.rs\/paste\/tn\/56d0de12.ans.png",
"x1": "https:\/\/16colo.rs\/paste\/x1\/56d0de12.ans.png",
"gallery": "https:\/\/16colo.rs\/paste\/56d0de12"
}