Get published game

GET

store

games

{gameId}

cURL

curl --request GET \
  --url https://api.summer.games/v1/store/games/{gameId}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.summer.games/v1/store/games/{gameId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.summer.games/v1/store/games/{gameId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.summer.games/v1/store/games/{gameId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "gameId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "tags": [
    "<string>"
  ],
  "supportedPlatforms": [
    "android"
  ],
  "languages": [
    "<string>"
  ],
  "media": [
    {
      "assetId": "<string>",
      "kind": "IMAGE",
      "url": "<string>",
      "expiresAt": "2023-11-07T05:31:56Z",
      "variants": [
        {
          "size": 128,
          "width": 1024,
          "height": 1024,
          "url": "<string>",
          "contentType": "image/jpeg"
        }
      ]
    }
  ],
  "publishedAt": "2023-11-07T05:31:56Z",
  "accessModel": "free",
  "availability": {
    "playable": true,
    "reason": "<string>",
    "releaseId": "<string>",
    "buildId": "<string>"
  },
  "featuredItems": [
    {
      "itemId": "<string>",
      "gameId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "media": [
        {
          "assetId": "<string>",
          "kind": "IMAGE",
          "url": "<string>",
          "expiresAt": "2023-11-07T05:31:56Z",
          "variants": [
            {
              "size": 128,
              "width": 1024,
              "height": 1024,
              "url": "<string>",
              "contentType": "image/jpeg"
            }
          ]
        }
      ],
      "price": {
        "sparksAmount": 123,
        "zoneId": "<string>",
        "offerId": "<string>"
      },
      "backgroundColor": "<string>"
    }
  ],
  "supportItems": [
    {
      "itemId": "<string>",
      "gameId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "media": [
        {
          "assetId": "<string>",
          "kind": "IMAGE",
          "url": "<string>",
          "expiresAt": "2023-11-07T05:31:56Z",
          "variants": [
            {
              "size": 128,
              "width": 1024,
              "height": 1024,
              "url": "<string>",
              "contentType": "image/jpeg"
            }
          ]
        }
      ],
      "price": {
        "sparksAmount": 123,
        "zoneId": "<string>",
        "offerId": "<string>"
      },
      "backgroundColor": "<string>"
    }
  ],
  "minimumAge": 3,
  "communityRating": {
    "source": "summer_db",
    "status": "available",
    "entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "methodology": "<string>",
    "revision": 4503599627370495,
    "count": 4503599627370495,
    "average": 5.5,
    "observedAt": "2023-11-07T05:31:56Z",
    "checkedAt": "2023-11-07T05:31:56Z"
  },
  "slug": "<string>",
  "subtitle": "<string>",
  "releaseUpdatedAt": "2023-11-07T05:31:56Z",
  "listingUpdatedAt": "2023-11-07T05:31:56Z",
  "icon": {
    "assetId": "<string>",
    "kind": "IMAGE",
    "url": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "variants": [
      {
        "size": 128,
        "width": 1024,
        "height": 1024,
        "url": "<string>",
        "contentType": "image/jpeg"
      }
    ]
  },
  "release": {
    "comingSoon": true,
    "precision": "day",
    "date": "<string>"
  },
  "systemRequirements": {},
  "aiDisclosure": {},
  "contentSurvey": {},
  "mediaSlots": {},
  "storeArt": {
    "desktop": {
      "screenshots": [
        "<string>"
      ],
      "trailers": [
        {
          "assetId": "<string>",
          "posterAssetId": "<string>"
        }
      ],
      "keyArt": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "capsuleTall": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "capsuleWide": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "icon": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      }
    },
    "mobile": {
      "screenshots": [
        "<string>"
      ],
      "icon": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "tallCover": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "keyArt": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      }
    }
  },
  "longDescription": "<string>",
  "genres": [
    "<string>"
  ],
  "features": [
    "single_player"
  ],
  "credits": {
    "developer": "<string>",
    "publisher": "<string>",
    "franchise": "<string>"
  },
  "languageSupport": [
    {
      "code": "<string>",
      "interface": true,
      "fullAudio": true,
      "subtitles": true
    }
  ],
  "externalLinks": [
    {
      "kind": "website",
      "url": "<string>"
    }
  ],
  "mobile": {
    "subtitle": "<string>",
    "description": "<string>"
  },
  "price": {
    "currency": "USD",
    "baseMinor": 51,
    "finalMinor": 51,
    "discountPercent": 45,
    "purchasable": true,
    "dealEndsAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "correlationId": "<string>"
  }
}

Path Parameters

gameId

string

required

Required string length: 1 - 128

Query Parameters

includeBackgroundColor

boolean

default:false

Opt in to creator-selected item preview backgrounds; omitted or false preserves the original item response.

platform

enum<string>

Available options:

android,

ios,

linux,

macos,

web,

windows

includeImageVariants

boolean

default:false

