Listing

Endpoints used to list games and movies. Contrary to their names, they don’t actually need to filter anything.

GET /games/ajax/filtered

Searches for all available products matching the given criterias. Movies don’t support the parameters category, devpub, feature, release, system.

Query Parameters:  

• category – Game genre
• devpub – Developer or publisher
• feature – Game features
• language – Language
• mediaType – Game or movie
• page – Page number
• price – Price range
• release – Release timeframe
• search – Search string
• sort – Sort order
• system – OS
• limit – Max results

Example request:

GET /games/ajax/filtered?mediaType=game&search=Witcher HTTP/1.1
Host: embed.gog.com

Example response:

{
  "products": [
    {
      "customAttributes": [],
      "price": {
        "amount": "29.99",
        "baseAmount": "29.99",
        "finalAmount": "29.99",
        "isDiscounted": false,
        "discountPercentage": 0,
        "discountDifference": "0.00",
        "symbol": "€",
        "isFree": false,
        "discount": 0,
        "isBonusStoreCreditIncluded": false,
        "bonusStoreCreditAmount": "0.00"
      },
      "isDiscounted": false,
      "isInDevelopment": false,
      "id": 1207664663,
      "releaseDate": 1431982800,
      "availability": {
        "isAvailable": true,
        "isAvailableInAccount": true
      },
      "salesVisibility": {
        "isActive": true,
        "fromObject": {
          "date": "2015-05-19 02:00:00.000000",
          "timezone_type": 3,
          "timezone": "Europe/Nicosia"
        },
        "from": 1431990000,
        "toObject": {
          "date": "2020-12-31 23:59:59.000000",
          "timezone_type": 3,
          "timezone": "Europe/Nicosia"
        },
        "to": 1609451999
      },
      "buyable": true,
      "title": "Witcher 3: Wild Hunt, The ",
      "image": "//images-3.gog.com/60c724a052275a049d857d53957dc38e9347742f52372bb956d992b43efa8fb5",
      "url": "/game/the_witcher_3_wild_hunt",
      "supportUrl": "/support/the_witcher_3_wild_hunt",
      "forumUrl": "/forum/general",
      "worksOn": {
        "Windows": true,
        "Mac": false,
        "Linux": false
      },
      "category": "Role-playing",
      "originalCategory": "Role-playing",
      "rating": 49,
      "type": 2,
      "isComingSoon": false,
      "isPriceVisible": true,
      "isMovie": false,
      "isGame": true,
      "slug": "the_witcher_3_wild_hunt"
    }
  ],
  "ts": null,
  "page": "1",
  "totalPages": 1,
  "totalResults": "1",
  "totalGamesFound": 1,
  "totalMoviesFound": 0
}

GET /account/getFilteredProducts

Searches for products owned by the user matching the given criterias. Movies don’t support the parameters category, feature, system.

Query Parameters:  

• category – Genre
• feature – Feature
• hiddenFlag – Show hidden products
• language – Language
• mediaType – Game or movie
• page – Page number
• search – Search string
• sortBy – Sort order
• system – OS
• tags – Tags
• totalPages – Total Pages

Example request:

GET /account/getFilteredProducts?mediaType=1&search=Shadowrun HTTP/1.1
Host: embed.gog.com

Example response:

{
  "sortBy": "date_purchased",
  "page": 1,
  "totalProducts": 1,
  "totalPages": 1,
  "productsPerPage": 100,
  "contentSystemCompatibility": null,
  "moviesCount": 1,
  "tags": [
    {
      "id": "243982903",
      "name": "COMPLETED",
      "productCount": "0"
    },
    {
      "id": "243982893",
      "name": "NEXT TO PLAY",
      "productCount": "0"
    },
    {
      "id": "243982883",
      "name": "BACKLOG",
      "productCount": "0"
    },
    {
      "id": "243982873",
      "name": "FAVORITE",
      "productCount": "0"
    }
  ],
  "products": [
    {
      "isGalaxyCompatible": true,
      "tags": [],
      "id": 1207660413,
      "availability": {
        "isAvailable": true,
        "isAvailableInAccount": true
      },
      "title": "Shadowrun Returns",
      "image": "//images-2.gog.com/6c35ecb988f57725cc0f385acf860241082da16eda9fab66115f4da883dae3d1",
      "url": "/game/shadowrun_returns",
      "worksOn": {
        "Windows": true,
        "Mac": true,
        "Linux": true
      },
      "category": "Role-playing",
      "rating": 41,
      "isComingSoon": false,
      "isMovie": false,
      "isGame": true,
      "slug": "shadowrun_returns",
      "updates": 0,
      "isNew": false,
      "dlcCount": 0,
      "releaseDate": {
        "date": "2013-07-25 00:00:00.000000",
        "timezone_type": 3,
        "timezone": "Europe/Nicosia"
      },
      "isBaseProductMissing": false,
      "isHidingDisabled": false,
      "isInDevelopment": false,
      "isHidden": false
    }
  ],
  "updatedProductsCount": 0,
  "hiddenUpdatedProductsCount": 0,
  "appliedFilters": {
    "tags": null
  },
  "hasHiddenProducts": false
}

GET /account/wishlist/search

Searches for games in the wishlist. Works the same as GET /account/getFilteredProducts, but adds a price and removes the tags filter.

Query Parameters:  

• price (int) – Price range of the product

GET /public_wishlist/(int: user_id)/search

Searches for games in the wishlist of a different user. Works the same as GET /account/wishlist/search.