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
200
In 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/json
Body
{
"_": {
"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
200
This can’t be simpler.
Headers
Content-Type: application/json
Body
{
"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
200
Files 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/json
Body
{
"_": {
"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"
}
]
}