Opt in to optional image size metadata. Omitted by default for compatibility with strict older clients; the default image URL still serves the web version when available.

Response

Success. Cache behavior is unchanged by public access; honor response Cache-Control.

gameId

string

required

Required string length: 1 - 128

name

string

required

description

string

required

tags

string[]

required

supportedPlatforms

enum<string>[]

required

Available options:

android,

ios,

linux,

macos,

web,

windows

languages

string[]

required

media

object[]

required

Show child attributes

publishedAt

string<date-time>

required

accessModel

enum<string>

required

A paid Game is played by players holding its license; free Games need none.

Available options:

free,

paid

availability

object

required

Show child attributes

featuredItems

object[]

required

Creator order with unavailable Items omitted, using current offers and media. Detail is private no-store; acquisition still requires a fresh trusted quote.

Maximum array length: 6

Show child attributes

supportItems

object[]

required

The Game's published Support Items (tagged support-item), cheapest first, with current offers and media. They are the tip choices for the Game's creator. Buying one is an ordinary Game Shop purchase through purchase-requests at the ordinary split; it is never a transfer to the creator. Empty when the Game has none.

Maximum array length: 4

Show child attributes

minimumAge

enum<integer> | null

Declared minimum age from the published listing. Null or absent means All ages, the default. This is not a certified rating or an access restriction.

Available options:

3,

7,

12,

16,

18,

null

communityRating

object

Summer DB owns community scores. Missing authority or identity never implies zero votes. This is independent of content-age classification, discovery rank and playability.

Show child attributes

slug

string

Current globally unique registry slug for public URLs. Listing title edits do not change it; gameId remains the durable identity.

subtitle

string

Maximum string length: 160

releaseUpdatedAt

string<date-time>

Latest recorded non-Preview release activation for the Game, shared across device platforms. Rollback or recovery to a different release updates this date; notes and listing corrections do not. Omitted when activation history is unknown.

listingUpdatedAt

string<date-time>

Latest approved listing activation, not a playable release update. Absent in draft previews and older retained cards.

icon

object

The revision's selected Game icon, when one is published. It is also present in media.

Show child attributes

release

object

The creator's declared release, absent when none was declared (the Game is out). A Coming Soon Game is listed but cannot be bought, played or downloaded; its availability reason is coming_soon.

Show child attributes

systemRequirements

object

Minimum and optional recommended requirements per desktop platform (windows, macos, linux), each {minimum, recommended?} of free-text os, processor, memory, graphics, storage, network and notes. Absent when not declared.

aiDisclosure

object

{uses: [assets|code|generatedGameplay], description?}; an empty uses array means the creator declared no AI use. Absent when not declared.

contentSurvey

object

Mature-content answers (violence, bloodGore, sexualContent, nudity, language, substances, gambling levels; userGeneratedContent, onlineInteraction, inGamePurchases flags; notes). Absent when not declared.

mediaSlots

object

Named media among media[] as the creator named it: flat {keyArt?: {assetId, focalPoint: {x, y} as 0..1 fractions from the top left}, screenshots?: [assetId], trailers?: [{assetId, posterAssetId}]} (the desktop slots named before flows), plus desktop?: {keyArt?, capsuleTall?, capsuleWide?, icon?, screenshots?, trailers?} and mobile?: {icon?, tallCover?, keyArt?, screenshots?}, each image as {assetId, focalPoint}. Absent when the creator named none. Render from storeArt, which applies the fallbacks.

storeArt

object

The art each storefront flow renders, with fallbacks applied, so every client picks the same image for a slot. desktop is the summer.games website and the desktop app; mobile is the iPhone and Android apps. Each image names an asset in media[]; render it from that entry (icons from the 256 or 512 variant). Crop every image to its frame at its focal point. Titles, taglines and buttons are drawn by the client, never baked into this art.

Show child attributes

longDescription

string

About this game, plain text; blank lines separate paragraphs. Render as text, never as HTML. description stays the short description. Absent when not declared.

genres

string[]

1 to 5 Game tag IDs of category genre (see GET /v1/store/tags for labels), in the creator's order. Absent when not declared.

features

enum<string>[]

Store page features in the creator's order. Clients should ignore values they do not know. Absent when not declared.

Available options:

single_player,

online_multiplayer,

local_multiplayer,

online_coop,

local_coop,

cross_platform,

controller_full,

controller_partial,

cloud_saves,

plays_in_browser,

level_editor,

achievements,

in_game_purchases

credits

object

Absent when not declared.

Show child attributes

languageSupport

object[]

Per-language support in code order; its codes equal languages. Absent when not declared (then only languages is known).

Show child attributes

externalLinks

object[]

Creator links in the creator's order; https only, social kinds restricted to their service's hosts. Clients should ignore kinds they do not know. Absent when not declared.

Show child attributes

mobile

object

The iPhone and Android apps' own text. A null field means use subtitle or description. Absent when the phone apps use the desktop text for both.

