Site Discussion@Heyuri
it's the place to be!
Kokonotsuba provides a read-only API for fetching post data. You can fetch data from individual posts or whole threads.
GET https://img.heyuri.net/q/koko.php?mode=module&load=postApi&post_uid={post_uid}Returns JSON with the post data and rendered HTML
| Parameter | Type | Description |
|---|---|---|
post_uid | integer | The unique ID of the post |
| Field | Type | Description |
|---|---|---|
post_uid | integer | Post unique ID |
timestamp | string | Post timestamp |
name | string | Poster name |
tripcode | string | Tripcode (formatted) |
secure_tripcode | string | Secure tripcode |
capcode | string | Staff capcode |
email | string | Email field |
subject | string | Post subject |
comment | string | Raw comment text |
parent_thread_uid | integer | UID of the parent thread |
parent_post_number | integer | Post number of the thread OP |
html | string | Fully rendered post HTML |
GET https://img.heyuri.net/q/koko.php?mode=module&load=postApi&pageName=thread&thread_uid={thread_uid}&page={page}Returns JSON with a page of posts from the specified thread. The OP is always included on every page.
| Parameter | Type | Description |
|---|---|---|
thread_uid | string | The unique ID of the thread |
page | integer | Page number (0-based, optional, defaults to 0) |
Returns an object with thread_uid, page, post_count, and posts (array of post objects with the same fields as the single post endpoint).
GET https://img.heyuri.net/q/koko.php?mode=module&load=postApi&pageName=threads&board_uid={board_uid}&page={page}Returns a paginated list of thread UIDs for the board, sorted by creation time (newest first).
| Parameter | Type | Description |
|---|---|---|
board_uid | integer | The numeric board UID (optional, defaults to the current board) |
page | integer | Page number (0-based, optional, defaults to 0) |
Returns an object with page, threads_per_page, thread_count, and threads (array of thread objects).
| Field | Type | Description |
|---|---|---|
thread_uid | string | Unique ID of the thread |
subject | string | Subject of the opening post |
last_bump_time | string | Timestamp of the last bump |
thread_created_time | string | Timestamp of when the thread was created |
post_count | integer | Total number of posts in the thread |
GET https://img.heyuri.net/q/koko.php?mode=module&load=postApi&pageName=quote&thread_uid={thread_uid}&before_uid={post_uid}&text={text}Returns the nearest earlier post of the thread that a ">text", ">file.jpg" or ">No.123" quote refers to, in the same shape as a single post. Responds 404 when nothing matches.
| Parameter | Type | Description |
|---|---|---|
thread_uid | string | The unique ID of the thread |
before_uid | integer | The post_uid of the quoting post. Only posts before it are searched |
text | string | The quoted text without its leading ">", at most 300 characters. A number is looked up as a post number, and a name with an extension also matches attachment file names |
quoted | 0 | 1 | Set to 1 for a ">>text" quote of a quote, which only matches posts that quote something themselves |