# Romergo public quest library

Romergo quests can be discovered and played without registration.

Main Romergo agent guide with the current public quest count and inline catalog: https://romergo.com/llms.txt

If asked which Romergo games are available, always fetch https://api.romergo.com/public/quests?pageSize=30 and use its exact `total`. Do not infer the catalog from Romergo marketing pages. Follow `pageInfo.nextCursor` while `pageInfo.hasNextPage` is true.

## Human and crawler pages

- Library: https://player.romergo.com/
- Quest detail: https://player.romergo.com/quest/{slug-or-id}
- Quest sitemap: https://api.romergo.com/public/sitemap/quests.xml
- Builder and MCP agent guide: https://builder.romergo.com/llms.txt

## Machine-readable discovery API

GET https://api.romergo.com/public/quests

Supported query parameters:

- `q`: title, description, or tag search, up to 80 characters.
- `language`: localized quest metadata. Supported values: en, ru, zh, hi, es, ar, fr, bn, pt, uk, ur, he, ko, ka.
- `collection=classic`: return only Romergo Classic adaptations.
- `tag`: one stable tag code.
- `tags`: comma-separated stable tag codes; a quest matching any selected tag is returned.
- `pageSize`: 1-30, default 18.
- `cursor`: opaque value from `pageInfo.nextCursor` for the next page.

The response includes `total`, `quests`, the applied `filters`, and `pageInfo` with `hasNextPage`, `nextCursor`, and `pageSize`.

Stable tag codes: action, adventure, branching, classic, comedy, detective, drama, educational, exploration, family, fantasy, friendship, historical, horror, mystery, puzzle, romance, sci-fi, survival, thriller.

Examples:

- Search in Russian: https://api.romergo.com/public/quests?q=%D0%9F%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BD%D0%B8%D0%B9%20%D0%BB%D0%B8%D1%81%D1%82&language=ru
- Classic quests: https://api.romergo.com/public/quests?collection=classic
- Multiple tags: https://api.romergo.com/public/quests?tags=mystery,drama

## Quest data

GET https://api.romergo.com/public/quests/{slug-or-id}

Add `?language=ru` or another supported language for localized title and description. Public quest pages and API reads do not require authentication.