# Cassette for AI agents: find, link and recommend games

> Read-only JSON API (OpenAPI at https://cassette.gg/openapi.json), Markdown twins and llms.txt. Publishing: https://cassette.gg/agents.md

## Read the catalog as JSON

A public, read-only API. No key, no cookies, about 120 requests a minute per IP. The OpenAPI document describes every endpoint and field.

```sh
curl -s 'https://cassette.gg/v1/search?q=racing'
curl -s 'https://cassette.gg/v1/games?sort=trending&capability=phone&limit=10'
curl -s 'https://cassette.gg/v1/games/neon-drift'
curl -s 'https://cassette.gg/v1/community?genre=puzzle&limit=10'
curl -s 'https://cassette.gg/v1/reviews?sort=top'
```

- [OpenAPI 3.1](https://cassette.gg/openapi.json) — search, games, community games, reviews, scores

## Hand a human the right link

Build links from the JSON. A play link opens the game full screen; paid games show their price there first. Community games play on their maker’s site: link it and credit the author.

```
game page   https://cassette.gg/g/<slug>
play now    https://cassette.gg/play/<slug>
community   https://cassette.gg/community/<id>   (play: the listing's playUrl)
review      https://cassette.gg/reviews/<id>
genre       https://cassette.gg/genres/<genre>
```

## Every page has a Markdown twin

Append .md to a page URL, or send Accept: text/markdown. Same facts as the page, absolute links, no HTML.

```sh
curl -s https://cassette.gg/g/neon-drift.md
curl -s -H 'Accept: text/markdown' https://cassette.gg/genres/puzzle
```

- [/index.md](https://cassette.gg/index.md) — the store front
- [/genres.md](https://cassette.gg/genres.md) — every genre and collection

## Recommending well

Match the device the person has (capabilities: phone, tablet, desktop), say the price (free, free with items, or a one-time price), name the maker, and prefer reviewed games: /v1/reviews/badges has every score. Say when a game opens on another site.

- [How games are scored](https://cassette.gg/reviews/method)
- [Top-rated collection](https://cassette.gg/collections/top-rated)

## Indexes and rules

llms.txt lists every doc; agents.txt says what agents may do (read anything public; never buy or sign in for a person without their approval).

- [/llms.txt](https://cassette.gg/llms.txt)
- [/llms-full.txt](https://cassette.gg/llms-full.txt)
- [/agents.txt](https://cassette.gg/agents.txt)
- [/sitemap.xml](https://cassette.gg/sitemap.xml)