Integrate via All Games API

Gamezop All Games API allows you to access data on our games so you can list them in your own UI.

The All Games API lets you access a list of games and associated details (description, screenshots etc.) so that you can directly launch games from your app / site instead of sending users to the Gamezop Game Centre.

Making the request

Get All Games

GET https://pub.gamezop.com/v3/games?id={PropertyID}&lang={ISOLangTag}

Get a list of games objects.

Query Parameters

Sample response

The response contains a single array games with multiple game objects. Each games object contains

If the API response contains any other keys besides the ones documented above, do not use those keys. They will be removed from the API.

Here's a sample API response

URL Param values in the sample API call:

  • id -> 3025

  • lang -> fr

Sample response with 1 games object.

{
  "games": [
    {
      "code": "41rGO1Gbqe",
      "url": "https://3025.play.gamezop.com/g/41rGO1Gbqe",
      "name": {
        "en": "Pixel Brothers",
        "fr": "Freres de pixel"
      },
      "isPortrait": true,
      "description": {
        "en": "Tap in the right direction to rotate the wheel and remain unscathed from monster attacks.",
        "fr": "Allez dans la bonne direction pour faire tourner la roue et rester indemne contre les attaques du monstre."
      },
      "gamePreviews": {
        "en": "https://youtu.be/YcTidw-ga_s",
        "fr": ""
      },
      "assets": {
        "cover": "https://static.gamezop.com/41rGO1Gbqe/cover.jpg",
        "brick": "https://static.gamezop.com/41rGO1Gbqe/brick.png",
        "thumb": "https://static.gamezop.com/41rGO1Gbqe/thumb.png",
        "wall": "https://static.gamezop.com/41rGO1Gbqe/wall.png",
        "square": "https://static.gamezop.com/41rGO1Gbqe/square.png",
        "screens": [
          "https://static.gamezop.com/41rGO1Gbqe/game-1.png",
          "https://static.gamezop.com/41rGO1Gbqe/game-2.png",
          "https://static.gamezop.com/41rGO1Gbqe/game-3.png"
        ],
        "coverTiny": "https://static.gamezop.com/41rGO1Gbqe/cover-tiny.jpg",
        "brickTiny": "https://static.gamezop.com/41rGO1Gbqe/brick-tiny.png"
      },
      "categories": {
        "en": [
          "Strategy"
        ],
        "fr": [
          "Stratégie"
        ]
      },
      "tags": {
        "en": [
          "Endless",
          "Exclusive",
          "Arcade",
          "Pixel",
          "Minimal",
          "Difficult"
        ],
        "fr": []
      },
      "width": 338,
      "height": 600,
      "colorMuted": "#5b5b5b",
      "colorVibrant": "#270282",
      "privateAllowed": true,
      "rating": 3.75,
      "numberOfRatings": 0,
      "gamePlays": 3531392,
      "hasIntegratedAds": true
    }
  ]
}

Caching the API response

We discourage integrating our API directly in your front-end project. Instead, request data from the All Games API from your servers, and cache the data at your end. Service your frontend requests from your own APIs using this data.

We strongly suggest you set up a cron to update the games data on your server once every 24 hours. We often add new games and update other data for existing games, which your users may not be able to access if you do not refresh your cache.

Looking for a deeper integration with our games? Check out Gamezop's advanced guides.

Last updated