GamerPower Filter API

openapi: 3.2.0
info:
  title: GamerPower Filter API
  description: 'The GamerPower API (gamerpower.com) is a free, no-authentication REST API that

    aggregates live game giveaways across PC, console, mobile, and DRM-free platforms.'
  version: 1.0.0
  contact:
    name: GamerPower
    url: https://www.gamerpower.com/api-read
  license:
    name: GamerPower Attribution
    url: https://www.gamerpower.com/api-read
  x-generated-from: documentation+live-api
  x-source-url: https://www.gamerpower.com/api-read
  x-last-validated: '2026-05-30'
servers:
- url: https://www.gamerpower.com/api
  description: GamerPower production API
tags:
- name: Filter
  description: Multi-value platform and type filtering using dot-separated values.
paths:
  /filter:
    get:
      tags:
      - Filter
      summary: GamerPower Filter Giveaways By Multiple Values
      description: 'Returns live giveaways filtered by one or more platforms and one or more

        giveaway types. Multiple values are dot-separated (e.g. `platform=epic-games-store.steam`

        and `type=game.loot`).'
      operationId: filterGiveaways
      parameters:
      - name: platform
        in: query
        required: false
        description: Dot-separated list of platforms (e.g. `epic-games-store.steam`).
        schema:
          type: string
          pattern: ^[a-z0-9-]+(\.[a-z0-9-]+)*$
        example: epic-games-store.steam
      - name: type
        in: query
        required: false
        description: Dot-separated list of giveaway types (e.g. `game.loot`).
        schema:
          type: string
          pattern: ^(game|loot|beta)(\.(game|loot|beta))*$
        example: game.loot
      - name: sort-by
        in: query
        required: false
        description: Sort the returned giveaways.
        schema:
          $ref: '#/components/schemas/SortBy'
        example: date
      responses:
        '200':
          description: An array of filtered live giveaways.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GiveawayList'
              examples:
                FilterGiveaways200Example:
                  summary: Default filterGiveaways 200 response
                  x-microcks-default: true
                  value:
                  - id: 3664
                    title: Moonrise Fall (Steam) Giveaway
                    worth: $9.99
                    thumbnail: https://www.gamerpower.com/offers/1/6a1b24ffbbc52.jpg
                    image: https://www.gamerpower.com/offers/1b/6a1b24ffbbc52.jpg
                    description: Download Moonrise Fall for free on Steam until June 2!
                    instructions: 1. Click the button to visit the giveaway page.
                    open_giveaway_url: https://www.gamerpower.com/open/moonrise-fall-steam-giveaway
                    published_date: '2026-05-30 13:57:19'
                    type: Game
                    platforms: PC, Steam
                    end_date: '2026-06-02 23:59:00'
                    users: 1310
                    status: Active
                    gamerpower_url: https://www.gamerpower.com/moonrise-fall-steam-giveaway
                    open_giveaway: https://www.gamerpower.com/open/moonrise-fall-steam-giveaway
        '201':
          description: No giveaways matched the filter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusEnvelope'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Giveaway:
      type: object
      description: A single live giveaway record (free game, beta key, DLC, or loot offer).
      required:
      - id
      - title
      - worth
      - thumbnail
      - image
      - description
      - instructions
      - open_giveaway_url
      - published_date
      - type
      - platforms
      - end_date
      - users
      - status
      - gamerpower_url
      properties:
        id:
          type: integer
          description: Numeric identifier of the giveaway.
          example: 3664
        title:
          type: string
          description: Human-readable title of the giveaway.
          example: Moonrise Fall (Steam) Giveaway
        worth:
          type: string
          description: USD worth as a formatted string (e.g. "$9.99"). May be "N/A" for items with no listed retail value (e.g. in-game loot, beta keys).
          example: $9.99
        thumbnail:
          type: string
          format: uri
          description: URL of the small thumbnail image.
          example: https://www.gamerpower.com/offers/1/6a1b24ffbbc52.jpg
        image:
          type: string
          format: uri
          description: URL of the large promotional image.
          example: https://www.gamerpower.com/offers/1b/6a1b24ffbbc52.jpg
        description:
          type: string
          description: Marketing description of the giveaway.
          example: Download Moonrise Fall for free on Steam until June 2!
        instructions:
          type: string
          description: Step-by-step instructions for claiming the giveaway. Newline-separated steps.
          example: '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!'
        open_giveaway_url:
          type: string
          format: uri
          description: Tracked redirect URL that opens the upstream provider page for claiming the giveaway.
          example: https://www.gamerpower.com/open/moonrise-fall-steam-giveaway
        published_date:
          type: string
          description: Date and time the giveaway was published on GamerPower, in `YYYY-MM-DD HH:MM:SS` format (UTC).
          example: '2026-05-30 13:57:19'
        type:
          type: string
          description: Category of the offer (Game, DLC, Loot, Early Access, etc.).
          example: Game
        platforms:
          type: string
          description: Comma-separated list of human-readable platform names the offer applies to.
          example: PC, Steam
        end_date:
          type: string
          description: Date and time the giveaway expires, in `YYYY-MM-DD HH:MM:SS` format (UTC). May be `N/A` for offers without an explicit end date.
          example: '2026-06-02 23:59:00'
        users:
          type: integer
          description: Count of GamerPower users who have viewed or claimed the giveaway. Acts as a popularity signal.
          example: 1310
        status:
          type: string
          description: Lifecycle status of the giveaway.
          enum:
          - Active
          - Expired
          example: Active
        gamerpower_url:
          type: string
          format: uri
          description: Canonical GamerPower page URL for the giveaway.
          example: https://www.gamerpower.com/moonrise-fall-steam-giveaway
        open_giveaway:
          type: string
          format: uri
          description: Alias of `open_giveaway_url`. Present on list responses; omitted on single-giveaway lookups.
          example: https://www.gamerpower.com/open/moonrise-fall-steam-giveaway
    SortBy:
      type: string
      description: Sort key for giveaway list responses.
      enum:
      - date
      - value
      - popularity
    GiveawayList:
      type: array
      description: An array of live Giveaway records.
      items:
        $ref: '#/components/schemas/Giveaway'
    StatusEnvelope:
      type: object
      description: Status envelope returned when an endpoint returns no result, a not-found, or a server-side error.
      required:
      - status
      - status_message
      properties:
        status:
          type: integer
          description: Numeric status code (0 indicates no result / not found).
          example: 0
        status_message:
          type: string
          description: Human-readable status message.
          example: No object found, please check the correct parameters.