--- title: GameBrain API slug: gamebrain-api url: https://apyhub.com/skycraft/service/gamebrain-api provider: Skycraft categories: [Data Extraction, Developer Tools] auth: api_key version: 1.0.2 service_type: sync endpoints: 5 atoms: 20 mcp: true --- # GameBrain API Search games, fetch detailed metadata, find similar titles, and load game news. Useful for catalogs, recommendations, autocomplete, and editorial tools. ## Endpoints | Method | URL | Description | Atoms | | --- | --- | --- | --- | | GET | `https://api.eu.apyhub.com/skycraft/gamebrain-api/games` | What it does Searches for games using the provided query, paging, sorting, and filter parameters, t… | 20 | | GET | `https://api.eu.apyhub.com/skycraft/gamebrain-api/games/suggestions` | What it does Returns game suggestions matching a query string, limited by the requested number of r… | 20 | | GET | `https://api.eu.apyhub.com/skycraft/gamebrain-api/games/details/:id` | What it does Retrieves the details for a single game identified by its numeric id. The response ret… | 20 | | GET | `https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/similar` | What it does Returns a list of games similar to the game identified by the path id. The number of r… | 20 | | GET | `https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/news` | What it does Retrieves news items for a specific game, identified by its numeric id, with paginatio… | 20 | ## Endpoint reference ### Search Games `GET https://api.eu.apyhub.com/skycraft/gamebrain-api/games` · 20 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `sort` | query | string | yes | Example: `computed_rating`. | | `limit` | query | integer (int32) | yes | Default: `10`. Example: `10`. | | `query` | query | string | yes | Example: `rpg for PC`. | | `offset` | query | integer (int32) | yes | Default: `0`. Example: `0`. | | `filters` | query | string | yes | Default: `[]`. Example: `[{"key":"platform","values":[{"value":"pc"}],"connection":"OR"},{"key":"genre",…`. | | `sort-order` | query | string | yes | Default: `asc`. Example: `asc`. | | `generate-filter-options` | query | boolean | yes | Default: `true`. Example: `false`. | #### Quickstart Search for games with the required query parameters and return the first page of results. ```bash curl -X GET "https://api.eu.apyhub.com/skycraft/gamebrain-api/games?query=rpg%20for%20PC&offset=0&limit=10&filters=%5B%5D&sort=computed_rating&sort-order=asc&generate-filter-options=true" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with `limit`, `query`, `offset`, `results`, `sorting`, `total_results`, `filter_options`, `sorting_options`, and `active_filter_options` fields. - `limit`, `offset`, and `total_results` are integers. - `query` is the search string you sent. - `results` is an array of game objects. - `sorting` is an object with `key` and `direction`. - `filter_options`, `sorting_options`, and `active_filter_options` are arrays describing available and active filters/sorting. ```json { "sorting": { "key": null, "direction": null }, "active_filter_options": [ { "key": "genre", "connection": "AND", "values": [ { "match": "rpg", "value": "role_playing" } ] }, { "key": "platform", "connection": "AND", "values": [ { "match": "pc", "value": "pc" } ] } ], "query": "rpg for pc", "total_results": 47198, "limit": 3, "offset": 0, "results": [ { "id": 104935, "year": 2023, "name": "Baldur's Gate 3", "genre": "Tactical Role Playing", "image": "https://img.gamebrain.co/games/267/baldurs_gate_3_larian_2023_93.webp", "link": "https://gamebrain.co/game/baldurs-gate-3", "rating": { "mean": 0.9589789637681159, "count": 708249 }, "adult_only": true, "screenshots": [ "https://img.gamebrain.co/games/195/baldurs_gate_3_larian_2020_112.jpg" ], "micro_trailer": "https://cdn.akamai.steamstatic.com/steam/apps/256932354/microtrailer.webm", "gameplay": "https://www.youtube-nocookie.com/embed/FXyldfVAF9A", "short_description": null } ], "sorting_options": [ { "name": "Rating", "sort": "DESC", "key": "computed_rating" }, { "name": "Price", "sort": "ASC", "key": "price" }, { "name": "Release Date", "sort": "DESC", "key": "release_date" } ] } ``` ### Get Game Suggestions `GET https://api.eu.apyhub.com/skycraft/gamebrain-api/games/suggestions` · 20 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `limit` | query | integer (int32) | yes | Default: `10`. Example: `10`. | | `query` | query | string | yes | Example: `gt`. | #### Quickstart Search for games by query and limit the number of matches returned. ```bash curl -X GET "https://api.eu.apyhub.com/skycraft/gamebrain-api/games/suggestions?query=gt&limit=10" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with a `results` array. Each item in `results` is an object that may include `id`, `link`, `name`, `year`, `genre`, `image`, `rating` (with `mean` and `count`), and `adult_only`. ```json { "results": [ { "id": 123, "link": "https://example.com/game/123", "name": "Example Game", "year": 2024, "genre": "Action", "image": "https://example.com/image.jpg", "rating": { "mean": 4.5, "count": 120 }, "adult_only": false } ] } ``` ### Get Game Details `GET https://api.eu.apyhub.com/skycraft/gamebrain-api/games/details/:id` · 20 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `id` | path | integer (int32) | yes | | #### Quickstart Fetch a game by its numeric `id` path parameter. ```bash curl -X GET "https://api.eu.apyhub.com/skycraft/gamebrain-api/games/details/:id" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with fields such as `id` (integer), `link` (URI), `name` (string), and `short_description` (string), along with other optional game metadata when available. ```json { "id": 104935, "name": "Baldur's Gate 3", "image": "https://img.gamebrain.co/games/267/baldurs_gate_3_larian_2023_93.webp", "image_aspect_ratio": 1.0, "gameplay": "https://www.youtube-nocookie.com/embed/FXyldfVAF9A", "link": "https://gamebrain.co/game/baldurs-gate-3", "x_url": "https://twitter.com/baldursgate3", "rating": { "mean": 0.9589789637681159, "count": 708249, "mean_players": 0.967813, "count_players": 708180, "mean_critics": 0.9501449275362318, "count_critics": 69 }, "description": "An ancient evil has returned to Baldur's Gate, intent on devouring it from the inside out. The fate of Faerun lies in your hands. Alone, you may resist. But together, you can overcome.", "short_description": "An ancient evil has returned to Baldur's Gate, intent on devouring it from the inside out. The fate of Faerun lies in your hands. Alone, you may resist. But together, you can overcome.", "release_date": "2023-12-08", "developer": "Larian Studios", "platforms": [ { "value": "gog_com", "name": "Gog Com" }, { "value": "pc", "name": "PC" } ], "genres": [ { "value": "role_playing", "name": "Role Playing" } ], "genre": "Tactical Role Playing", "adult_only": true, "screenshots": [ "https://img.gamebrain.co/games/195/baldurs_gate_3_larian_2020_112.jpg" ], "videos": [ "https://www.youtube-nocookie.com/embed/t0uYhTLPGLQ" ], "twitch_videos": [ { "id": "AbnegatePlayfulPelicanVoHiYo-5roWs9yGqWTZsxot", "url": "https://www.twitch.tv/cohhcarnage/clip/AbnegatePlayfulPelicanVoHiYo-5roWs9yGqWTZsxot", "creator_name": "TheCombatantWombat", "view_count": 229815 } ], "offers": [ { "price": { "value": 59.99, "currency": "USD", "initial": 59.99, "discount_percent": 0.0 }, "store_name": "steam", "platform": "PC", "url": "https://store.steampowered.com/app/1086940" } ], "micro_trailer": "https://cdn.akamai.steamstatic.com/steam/apps/256932354/microtrailer.webm" } ``` ### Get Similar Games `GET https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/similar` · 20 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `id` | path | integer (int32) | yes | Example: `104935`. | | `limit` | query | integer (int32) | yes | Default: `10`. Example: `10`. | #### Quickstart Fetch game records for a specific `id`, with `limit` sent as a query parameter. ```bash curl -X GET "https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/similar?limit=10" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with a `results` array. Each item in `results` is an object that may include fields like `id`, `link`, `name`, `year`, `genre`, `image`, `rating`, `gameplay`, `adult_only`, `screenshots`, `micro_trailer`, and `short_description`. ```json { "results": [ { "id": 378311, "year": 2017, "name": "Divinity: Original Sin 2", "genre": "Tactical Role Playing", "image": "https://img.gamebrain.co/games/668/divinity_original_sin_2_larian_2017_7.webp", "link": "https://gamebrain.co/game/divinity-original-sin-2", "rating": { "mean": 0.9363501136069805, "count": 89618 }, "adult_only": true, "screenshots": [ "https://img.gamebrain.co/games/718/divinity_original_sin_ii_larian_2018_5.jpg" ], "micro_trailer": "https://video.akamai.steamstatic.com/store_trailers/435150/121883/ccbcafb42a53360716b3c81a97ef8398bb580cc0/1750530604/dash_h264.mpd", "gameplay": "https://video.akamai.steamstatic.com/store_trailers/435150/121883/ccbcafb42a53360716b3c81a97ef8398bb580cc0/1750530604/dash_h264.mpd", "short_description": null } ] } ``` ### Get Game News `GET https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/news` · 20 atoms · accepts `application/json` · returns `application/json` | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `id` | path | integer (int32) | yes | Example: `104935`. | | `limit` | query | integer (int32) | yes | Default: `10`. Example: `10`. | | `offset` | query | integer (int32) | yes | Default: `0`. Example: `0`. | #### Quickstart Fetch the news list for a given game ID, using the required `id` path parameter and pagination query params. ```bash curl -X GET "https://api.eu.apyhub.com/skycraft/gamebrain-api/games/:id/news" \ -H "apy-token: $APY_TOKEN" ``` #### What you'll get back Returns a JSON object with a `news` array. Each item in `news` is an object with `title`, `url`, `source`, and `published` fields; `image` may also be present. ```json { "news": [ { "title": "Baldur's Gate 3 dev worries for Fallout: New Vegas studio Obsidian as Bethesda takes over management", "url": "https://www.gamesradar.com/games/fallout/baldurs-gate-3-publishing-lead-worries-for-fallout-new-vegas-dev-obsidian-as-bethesda-takes-over-management-of-the-studio-says-he-cant-imagine-that-feels-great", "source": "gamesradar.com", "image": "https://cdn.mos.cms.futurecdn.net/Dff8hpPZC9qpm7ZSGunL7N-1920-80.jpg", "published": "2026-09-23" }, { "title": "GTA 6 won't beat the GOTY record set by Baldur's Gate 3 and Clair Obscur: Expedition 33", "url": "https://www.gamesradar.com/games/grand-theft-auto/gta-6-will-not-be-eligible-to-complete-baldurs-gate-3-and-clair-obscur-expedition-33s-big-5-goty-sweep-in-the-2026-7-season", "source": "gamesradar.com", "image": "https://cdn.mos.cms.futurecdn.net/oFV96Lzam6D6cjSoxVEn9h-1920-80.jpg", "published": "2026-09-22" } ] } ``` ## About ## What it does GameBrain lets you search for games, fetch full game details, get similar titles, and pull related news in one place. Send a game ID or a search query, and get back structured game metadata that you can use in catalogs, recommendation features, storefronts, or content pages. Use **Search Games** to query by text and refine results with filters, sorting, offset, and limit. The response includes matching games plus total counts, sorting details, active filters, and optional filter and sorting options. **Get Game Details** returns the fields you need for a single title, including name, link, tags, genre, image, x_url, genres, offers, rating, themes, videos, gameplay, playtime, developer, platforms, play_modes, description, screenshots, release_date, micro_trailer, official_stores, short_description, and adult_only. When you need discovery data, **Get Similar Games** returns a results list with IDs, names, years, genres, images, ratings, gameplay links, screenshots, micro trailers, adult-only flags, and short descriptions. **Get Game Suggestions** is a lighter lookup for autocomplete-style matching, and **Get Game News** returns news items with title, url, source, published date, and optional image for a game ID. GameBrain is a fit for game search experiences, recommendation widgets, editorial tooling, and product pages that need up-to-date game metadata without scraping multiple sources. ## Usage Base URL: `https://api.eu.apyhub.com` (default region — see `GET https://apyhub.com/api/public/regions` for the rest). Authenticate with an ApyHub API key in the `apy-token` header. Full docs and a live playground: https://apyhub.com/skycraft/service/gamebrain-api