omniplay/gog

GOG for omnisense/omniplay, with no key: a product's record with its price in a country, and the store's search with prices, studios, genres, tags and the store's rating. These are the endpoints GOG's own store and GOG Galaxy use; GOG publishes no API terms for them. The provider calls:

No library or ownership: GOG offers no way for a third party to read a player's games.

Installation

composer require omniplay/gog

Requires PHP 8.2, omnisense/omniplay (1.x) and symfony/http-client (6.4, 7 or 8).

Credentials

None.

Options

Capabilities

attribution: Data from GOG.com.

Behaviour

A record. Two calls: the product, then its prices in the country. A product without a title is null.

Developers, publishers, genres and ratings are not in the product API's answer: the search gives them.

Search. Each product: number, title, storeLink, release date (Y.m.d), upcoming as coming soon, developers, publishers, genres, tags, operating systems, the price in currency (finalMoney, baseMoney, the discount computed), coverVertical (Cover) and coverHorizontal (Header), reviewsRating divided by 10 as a rating out of 5.

Example

Run live on 2026-10-27 (06:24 UTC), in the core's harness - two calls:

<?php

require __DIR__.'/vendor/autoload.php';

use Omniplay\Gog\GogFactory;
use Omniplay\Model\GameRef;
use Symfony\Component\HttpClient\HttpClient;

$gog = (new GogFactory(HttpClient::create(['timeout' => 30])))->create();
$g = $gog->game(GameRef::gog(1207658924), 'fr', 'FR');
printf("%s %s, %.2f %s (-%d%%), %s\n", $g->title, $g->released?->format('Y-m-d'), $g->price->amount / 100, $g->price->currency, $g->price->discount, $g->url);

The Witcher: Enhanced Edition 2011-05-09, 1.19 EUR (-85%), https://www.gog.com/game/the_witcher

On the answers recorded on 2026-10-24, the record's other fields (no studio: the product API names none):

The Witcher: Enhanced Edition | 2011-05-09 | 119 EUR initial 799 -85%
  summary The Witcher est un jeu de rôles dans un monde sombre et fantastique où
  logo https://images-2.gog-statics.com/37d4a208d1f5bb0e163da540ac894ba46a7d566ede31aaaefc74bbcd46ebd190_glx_logo_2x.jpg
  background https://images-2.gog-statics.com/c73009d18e964448b9704ad9d69a7c68bab5f8a10df410254bb511f2f9198a3a.jpg
  icon https://images-4.gog-statics.com/82ecfe17e7c3fa7fe3252664927ba9b0014ca17039d8ec1b46275677ab7a7898.png
  > GET https://api.gog.com/products/1207658924 {"expand":"description","locale":"fr-FR"}
  > GET https://api.gog.com/products/1207658924/prices {"countryCode":"FR"}

In Symfony:

services:
    Omniplay\Gog\GogFactory:
        arguments: ['@http_client']
    Omniplay\Registry:
        arguments:
            $factories: ['@Omniplay\Gog\GogFactory']
            $config:
                gog: { factory: gog, options: { locale: fr-FR, country: FR, currency: EUR } }

Errors

Unknown product: null; a ref that is not a GOG number: NotSupportedException; a status of 400 or more but 404, or a body that is not JSON: ProviderException; a network error: UnreachableException.

Verified, and not

Tested offline (Tests/GogProviderTest.php, in the core's harness, PHP 8.4), on answers recorded on 2026-10-24: The Witcher's record in French with its French price (1,19 € instead of 7,99 €, 85 % off that day), an unknown product, a search. Tests/BareTest.php loads every class with the package's requirements alone. Verified live: Tests/LiveTest.php on 2026-10-24 (a product with its US price, a search), and the example above on 2026-10-27.

Responsibility

An independent, unofficial client, affiliated with GOG in no way. GOG publishes no terms for these endpoints; its user agreement governs the store. Keep to a gentle pace, keep what you read, and link to the game's page on GOG: see the README.