# GOG API
> Live game catalogue & prices from GOG.com (the DRM-free PC game store by CD Projekt). Search the store for any game and get its current price with discount, genres, developers, publishers, rating, review count, release date, supported OS, cover image and store link; open one game by id for its full detail (description, OS compatibility, release, store URL). Ideal for gaming, deal-tracking, library and price-comparison apps. Distinct from game-giveaway and deal aggregators — GOG's own catalogue and live prices.

## 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/gog-api/..."
```

## Pricing
- **Free** (Free) — 1,200 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 30,000 calls/Mo, 8 req/s
- **Pro** ($39/Mo) — 200,000 calls/Mo, 20 req/s
- **Business** ($149/Mo) — 1,500,000 calls/Mo, 50 req/s

## Endpoints

### Games

#### `GET /v1/game` — One game in full by GOG product id

**Parameters:**
- `id` (query, required, string) — GOG product id (from /v1/search) Example: `1640424747`

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

**Response:**
```json
{
    "data": {
        "id": "1640424747",
        "slug": "the_witcher_3_wild_hunt_game_of_the_year_edition",
        "image": "https://images-1.gog-statics.com/71d71c40052877a42c096b8230c71856a560d42132208cfa8e719243b5c6626b_glx_logo_2x.jpg",
        "title": "The Witcher 3: Wild Hunt - Complete Edition",
        "source": "GOG",
        "game_type": "pack",
        "languages": [
            "العربية",
            "Português do Brasil",
            "中文(简体)",
            "český",
            "Deutsch",
            "English",
            "español",
            "Español (AL)",
            "français",
            "magyar",
            "italiano",
            "日本語",
            "한국어",
            "polski",
            "русский",
            "Türkçe",
            "中文"
        ],
        "store_url": "https://www.gog.com/game/the_witcher_3_wild_hunt_game_of_the_year_edition",
        "background": "https://images-1.gog-statics.com/9f3a742af9acf163ed9ce23dece108fd416433dc71cf6392a9ee6f8c7a6e7afe.jpg",
        "description": "<a href=\"https://www.",
        "is_pre_order": false,
        "purchase_url": "https://www.gog.com/de/checkout/manual/the_witcher_3_wild_hunt_game_of_the_year_edition",
        "release_date": "2016-08-30T00:00:00+0300",
        "in_development": false,
        "operating_systems": [
            "windows"
        ]
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:40.668Z",
        "request_id": "200f1
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search GOG games by keyword

**Parameters:**
- `q` (query, required, string) — Search keyword (e.g. witcher, cyberpunk, baldur) Example: `witcher`
- `order` (query, optional, string) — Sort: score, popularity, price_asc, price_desc, newest, discount, reviews, title Example: `score`
- `page` (query, optional, string) — Result page (default 1) Example: `1`
- `limit` (query, optional, string) — Results per page (1-48, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gog-api/v1/search?q=witcher&order=score&page=1&limit=20"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 20,
        "games": [
            {
                "id": "1213176929",
                "slug": "reigns_the_witcher",
                "type": "game",
                "image": "https://images.gog-statics.com/6a4c67c9cdb2343134e73e06ecaa26198588faff65c633e8b3ca5a1a76589638.png",
                "price": {
                    "base": "$5.99",
                    "free": false,
                    "final": "$4.79",
                    "amount": 4.79,
                    "currency": "USD",
                    "base_amount": 5.99,
                    "discount_pct": 20
                },
                "title": "Reigns: The Witcher",
                "genres": [
                    "Simulation",
                    "Fantasy",
                    "Adventure"
                ],
                "rating": 3.8,
                "reviews": 19,
                "store_url": "https://www.gog.com/en/game/reigns_the_witcher",
                "developers": [
                    "Nerial"
                ],
                "publishers": [
                    "Devolver Digital"
                ],
                "release_date": "2026.02.25",
                "operating_systems": [
                    "windows",
                    "osx"
                ]
            },
            {
                "id": "1441199941",
                "slug": "the_witcher_3_redkit",
                "type": "game",
                "image": "https://images.gog-stati
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "note": "search takes q (e.g. witcher, cyberpunk, baldur), optional page, limit (1-48) and order (score, popularity, price_asc, price_desc, newest, discount, reviews, title). game takes a numeric GOG product id (from search). Prices reflect the requested store region (USD by default).",
        "sample": {
            "price": "$4.79",
            "title": "Reigns: The Witcher"
        },
        "source": "GOG public catalogue (catalog.gog.com) + product API (api.gog.com), live",
        "service": "gog-api",
        "endpoints": {
            "GET /v1/game": "One game in full by GOG product id (id=1640424747).",
            "GET /v1/meta": "This document.",
            "GET /v1/search": "Search GOG games by keyword (q=witcher, order, page, limit)."
        },
        "description": "Live game catalogue & prices from GOG.com (the DRM-free PC game store by CD Projekt), keyless. Search the store for any game and get each title's current price (with discount), genres, developers, publishers, rating, review count, release date, supported OS, cover image and store link; open one game by id for its full detail (description, OS compatibility, release, store URL). Live, no key, nothing stored. The DRM-free game-store layer for gaming, deal-tracking, library and price apps. Distinct from game-giveaway and deal aggregators — GOG's own catalogue and live prices.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:41.40
…(truncated, see openapi.json for full schema)
```


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