api.420chan.org420chan API Documentation

SLURP OUR JSON Studies show that 766% of developers had enhanced libido & strength after parsing our data Last Updated: May 10, 2018 Overview Usage Return Values Optional Parameters Code Examples Stankass 1. Overview Welcome to the 420chan JSON API documentation We now have a JSON API. It's built to be as close to the 4chan API as possible for familiarity sake. Please beat the shit out of it and report any issues you may find. I'm fairly excited to see what people do with it. Build and share! For stuff not yet implemented, you can make a fair assumption that it will be like the existing 4chan API, with 90% of functionality currently present. Unimplemented items are marked. 2. Usage getCategoriesList - Returns a list of all board categories URL - http://api.420chan.org/categories.json Example Output -------------- { "categories": [ { "id": 2, "title": "Burritos", "nws_category": 0, "display_order": 1 }, ] } getBoardsList - Returns a list of all boards URL - http://api.420chan.org/boards.json Example Output -------------- { "boards": [ { "category": 2, "board": "beef", "title": "Beef Burrito Discussion", "nws_board": 0, "display_order": 1 }, { "category": 2, "board": "bean", "title": "Bean Burrito Discussion", "nws_board": 0, "display_order": 2 } ] } getNetjester - Returns a list of all NJ posts on a board URL - http://api.420chan.org/[BOARD]/netjester.json LIVE EXAMPLE - http://api.420chan.org/b/netjester.json Example Output -------------- { "njposts": [ { "no": 3128807, "now": "Tue, 30 Apr 2013 06:09:52 EST", "name": "Netjester", "trip": "!AI.skYnEt", "id": "iLikEToleARn", "staff": "1", "com": ">>3128806 \nI got totally immersed in it when I'm building myself up to achieve that other than the moon, hermetically sealing buildings, a well regulated police force, it should have fresh gauze bandages, medical tape, a good initial trajectory, and a mix of any other.", "time": 1367316592, "resto": 3128760 } ] } getBoard - Returns a basic list of thread IDs, subjects, and modification times URL - http://api.420chan.org/b/threads.json LIVE EXAMPLE - http://api.420chan.org/b/threads.json Example Output -------------- [ { "page": 0, "threads": [ { "no": 152084, "sub": "I SMELL LIKE ASSHOLE", "last_modified": 1367520295 } ] } ] getCatalog - Returns a detailed list of all threads on a board URL - http://api.420chan.org/[BOARD]/catalog.json LIVE EXAMPLE - http://api.420chan.org/b/catalog.json Example Output -------------- getThread - Returns a full single thread URL - http://api.420chan.org/[BOARD]/res/[THREAD].json Example Output -------------- { "posts": [ { "no": 151958, "now": "Wed, 01 May 2013 01:22:41 EST", "name": "The Celt", "trip": "!BzcOsK03.w", "id": "aamITKLP", "staff": "1", "sub": "I'm fat", "com": "Oh god\r\nLick my blubs\r\n[b]FAT[/b]", "filename": "1367385761801", "ext": ".jpg", "w": 1069, "h": 491, "tn_w": 256, "tn_h": 117, "time": 1367385761, "fsize": 102258, "resto": 0 }, { "no": 151959, "now": "Wed, 01 May 2013 01:24:50 EST", "name": "Matilda Blinningdatch", "id": "iuWZpiQD", "com": "ALL THAT FAT\r\nCAN'T FIT IT ALL IN MY MOUTH", "time": 1367385890, "resto": 151958 }, ] } getPost - Returns a single post on a board URL - http://api.420chan.org/[BOARD]/single/[POST].json Example Output -------------- { "post": [ { "no": 151958, "now": "Wed, 01 May 2013 01:22:41 EST", "name": "The Celt", "trip": "!BzcOsK03.w", "id": "aamITKLP", "staff": 1, "sub": "I'm fat", "com": "Oh god\r\nLick my blubs\r\n[b]FAT[/b]", "filename": "1367385761801", "ext": ".jpg", "w": 1069, "h": 491, "tn_w": 256, "tn_h": 117, "time": 1367385761, "fsize": 102258 } ] } getBoardPage - Returns a single page (with replies and omit count) (NOT YET IMPLEMENTED) URL - http://api.420chan.org/[BOARD]/[PAGE].json LIVE EXAMPLE - http://api.420chan.org/b/0.json Example Output -------------- getActiveDiscussions - Returns the last 10 posts (WIP) URL - http://api.420chan.org/latest.json Example Output -------------- { "latest": [ { "board": "cd", "thread": 339676, "resto": 339756, "text": ">>339687\r\nmemory is extremely unreliable. honestly i have tried to analyze my feelings towards being" }, { "board": "weed", "thread": 4515663, "resto": 4515828, "text": "Is there a source on that GIF?\r\n\r\nLike, is he actually punching a baby?\r\n\r\nThe fuck." }, ] } getStats - Returns some basic metrics (WIP) URL - http://api.420chan.org/stats.json Example Output -------------- { "stats": [ { "board": "weed", "users": 1531, "postcount": 4515872, "size": 537992276 }, { "board": "b", "users": 1470, "postcount": 3132777, "size": 1409468522 }, { "board": "wooo", "users": 1401, "postcount": 2910416, "size": 2151624614 } ] } getRandomNetjesterQuote - Returns a completely random AI response URL - http://api.420chan.org/netjester/random.json Example Output -------------- {"text":">no legends minitrons unless they've been on TV and nobody improves in FCW."} IF NETJESTER DAEMON IS OFFLINE, JSON RETURNED WILL BE AS FOLLOWS ------------- {"offline":true} getNetjesterResponse - Returns an AI response to the given input URL - http://api.420chan.org/netjester/response.json/[INPUT TEXT] LIVE EXAMPLE - http://api.420chan.org/netjester/response.json/HORSES Example Output -------------- {"text":"Not gonna lie, the cab driver on the way back he sees a woman pushing a stroller with two babies in it, I noticed how FUCKING GOOD HORSES ARE AT WALL-CLIMBING!"} IF NETJESTER DAEMON IS OFFLINE, JSON RETURNED WILL BE AS FOLLOWS ------------- {"offline":true} 3. Return Values Single Thread, Catalog, Netjester, & Page Objects * - Not yet implemented Attribute Value Description Possible Values Example Value no integer Post number 1-9999999999999 80085 resto integer Reply to 0 (is thread), 1-9999999999999 0 sticky integer Stickied thread? 0 (no), 1 (yes) 1 closed integer Locked thread? 0 (no), 1 (yes) 0 closedby string Thread locked by text Netjester closedreason string Reason for lock text Being human banned integer Banned user? 0 (no), 1 (yes) 0 bannedby string User banned by text Netjester banreason string Reason for ban text Daisy, Daisy now string Date and time Day, DD Month YYYY HH:MM:SS EST Thu, 02 May 2013 09:12:03 EST time integer UNIX timestamp UNIX timestamp 1344570123 name string Name text Netjester trip string Tripcode text (format: !tripcode!!securetripcode) !AI.skYnEt staff integer Is user staff? 0 (no), 1 (yes) 1 id string ID text (8 characters), iLikEToleARn iLikEToleARn sub string Subject text (only present in OP) This is a subject com string Comment text (unparsed bbcode and newlines) This is a comment filename integer Renamed filename UNIX timestamp + microseconds 1344402680740 ext string File extension .jpg, .png, .gif, .mp3, .swf .jpg fsize integer File size 1-99999999 2500 md5 * string File MD5 text (24 character, packed base64 MD5 hash) NOetrLVnES3jUn1x5ZPVAg== w integer Image width 1-10000 500 h integer Image height 1-10000 500 tn_w integer Thumbnail width 1-250 250 tn_h integer Thumbnail height 1-250 250 filedeleted * integer File deleted? 0 (no), 1 (yes) 0 spoiler * integer Spoiler image? 0 (no), 1 (yes) 0 omitted_posts * integer # replies omitted 1-10000 33 omitted_images * integer # image replies omitted 1-10000 21 replies * integer # replies total 0-99999 231 images * integer # images total 0-99999 132 bumplimit * integer Bump limit met? 0 (no), 1 (yes) 0 4. Optional Parameters Check back later 5. Code Examples Check back later 6. Stankass Access Denied Access Denied Access Denied © 2013 Taima Labs...