sug.rocks API
You can use our API to get the recent /sug/ threads, OP template, and downloads !
Responses in this documentation are examples.
Rate-limits
Currently, we’re not rate-limiting requests, but note that it might be introduced if we notice some clients hammering our servers. Please be responsible and try to wait 2 minutes in between requests.
/sug/ ¶
Everything related to /co/sug/ and /trash/sug/.
Threads ¶
Get TheadsGET/threads.json
This endpoint retrieves all threads.
Example URI
200In this example, the first thread is already dead (404), so you should link to the archive instead of the url. The second example did reach the bump limit but is still available.
Headers
Content-Type: application/jsonBody
{
"_": {
"generated": 1501593002
},
"co": {},
"trash": {
"10771362": {
"archive": "https://desuarchive.org/trash/thread/10771362",
"board": "trash",
"dates": {
"RFC822": "Tue, 1 Aug 2017 03:59:29Z",
"ISO8601": "2017-08-01T03:59:29Z",
"string": "08/01/17(Tue)03:59:29(UTC)",
"timestamp": 1501559969
},
"edition": "Meekface Edition",
"id": 10771362,
"media": {
"deleted": false,
"height": 1449,
"name": "1491774395468.png",
"spoiler": false,
"url": "http://i.4cdn.org/trash/1501559969868.png",
"width": 1280
},
"op": "/sug/ - Steven Universe General<br><br>Meekface Edition<br><br>Last Thread: [snip]",
"page": "0",
"status": {
"archived": false,
"bump_limit": true,
"closed": true,
"dead": true,
"image_limit": false
},
"url": "http://boards.4chan.org/trash/thread/10771362"
},
"10775044": {
"archive": "https://desuarchive.org/trash/thread/10775044",
"board": "trash",
"dates": {
"RFC822": "Tue, 1 Aug 2017 07:59:11Z",
"ISO8601": "2017-08-01T07:59:11Z",
"string": "08/01/17(Tue)07:59:11(UTC)",
"timestamp": 1501574351
},
"edition": "Mustard Edition",
"id": 10775044,
"media": {
"deleted": false,
"height": 630,
"name": "NOOOOOOOOOOOOOO MI MUSTARD.png",
"spoiler": false,
"url": "http://i.4cdn.org/trash/1501574351807.png",
"width": 600
},
"op": "/sug/ - Steven Universe General<br><br>Mustard Edition<br><br>Last Thread: [snip]",
"page": 11,
"status": {
"archived": false,
"bump_limit": true,
"closed": false,
"dead": false,
"image_limit": false
},
"url": "http://boards.4chan.org/trash/thread/10775044"
}
}
}OP Template ¶
Get OPGET/op.json
This endpoint retrieves the OP template for new threads.
Example URI
200This can’t be simpler.
Headers
Content-Type: application/jsonBody
{
"content": "[TITLE] Edition\n\nLast Thread: >>[POST]\n\n[NEW RELEASES]\n>Steven's Dream & Adventures in Light Distortion\nAiring January 30 at 7PM EST: https://twitter.com/cartoonnetwork/status/811588726912585729\n>Three Gems and a Baby\n[snip]",
"subject": "/sug/ - Steven Universe General"
}Steven Universe ¶
Other general SU stuff.
Downloads ¶
Get downloadsGET/dl.json
This endpoint retrieves all the available leaks.
individual, itunes and preair share the same structure, but comics is totally different.
Example URI
200Files that contains two episodes in one have an underscore between episodes number. Like for episode 1 & 2: 01_02.
For episodes: url, marebucks, dailymotion and torrent can be “null” if not available.
The same goes with comics and books: cbr, cbz, epub and pdf can be “null” if not available.
Headers
Content-Type: application/jsonBody
{
"_": {
"generated": 1496501844
},
"comics": [
{
"category": "Books",
"cbr": "https://example.com/SUG-CBR-BOOK-GTTCG.cbr",
"cbz": "https://example.com/SUG-CBZ-BOOK-GTTCG.cbz",
"date": 1490369885,
"epub": "https://example.com/SUG-EPUB-BOOK-GTTCG.epub",
"id": "BOOK-GTTCG",
"pdf": "https://example.com/SUG-PDF-BOOK-GTTCG.pdf",
"title": "Guide to the Crystal Gems"
},
{
"category": "Main Comics (2014-15)",
"cbr": "https://example.com/SUG-CBR-COMIC01.cbr",
"cbz": "https://example.com/SUG-CBZ-COMIC01.cbz",
"date": 1490369885,
"epub": "https://example.com/SUG-EPUB-COMIC01.epub",
"id": "COMIC01",
"pdf": "https://example.com/SUG-PDF-COMIC01.pdf",
"title": "Issue 01"
},
],
"individual": [
{
"dailymotion": null,
"date": 1473502695,
"episode": "01",
"id": 101,
"marebucks": "https://marebucks.com/sun/1",
"season": "01",
"title": "Gem Glow",
"torrent": null,
"url": "https://example.com/mega/01x01.mp4"
},
{
"dailymotion": null,
"date": 1473502695,
"episode": "02",
"id": 102,
"marebucks": "https://marebucks.com/sun/2",
"season": "01",
"title": "Laser Light Cannon",
"torrent": null,
"url": "https://example.com/mega/01x02.mp4"
}
],
"itunes": [
{
"dailymotion": null,
"date": 1473502695,
"episode": "01_02",
"id": 10102,
"marebucks": "https://marebucks.com/sun/1",
"season": "01",
"title": "Gem Glow & Laser Light Cannon",
"torrent": "https://example.com/torrents/01x01_02.mkv.torrent",
"url": "https://example.com/01x01_02.mkv"
},
{
"dailymotion": null,
"date": 1473502695,
"episode": "03_04",
"id": 10304,
"marebucks": "https://marebucks.com/sun/3",
"season": "01",
"title": "Cheeseburger Backpack & Together Breakfast",
"torrent": "https://example.com/torrents/01x03_04.mkv.torrent",
"url": "https://example.com/01x03_04.mkv"
}
],
"preair": [
{
"dailymotion": "https://dailymotion.com/video/x5lts7g",
"date": 1473502695,
"episode": "01",
"id": 501,
"marebucks": "https://marebucks.com/sun/127",
"season": "05",
"title": "Stuck Together",
"torrent": null,
"url": "https://example.com/preair/ep.mkv"
}
]
}