Board Game Oracle Public Game & Price Pages

Look up a board game by name and extract metadata and visible price offers from its public Board Game Oracle page. Results are useful for game catalogs and price comparisons; missing page fields stay unknown.

Start with a game name

Enter gameName and a small maxGames value. For example:

{"gameName":"Gloomhaven","maxGames":1,"includeWikidataEnrichment":false}

The Actor uses public search and detail HTML. Genre/category feeds, compact JSON search, internal API fallbacks and Wikidata enrichment are unavailable. Legacy genre and enrichment fields remain accepted; they do not enable an API request. A blocked or unmatched page does not establish that a game or offer does not exist.

Output

Illustrative output; replace source values with your own authorized evidence.

{
  "type": "game",
  "source": "boardgameoracle",
  "scrapedAt": "2026-05-10T20:00:00.000Z",
  "boardGameOracleId": "5c5c1177cb4c08209f09c53d",
  "boardGameOracleKey": "bHh_KByEbG",
  "bggId": 174430,
  "wikidataId": "Q36816341",
  "inputSource": "gameName",
  "dataInputSource": "provided",
  "sourceVerified": false
}

The dataset contains source-linked game records with the available title, identifiers, descriptions, categories, mechanics, publisher or designer details and price offers. Only values exposed by a collected page are included. Field coverage varies by page and country. See the run summary for source errors, output limits and partial coverage. No child Actors are used.

Run with Python

import os
from apify_client import ApifyClient
client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('thescrapelab/board-game-oracle-game-metadata-scraper').call(run_input={'gameName':'Gloomhaven','maxGames':1,'includeWikidataEnrichment':False})
if run is None:
    raise RuntimeError("Actor did not return run metadata")
dataset_id = run["defaultDatasetId"] if isinstance(run, dict) else run.default_dataset_id
for row in client.dataset(dataset_id).iterate_items():
    print(row)

Check the Pricing tab and set a spending cap. Start fees and platform usage can apply to failed or empty runs. This independent Actor is not affiliated with Board Game Oracle or BoardGameGeek.

Example input

Illustrative input; replace source values with your own authorized evidence.

{
  "genre": "",
  "gameName": "Gloomhaven",
  "maxGames": 1,
  "includeWikidataEnrichment": false,
  "performanceMode": "cost"
}

Support

Open the Actor Issues tab with a run ID and a sanitized input example. Review the run output and collection/validation summary when a source is blocked, input is invalid or fewer results are returned.