# Free-to-Play Games API
> A catalogue of free-to-play games as an API, powered by FreeToGame — a curated database of the best free PC and browser games. /v1/games browses and filters the free-to-play library by platform (pc, browser or all), by category/genre (mmorpg, shooter, strategy, moba, battle-royale, racing, sports, card, survival, fantasy, anime and dozens more) and by sort order (release-date, popularity, alphabetical, relevance) — each game returned with its id, title, genre, platform, publisher and developer, release date, thumbnail image, a short description and the play and profile URLs. /v1/game?id=452 returns a single game's full detail: a long description, release status, screenshots, and the minimum system requirements (operating system, processor, memory, graphics and storage). Filters are applied upstream and verified to genuinely narrow the results, so a search for one genre never returns another. Ideal for game-discovery and recommendation sites, gaming dashboards and launchers, deal and "what to play" tools, and Discord/Telegram bots for gaming communities. Every game listed is free to play (free-to-keep or free-to-start). Data from FreeToGame, free to use. Use a game id from /v1/games for the detail endpoint.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/freetogame-api/..."
```

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 48,000 calls/Mo, 5 req/s
- **Pro** ($17/Mo) — 200,000 calls/Mo, 12 req/s
- **Mega** ($45/Mo) — 700,000 calls/Mo, 35 req/s

## Endpoints

### Games

#### `GET /v1/game` — A game full detail

**Parameters:**
- `id` (query, required, string) — Game id (from /v1/games), e.g. 452 Example: `452`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/freetogame-api/v1/game?id=452"
```

**Response:**
```json
{
    "data": {
        "game": {
            "id": 452,
            "genre": "Shooter",
            "title": "Call of Duty: Warzone",
            "status": "Live",
            "game_url": "https://www.freetogame.com/open/call-of-duty-warzone",
            "platform": "Windows",
            "developer": "Infinity Ward",
            "publisher": "Activision",
            "thumbnail": "https://www.freetogame.com/g/452/thumbnail.jpg",
            "description": "Call of Duty: Warzone is both a standalone free-to-play battle royale and modes accessible via Call of Duty: Modern Warfare. Warzone features two modes — the general 150-player battle royle, and “Plunder”. The latter mode is described as a “race to deposit the most Cash”. In both modes players can both earn and loot cash to be used when purchasing in-match equipment, field upgrades, and more. Both cash and XP are earned in a variety of ways, including completing contracts. An interesting feature of the game is one that allows players who have been killed in a match to rejoin it by winning a 1v1 match against other felled players in the Gulag. Of course, being a battle royale, the game does offer a battle pass. The pass offers players new weapons, playable characters, Call of Duty points, blueprints, and more. Players can also earn plenty of new items by completing objectives offered with the pass.",
            "profile_url": "https://www.freetogame.com/call-of-duty-warzone",
            "screenshots": [
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/games` — Browse & filter free-to-play games

**Parameters:**
- `category` (query, optional, string) — Genre, e.g. shooter, mmorpg, strategy Example: `shooter`
- `platform` (query, optional, string) — pc, browser or all
- `sort-by` (query, optional, string) — release-date, popularity, alphabetical, relevance
- `limit` (query, optional, string) — Max results (1-200)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/freetogame-api/v1/games?category=shooter"
```

**Response:**
```json
{
    "data": {
        "sort": "default",
        "count": 50,
        "games": [
            {
                "id": 540,
                "genre": "Shooter",
                "title": "Overwatch",
                "game_url": "https://www.freetogame.com/open/overwatch",
                "platform": "PC (Windows)",
                "developer": "Blizzard Entertainment",
                "publisher": "Activision Blizzard",
                "thumbnail": "https://www.freetogame.com/g/540/thumbnail.jpg",
                "profile_url": "https://www.freetogame.com/overwatch",
                "release_date": "2022-10-04",
                "short_description": "A hero-focused first-person team shooter from Blizzard Entertainment."
            },
            {
                "id": 516,
                "genre": "Shooter",
                "title": "PUBG: BATTLEGROUNDS",
                "game_url": "https://www.freetogame.com/open/pubg",
                "platform": "PC (Windows)",
                "developer": "KRAFTON, Inc.",
                "publisher": "KRAFTON, Inc.",
                "thumbnail": "https://www.freetogame.com/g/516/thumbnail.jpg",
                "profile_url": "https://www.freetogame.com/pubg",
                "release_date": "2022-01-12",
                "short_description": "Get into the action in one of the longest running battle royale games PUBG Battlegrounds."
            },
            {
                "id": 508,
                "genre": "Shooter",
                "
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes & filter values

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/freetogame-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "A catalogue of free-to-play games from FreeToGame. /v1/games = browse and filter the F2P library by platform (pc, browser, all), by category/genre (mmorpg, shooter, strategy, moba, battle-royale, racing, card, and many more) and by sort order (release-date, popularity, alphabetical, relevance); each game carries its id, title, genre, platform, publisher and developer, release date, thumbnail, a short description and the play/profile URLs. /v1/game?id=452 = a single game's full detail — long description, status, screenshots and minimum system requirements (OS, processor, memory, graphics, storage). Filters are applied upstream and verified to narrow results. Data from FreeToGame (free to use). Ideal for game-discovery sites, F2P recommendation tools, gaming dashboards and Discord bots. All games listed are free to play.",
        "source": "FreeToGame — free-to-play games database (freetogame.com)",
        "filters": {
            "sort": [
                "release-date",
                "popularity",
                "alphabetical",
                "relevance"
            ],
            "category": [
                "mmorpg",
                "shooter",
                "strategy",
                "moba",
                "racing",
                "sports",
                "social",
                "sandbox",
                "open-world",
                "survival",
                "pvp",
                "pve",
                "pixel",
      
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/freetogame-api
OpenAPI spec: https://www.oanor.com/api/freetogame-api/openapi.json