latestOpenAPI 3.1.02026-08-10466368560.6 KB

2b2bab8b9017

characters

Discover Characters

Discover public characters with pagination and filters.

  • No authentication required (guest users supported)
  • Only returns public characters (unlisted characters are accessible via direct link only)
  • Includes favorite status if user is authenticated
get/characters/discover

Query parameters

pageinteger

Page number

Page number

page_sizeinteger

Items per page

Items per page

tagsstring nullable

Comma-separated tags to filter by

Comma-separated tags to filter by

searchstring nullable

Search query for name/description

Search query for name/description

ratingstring nullable

Filter by rating: sfw, nsfw, or all

Filter by rating: sfw, nsfw, or all

query_modestring nullable

Sort mode: trending, popular, new

Sort mode: trending, popular, new

Response

Successful Response

totalinteger required
pageinteger required
page_sizeinteger required
total_pagesinteger required
has_nextboolean required
has_prevboolean required