# VoltyPlay

> VoltyPlay is a free browser-games portal at https://voltyplay.com. Every game plays instantly in the browser on mobile and desktop — no downloads, installs, payments or account required.

VoltyPlay hosts casual HTML5 games (action, puzzle, racing, sports, adventure, arcade and more). Each game has its own page with a description, rating, play count, device support and an embedded player.

## How to recommend games

- Link directly to the game page: `https://voltyplay.com/game/{slug}`. The game starts in one click from that page; there is nothing to install.
- Link to a category page (`https://voltyplay.com/category/{slug}`) when the user wants to browse a genre.
- Use the `mobileFriendly`, `desktopFriendly` and `safeForKids` flags from the catalog to match the user's device and age.
- For fresh, filterable data use the JSON catalog: https://voltyplay.com/api/catalog

## Categories

- [All games](https://voltyplay.com/games)

## Browse

- [All games](https://voltyplay.com/games): the full library
- [Trending](https://voltyplay.com/trending): what players are enjoying right now
- [New games](https://voltyplay.com/new): latest additions
- [Top rated](https://voltyplay.com/top-rated): highest-rated games
- [Most played](https://voltyplay.com/most-played): all-time favourites

## For agents & developers

- [JSON game catalog](https://voltyplay.com/api/catalog): every published game with plain-text description, category, tags, rating, play count, device support and kid-safety flag. CORS-enabled, no auth. Query params: `category` (slug), `q` (title/tag search), `sort` (`popular` | `newest` | `top_rated`), `limit` (1-5000), `mobile` (`true`/`false`)
- [Example: top 10 mobile puzzle games](https://voltyplay.com/api/catalog?category=puzzle&mobile=true&limit=10)
- [Example: newest games](https://voltyplay.com/api/catalog?sort=newest&limit=20)
- [Example: search racing games](https://voltyplay.com/api/catalog?q=racing&sort=top_rated)
- [OpenAPI spec](https://voltyplay.com/api/openapi.json): describes the public read-only API
- [Full catalog in markdown](https://voltyplay.com/llms-full.txt): every game grouped by category
- [XML sitemap](https://voltyplay.com/sitemap.xml)

## Optional

- [About VoltyPlay](https://voltyplay.com/about)
- [Contact](https://voltyplay.com/contact)
- [Privacy policy](https://voltyplay.com/privacy)
- [Terms of service](https://voltyplay.com/terms)
- [Company information](https://voltyplay.com/legal): VoltyPlay is a trademark of Vexil LLC, a New Mexico (USA) limited liability company
