Post API guide

Kokonotsuba provides a read-only API for fetching post data. You can fetch data from individual posts or whole threads.

Get a single post

GET https://img.heyuri.net/l/koko.php?mode=module&load=postApi&post_uid={post_uid}

Returns JSON with the post data and rendered HTML

Parameters

Parameter	Type	Description
post_uid	integer	The unique ID of the post

Response fields

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 posts from a thread (paginated)

GET https://img.heyuri.net/l/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.

Parameters

Parameter	Type	Description
thread_uid	string	The unique ID of the thread
page	integer	Page number (0-based, optional, defaults to 0)

Response

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 thread list (paginated)

GET https://img.heyuri.net/l/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).

Parameters

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)

Response

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