# GameNerdz Scraper - Board & Card Game Deals (`lulzasaur/gamenerdz-scraper`) Actor Scrape GameNerdz (gamenerdz.com), a discount board & card game retailer. Search products for title, price, MSRP, discount %, availability, stock, image and URL from the store search API. Optional detail enrichment adds publisher/brand and category. Prefill 'catan' or 'magic'. - **URL**: https://apify.com/lulzasaur/gamenerdz-scraper.md - **Developed by:** [lulz bot](https://apify.com/lulzasaur) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GameNerdz Scraper - Board & Card Game Deals Scrape [GameNerdz](https://www.gamenerdz.com/), a popular discount board game and card game retailer, for product search results. Great for price monitoring, deal hunting, competitive pricing analysis, and building game-price datasets. For each product matching your search you get: - **Title** (full product name) - **Publisher / brand** (e.g. "Catan Studios Inc.", "Wizards of the Coast") - **Category** (e.g. "Board Games", "Card Games", "Miniatures") - **Price** (GameNerdz' discounted selling price) - **MSRP** and **discount %** off MSRP - **Availability** and **stock** level (in stock / out of stock) - **Image** URL and **product URL** - Product tags and search query ### Input ```json { "searchQueries": ["catan", "magic"], "maxItems": 100, "onlyInStock": false, "scrapeDetails": true } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchQueries` | string\[] | `["catan"]` | Product searches to run (e.g. `catan`, `magic`, `ticket to ride`). | | `maxItems` | integer | `100` | Max products to return per query. | | `onlyInStock` | boolean | `false` | Only return products currently in stock. | | `scrapeDetails` | boolean | `true` | Fetch each product page to add publisher/brand and category. Disable for a faster, price-only scrape. | | `proxyConfiguration` | object | none | Optional proxy. The search API is open and usually works without one. | ### Output Each dataset item: ```json { "productId": 36943, "title": "Catan: Starfarers", "publisher": "Catan Studios Inc.", "category": "Board Games", "price": 107.99, "msrp": 134.99, "discountPercent": 20, "onSale": true, "availability": "available", "stock": 4, "inStock": true, "image": "https://cdn11.bigcommerce.com/s-ua4dd/products/36943/images/117200/...jpg", "url": "https://www.gamenerdz.com/catan-starfarers", "searchQuery": "catan", "source": "gamenerdz.com" } ``` ### Notes - Data comes from GameNerdz' public store search API — no login required. - Publisher and category are read from the product page's schema.org data; set `scrapeDetails: false` to skip that step for speed. - Please use responsibly and respect GameNerdz' Terms of Service. # Actor input Schema ## `searchQueries` (type: `array`): Product searches to run on GameNerdz (e.g. 'catan', 'magic', 'ticket to ride'). Each query returns matching board/card game products with price, MSRP and discount. ## `maxItems` (type: `integer`): Maximum number of products to return per search query. ## `onlyInStock` (type: `boolean`): Only return products that currently have stock available for purchase. ## `scrapeDetails` (type: `boolean`): Fetch each product's detail page to add publisher/brand and category (from schema.org data). Slower but richer. Disable for a faster, price-only scrape. ## `proxyConfiguration` (type: `object`): Proxy settings. GameNerdz's search API is open and usually works without a proxy; enable Apify Proxy only if you hit rate limits. ## Actor input object example ```json { "searchQueries": [ "catan" ], "maxItems": 100, "onlyInStock": false, "scrapeDetails": true, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "catan" ] }; // Run the Actor and wait for it to finish const run = await client.actor("lulzasaur/gamenerdz-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["catan"] } # Run the Actor and wait for it to finish run = client.actor("lulzasaur/gamenerdz-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "catan" ] }' | apify call lulzasaur/gamenerdz-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lulzasaur/gamenerdz-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GameNerdz Scraper - Board & Card Game Deals", "description": "Scrape GameNerdz (gamenerdz.com), a discount board & card game retailer. Search products for title, price, MSRP, discount %, availability, stock, image and URL from the store search API. Optional detail enrichment adds publisher/brand and category. Prefill 'catan' or 'magic'.", "version": "1.0", "x-build-id": "z420wKRxL1Ew9GVfe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lulzasaur~gamenerdz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lulzasaur-gamenerdz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lulzasaur~gamenerdz-scraper/runs": { "post": { "operationId": "runs-sync-lulzasaur-gamenerdz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lulzasaur~gamenerdz-scraper/run-sync": { "post": { "operationId": "run-sync-lulzasaur-gamenerdz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Product searches to run on GameNerdz (e.g. 'catan', 'magic', 'ticket to ride'). Each query returns matching board/card game products with price, MSRP and discount.", "default": [ "catan" ], "items": { "type": "string" } }, "maxItems": { "title": "Max Items per Query", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of products to return per search query.", "default": 100 }, "onlyInStock": { "title": "Only In Stock", "type": "boolean", "description": "Only return products that currently have stock available for purchase.", "default": false }, "scrapeDetails": { "title": "Scrape Publisher & Category", "type": "boolean", "description": "Fetch each product's detail page to add publisher/brand and category (from schema.org data). Slower but richer. Disable for a faster, price-only scrape.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. GameNerdz's search API is open and usually works without a proxy; enable Apify Proxy only if you hit rate limits.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```