# Game Giveaways API
> Free game, DLC, in-game loot and beta-key giveaways as an API, powered by GamerPower — the tracker of currently-active, limited-time giveaways across every store and platform. Where a games catalogue lists what exists and a deals feed lists discounts, this API tracks what you can claim free right now before it expires. /v1/giveaways returns the live giveaways, filterable by platform (steam, epic-games-store, gog, ubisoft, ps4, ps5, xbox-one, xbox-series-xs, switch, android, ios, vr and more), by type (game, loot, beta) and by sort order (date, value, popularity) — each giveaway with its id, title, retail worth, type, the platforms it covers, the end date, the direct claim URL, thumbnail and cover image, a short description and how many users have already claimed it. /v1/giveaway?id=3664 returns a single giveaway's full detail with description and step-by-step claim instructions (it returns found:false when that giveaway has already expired, since giveaways are time-limited). /v1/worth returns the number of active giveaways and their total estimated retail value in USD, optionally filtered by platform and type. Ideal for "free games this week" widgets, deal-alert and Discord/Telegram bots, gaming-news sites and savings trackers. Distinct from game catalogues and price/deal feeds — these are claim-it-free, time-limited offers. Data from GamerPower (free to use).

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

## Pricing
- **Free** (Free) — 3,200 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 49,000 calls/Mo, 5 req/s
- **Pro** ($16/Mo) — 205,000 calls/Mo, 12 req/s
- **Mega** ($43/Mo) — 690,000 calls/Mo, 35 req/s

## Endpoints

### Giveaways

#### `GET /v1/giveaway` — A single giveaway detail

**Parameters:**
- `id` (query, required, string) — Giveaway id (from /v1/giveaways), e.g. 3664 Example: `3664`

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

**Response:**
```json
{
    "data": {
        "id": 3664,
        "found": true,
        "giveaway": {
            "id": 3664,
            "type": "Game",
            "image": "https://www.gamerpower.com/offers/1b/6a1b24ffbbc52.jpg",
            "title": "Moonrise Fall (Steam) Giveaway",
            "worth": "$9.99",
            "status": "Active",
            "end_date": "2026-06-02 23:59:00",
            "claim_url": "https://www.gamerpower.com/open/moonrise-fall-steam-giveaway",
            "platforms": [
                "PC",
                "Steam"
            ],
            "thumbnail": "https://www.gamerpower.com/offers/1/6a1b24ffbbc52.jpg",
            "description": "Download Moonrise Fall for free on Steam until June 2! Moonrise Fall is a 2d exploration puzzle game with an immersive pixel graphics world and unique puzzles to solve.",
            "instructions": "1. Click the button to visit the giveaway page. 2. Download this game directly via Steam before the offer expires. 3. That´s it! Have fun!",
            "users_claimed": 17010,
            "gamerpower_url": "https://www.gamerpower.com/moonrise-fall-steam-giveaway",
            "published_date": "2026-05-30 13:57:19",
            "short_description": "Download Moonrise Fall for free on Steam until June 2! Moonrise Fall is a 2d exploration puzzle game with an immersive pixel graphics world and unique puzzles to solve."
        }
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:38.746Z",
        "request_id": "ae141ed0-e
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/giveaways` — Active giveaways

**Parameters:**
- `platform` (query, optional, string) — e.g. pc, steam, epic-games-store Example: `pc`
- `type` (query, optional, string) — game, loot or beta
- `sort-by` (query, optional, string) — date, value, popularity
- `limit` (query, optional, string) — Max results (1-200)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gamerpower-api/v1/giveaways?platform=pc"
```

**Response:**
```json
{
    "data": {
        "type": "all",
        "count": 50,
        "total": 94,
        "platform": "pc",
        "giveaways": [
            {
                "id": 3664,
                "type": "Game",
                "image": "https://www.gamerpower.com/offers/1b/6a1b24ffbbc52.jpg",
                "title": "Moonrise Fall (Steam) Giveaway",
                "worth": "$9.99",
                "end_date": "2026-06-02 23:59:00",
                "claim_url": "https://www.gamerpower.com/open/moonrise-fall-steam-giveaway",
                "platforms": [
                    "PC",
                    "Steam"
                ],
                "thumbnail": "https://www.gamerpower.com/offers/1/6a1b24ffbbc52.jpg",
                "users_claimed": 16950,
                "gamerpower_url": "https://www.gamerpower.com/moonrise-fall-steam-giveaway",
                "published_date": "2026-05-30 13:57:19",
                "short_description": "Download Moonrise Fall for free on Steam until June 2! Moonrise Fall is a 2d exploration puzzle game with an immersive pixel graphics world and unique puzzles to solve."
            },
            {
                "id": 3663,
                "type": "Game",
                "image": "https://www.gamerpower.com/offers/1b/6a1b241f224c6.jpg",
                "title": "IQ Under Construction (Steam) Giveaway",
                "worth": "$2.99",
                "end_date": "2026-06-01 23:59:00",
                "claim_url": "https://www.gamerpower.com/open/iq
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/worth` — Total value of live giveaways

**Parameters:**
- `platform` (query, optional, string) — e.g. pc
- `type` (query, optional, string) — game, loot or beta

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

**Response:**
```json
{
    "data": {
        "type": "all",
        "platform": "all",
        "total_worth_usd": 392.85,
        "active_giveaways": 98
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:38.960Z",
        "request_id": "724fc9ed-504c-4ca6-a5c9-9f0f91d398b0"
    },
    "status": "ok",
    "message": "Worth retrieved",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Currently-active, limited-time giveaways of free games, DLC, in-game loot and beta keys from GamerPower. /v1/giveaways = the live giveaways, filterable by platform (steam, epic-games-store, gog, ps5, xbox-series-xs, switch, android, ios, …), by type (game, loot, beta) and sort order (date, value, popularity) — each with its id, title, retail worth, type, platforms, end date, claim URL, image and how many users have claimed it; /v1/giveaway?id=3664 = a single giveaway's full detail with description and claim instructions (returns found:false when that giveaway has expired, since giveaways are time-limited); /v1/worth = the number of active giveaways and their total estimated USD value (optionally filtered by platform/type). Distinct from game catalogues and price/deal feeds — these are 'claim it free before it expires' offers. Data from GamerPower (free to use). Ideal for deal-alert bots, gaming-news sites and 'free games this week' widgets.",
        "source": "GamerPower — game giveaways & loot (gamerpower.com)",
        "filters": {
            "sort": [
                "date",
                "value",
                "popularity"
            ],
            "type": [
                "game",
                "loot",
                "beta"
            ],
            "platform": [
                "pc",
                "steam",
                "epic-games-store",
                "ubisoft",
                "gog",
                "itchio",

…(truncated, see openapi.json for full schema)
```


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