---
title: "Discover Characters"
method: GET
path: "/characters/discover"
tags: ["characters"]
---

# Discover Characters

`GET /characters/discover`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/characters/discover`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

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

## Query parameters

- `page` integer: Page number
- `page_size` integer: Items per page
- `tags` string, nullable: Comma-separated tags to filter by
- `search` string, nullable: Search query for name/description
- `rating` string, nullable: Filter by rating: sfw, nsfw, or all
- `query_mode` string, nullable: Sort mode: trending, popular, new

## Response `200`

Successful Response

- CharacterDiscoveryResponse: Paginated response for character discovery.
  - `characters` CharacterPublic[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `tagline` string, nullable
    - `image_url` string, nullable
    - `tags` string[]
    - `rating` string, nullable
    - `is_explicit_image` boolean
    - `message_total` integer
    - `chat_total` integer
    - `created_by` string, uuid, nullable
    - `creator_name` string, nullable
    - `creator_avatar` string, nullable
    - `is_favorite` boolean
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `has_next` boolean, required
  - `has_prev` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/meganova/apis/meganova-api.md) - [All operations](https://skmtc.dev/meganova/apis/meganova-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/meganova-api/revisions/c683584f6060?raw)