Show child attributes

price

object

What a player pays now for a paid Game, in minor units. Present only when accessModel is paid.

Show child attributes

⌘I

cURL

curl --request GET \
  --url https://api.summer.games/v1/store/games/{gameId}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.summer.games/v1/store/games/{gameId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.summer.games/v1/store/games/{gameId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.summer.games/v1/store/games/{gameId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "gameId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "tags": [
    "<string>"
  ],
  "supportedPlatforms": [
    "android"
  ],
  "languages": [
    "<string>"
  ],
  "media": [
    {
      "assetId": "<string>",
      "kind": "IMAGE",
      "url": "<string>",
      "expiresAt": "2023-11-07T05:31:56Z",
      "variants": [
        {
          "size": 128,
          "width": 1024,
          "height": 1024,
          "url": "<string>",
          "contentType": "image/jpeg"
        }
      ]
    }
  ],
  "publishedAt": "2023-11-07T05:31:56Z",
  "accessModel": "free",
  "availability": {
    "playable": true,
    "reason": "<string>",
    "releaseId": "<string>",
    "buildId": "<string>"
  },
  "featuredItems": [
    {
      "itemId": "<string>",
      "gameId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "media": [
        {
          "assetId": "<string>",
          "kind": "IMAGE",
          "url": "<string>",
          "expiresAt": "2023-11-07T05:31:56Z",
          "variants": [
            {
              "size": 128,
              "width": 1024,
              "height": 1024,
              "url": "<string>",
              "contentType": "image/jpeg"
            }
          ]
        }
      ],
      "price": {
        "sparksAmount": 123,
        "zoneId": "<string>",
        "offerId": "<string>"
      },
      "backgroundColor": "<string>"
    }
  ],
  "supportItems": [
    {
      "itemId": "<string>",
      "gameId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "media": [
        {
          "assetId": "<string>",
          "kind": "IMAGE",
          "url": "<string>",
          "expiresAt": "2023-11-07T05:31:56Z",
          "variants": [
            {
              "size": 128,
              "width": 1024,
              "height": 1024,
              "url": "<string>",
              "contentType": "image/jpeg"
            }
          ]
        }
      ],
      "price": {
        "sparksAmount": 123,
        "zoneId": "<string>",
        "offerId": "<string>"
      },
      "backgroundColor": "<string>"
    }
  ],
  "minimumAge": 3,
  "communityRating": {
    "source": "summer_db",
    "status": "available",
    "entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "methodology": "<string>",
    "revision": 4503599627370495,
    "count": 4503599627370495,
    "average": 5.5,
    "observedAt": "2023-11-07T05:31:56Z",
    "checkedAt": "2023-11-07T05:31:56Z"
  },
  "slug": "<string>",
  "subtitle": "<string>",
  "releaseUpdatedAt": "2023-11-07T05:31:56Z",
  "listingUpdatedAt": "2023-11-07T05:31:56Z",
  "icon": {
    "assetId": "<string>",
    "kind": "IMAGE",
    "url": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "variants": [
      {
        "size": 128,
        "width": 1024,
        "height": 1024,
        "url": "<string>",
        "contentType": "image/jpeg"
      }
    ]
  },
  "release": {
    "comingSoon": true,
    "precision": "day",
    "date": "<string>"
  },
  "systemRequirements": {},
  "aiDisclosure": {},
  "contentSurvey": {},
  "mediaSlots": {},
  "storeArt": {
    "desktop": {
      "screenshots": [
        "<string>"
      ],
      "trailers": [
        {
          "assetId": "<string>",
          "posterAssetId": "<string>"
        }
      ],
      "keyArt": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "capsuleTall": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "capsuleWide": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "icon": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      }
    },
    "mobile": {
      "screenshots": [
        "<string>"
      ],
      "icon": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "tallCover": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      },
      "keyArt": {
        "assetId": "<string>",
        "focalPoint": {
          "x": 0.5,
          "y": 0.5
        },
        "fallbackFrom": "<string>"
      }
    }
  },
  "longDescription": "<string>",
  "genres": [
    "<string>"
  ],
  "features": [
    "single_player"
  ],
  "credits": {
    "developer": "<string>",
    "publisher": "<string>",
    "franchise": "<string>"
  },
  "languageSupport": [
    {
      "code": "<string>",
      "interface": true,
      "fullAudio": true,
      "subtitles": true
    }
  ],
  "externalLinks": [
    {
      "kind": "website",
      "url": "<string>"
    }
  ],
  "mobile": {
    "subtitle": "<string>",
    "description": "<string>"
  },
  "price": {
    "currency": "USD",
    "baseMinor": 51,
    "finalMinor": 51,
    "discountPercent": 45,
    "purchasable": true,
    "dealEndsAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "correlationId": "<string>"
  }
}

Overview

MCP tools

HTTP API

GDScript API

Migration and extensions

MCP

Path Parameters

Query Parameters

Response