# GGEMU

> GGEMU is a public retro game website with browsable game detail pages, collections, blog posts, multilingual localized pages, and lightweight public discovery APIs.

## Start Here

- Preferred entrypoint: https://ggemu.com/llms-full.txt
- LLMs.txt: https://ggemu.com/llms.txt
- LLMs full: https://ggemu.com/llms-full.txt
- API catalog: https://ggemu.com/.well-known/api-catalog
- OpenAPI: https://ggemu.com/.well-known/openapi.json
- API docs: https://ggemu.com/docs/api
- Agent skills index: https://ggemu.com/.well-known/agent-skills/index.json
- Sitemap: https://ggemu.com/sitemap.xml

## Public Content

- Home: https://ggemu.com/en
- Game pages: https://ggemu.com/en/game/{url_slug_or_id}
- Collections: https://ggemu.com/en/collections and https://ggemu.com/en/collections/{id}
- Blog: https://ggemu.com/en/blog and https://ggemu.com/en/blog/{slug}
- Library pages: https://ggemu.com/en/library/games, https://ggemu.com/en/library/platforms, https://ggemu.com/en/library/genres, https://ggemu.com/en/library/developers

## Public Game APIs

- Health: https://ggemu.com/api/health
- Search games: https://ggemu.com/api/games/search?query=mario&limit=20&page=1&sort=popular
- Game detail: https://ggemu.com/api/game/detail?id={url_slug_or_id}
- Search collections: https://ggemu.com/api/collections?query=capcom&limit=12&page=1
- Collection detail: https://ggemu.com/api/collections/{id}?limit=20&page=1
- Search blog posts: https://ggemu.com/api/blog-posts?keyword=arcade&limit=12&page=1
- Blog post detail: https://ggemu.com/api/blog-posts/{id_or_slug}

## Locales

- Supported localized public pages: en, zh-CN, zh-HK, hi, es, fr, de, ru, pt, ja, ko, vi, it, th, tr

## Markdown Support

- Send 'Accept: text/markdown' to supported public pages to receive markdown instead of HTML.
- Supported markdown pages: https://ggemu.com/, https://ggemu.com/en, https://ggemu.com/en/game/{url_slug_or_id}, https://ggemu.com/en/collections, https://ggemu.com/en/collections/{id}, https://ggemu.com/en/blog, https://ggemu.com/en/blog/{slug}

## Crawl Guidance

- Prefer sitemap URLs and canonical localized public pages for indexing.
- Prefer public game detail pages or the public game APIs for game metadata.
- Game detail identifiers accept either a GGEMU url_slug or a Mongo object id.
- Avoid private, admin, login, account, and non-public API routes.