# TCGPlayer Pricing Scraper - tcgcsv.com API Wrapper (`jungle_synthesizer/tcgcsv-tcgplayer-pricing-wrapper`) Actor Wrapper around tcgcsv.com — the nightly TCGPlayer pricing mirror. Covers 89+ TCGs: Magic, Pokemon, Yu-Gi-Oh, Lorcana, One Piece, Flesh & Blood, Star Wars Unlimited, and more. Walk sets or fetch specific cards. Sub-type-aware prices (Normal/Foil/Holofoil/1st Edition) with market/mid/low/high. - **URL**: https://apify.com/jungle\_synthesizer/tcgcsv-tcgplayer-pricing-wrapper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** E-commerce, Other - **Stats:** 7 total users, 1 monthly users, 99.4% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## TCGPlayer Pricing Scraper — tcgcsv.com API Wrapper Fetch current TCGPlayer card prices for any of 89+ trading card games via the community-maintained [tcgcsv.com](https://tcgcsv.com) nightly mirror. No API key required. Sub-type-aware pricing rows (Normal / Foil / Holofoil / Reverse Holo / 1st Edition) with market / mid / low / high / TCG-Direct breakdowns. Supported games include Magic: The Gathering, Pokemon (English + Japanese), Yu-Gi-Oh, Disney Lorcana, One Piece TCG, Flesh & Blood, Star Wars Unlimited, Final Fantasy, Digimon, Weiss Schwarz, and 80+ others. --- ### Modes | Mode | Description | |------|-------------| | `categories` | List all 89+ TCG categories with their IDs | | `category_walk` | Walk every set in a category and return all products + prices | | `group_walk` | Walk specific set(s) (default mode — fastest for targeted pulls) | | `by_product` | Look up specific TCGPlayer product IDs | The default input (Pokemon, group_walk, group 23237 = Scarlet & Violet 151) returns price rows immediately. Run `mode=categories` to discover all available category IDs. --- ### Inputs | Input | Type | Default | Description | |-------|------|---------|-------------| | `mode` | select | `group_walk` | Which data to fetch | | `categoryId` | integer | `3` (Pokemon) | TCG category (run categories mode to list all) | | `groupIds` | array | `["23237"]` | Set IDs to walk (mode=group_walk) | | `productIds` | array | `["501999"]` | Product IDs to look up (mode=by_product) | | `includePrices` | boolean | `true` | Join pricing rows | | `includeExtendedData` | boolean | `true` | Include rarity, number, type fields | | `onlyFoil` | boolean | `false` | Filter to foil/holo sub-types only | | `maxItems` | integer | `0` | Max rows (0 = unlimited) | #### Common Category IDs | ID | Game | |----|------| | 1 | Magic: The Gathering | | 2 | Yu-Gi-Oh | | 3 | Pokemon (English) | | 62 | Flesh & Blood | | 71 | Disney Lorcana | | 79 | One Piece TCG | | 85 | Pokemon (Japanese) | | 70 | DC Comics | | 65 | Gate Ruler | | 63 | Digimon | Run `mode=categories` to get the full list of 89+ categories with current names and IDs. --- ### Output Fields | Field | Type | Description | |-------|------|-------------| | `categoryId` | number | TCG category ID | | `categoryName` | string | Game name (Magic, Pokemon, etc.) | | `groupId` | number | Set ID | | `groupName` | string | Set name (e.g. "SV: Scarlet & Violet 151") | | `groupAbbreviation` | string | Set code (e.g. "MEW") | | `publishedOn` | string | Set release date | | `productId` | number | TCGPlayer product ID | | `name` | string | Card/product name | | `cleanName` | string | Normalized card name | | `imageUrl` | string | Product image URL | | `url` | string | TCGPlayer storefront URL | | `extendedData` | string | JSON: rarity, number, type (category-specific) | | `subTypeName` | string | Normal / Foil / Holofoil / 1st Edition / etc. | | `lowPrice` | number | Low price (USD) | | `midPrice` | number | Mid price (USD) | | `highPrice` | number | High price (USD) | | `marketPrice` | number | Market price (USD) | | `directLowPrice` | number | TCG Direct low price (USD) | Each output row is one product × one subTypeName combination. A single card may produce multiple rows (one per print variant). #### Dataset Views - **Products with Prices** — focused view: game, set, card name, sub-type, all price columns, URL - **Set Summary** — group-level metadata: game, set ID, name, code, release date - **Foil / Holo Only** — pre-filtered to foil/holofoil variants --- ### Examples #### List all TCG categories ```json { "mode": "categories", "maxItems": 0 } ```` Returns 89 rows, one per game/category. #### Walk all Magic: The Gathering sets ```json { "mode": "category_walk", "categoryId": 1, "includePrices": true, "maxItems": 0 } ``` Returns all products + prices for every MTG set on TCGPlayer. Run time varies — MTG has 700+ sets. #### Walk a specific Pokemon set ```json { "mode": "group_walk", "categoryId": 3, "groupIds": ["23237"], "includePrices": true, "includeExtendedData": true, "maxItems": 0 } ``` Returns all cards in the Scarlet & Violet 151 set (MEW) with full pricing rows. #### Get foil prices only for a Yu-Gi-Oh set ```json { "mode": "group_walk", "categoryId": 2, "groupIds": ["23019"], "includePrices": true, "onlyFoil": true, "maxItems": 0 } ``` Returns only 1st Edition, Ultra Rare, and other premium-print rows. #### Look up specific product IDs ```json { "mode": "by_product", "categoryId": 3, "productIds": ["501999", "502001"], "includePrices": true, "maxItems": 0 } ``` Searches all groups in category 3 for the listed product IDs. *** ### Data Source All data comes from [tcgcsv.com](https://tcgcsv.com), a community-maintained nightly mirror of the TCGPlayer pricing API. Prices are updated daily at approximately 8:00 PM EST. The site is free to use; please be polite — the actor applies a ~1 req/sec rate limit during bulk category walks. *** ### Use Cases - **Price trackers and deal-alert apps** — poll specific sets daily for price movements - **Collection management tools** — enrich card databases with live market prices - **Deck-builder applications** — calculate deck budget using market or mid prices - **Arbitrage and resale** — identify low / market spread or foil-vs-regular gaps - **Data analysis** — combine with Scryfall (MTG), pokemontcg.io (Pokemon), or YGOProDeck (Yu-Gi-Oh) for cross-source analysis *** ### Notes - The `by_product` mode scans groups within the category sequentially to locate the requested product IDs. For categories with many groups (Pokemon has 216+), use `group_walk` with a known group ID for faster results. - `extendedData` contains category-specific metadata (rarity, collector number, card type) returned as a JSON-encoded string. Parse it in your downstream pipeline. - Products without price data (sealed product, accessories) will have null price fields when no pricing rows exist on tcgcsv.com. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `mode` (type: `string`): List categories, walk a category's groups, walk a single group's products+prices, or look up by product ID. ## `categoryId` (type: `integer`): TCG category. 1=Magic, 2=YuGiOh, 3=Pokemon, 85=Pokemon Japan, etc. Run mode=categories to discover full list. ## `groupIds` (type: `array`): When mode=group\_walk, list of group (set) IDs within the category. Leave empty + mode=category\_walk to walk all groups. ## `productIds` (type: `array`): When mode=by\_product, list of TCGPlayer product IDs. ## `includePrices` (type: `boolean`): Join product metadata with current price rows (sub-type aware). ## `includeExtendedData` (type: `boolean`): Include category-specific fields (rarity, card number, type, etc.). ## `onlyFoil` (type: `boolean`): Filter to Foil / Holofoil / Reverse Holo / 1st Edition rows only. ## `maxItems` (type: `integer`): Maximum product/price rows. 0 = unlimited. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "group_walk", "categoryId": 3, "groupIds": [ "23237" ], "productIds": [ "501999" ], "includePrices": true, "includeExtendedData": true, "onlyFoil": false, "maxItems": 10 } ``` # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "group_walk", "categoryId": 3, "groupIds": [ "23237" ], "productIds": [ "501999" ], "includePrices": true, "includeExtendedData": true, "onlyFoil": false, "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/tcgcsv-tcgplayer-pricing-wrapper").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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "group_walk", "categoryId": 3, "groupIds": ["23237"], "productIds": ["501999"], "includePrices": True, "includeExtendedData": True, "onlyFoil": False, "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/tcgcsv-tcgplayer-pricing-wrapper").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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "group_walk", "categoryId": 3, "groupIds": [ "23237" ], "productIds": [ "501999" ], "includePrices": true, "includeExtendedData": true, "onlyFoil": false, "maxItems": 10 }' | apify call jungle_synthesizer/tcgcsv-tcgplayer-pricing-wrapper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/tcgcsv-tcgplayer-pricing-wrapper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TCGPlayer Pricing Scraper - tcgcsv.com API Wrapper", "description": "Wrapper around tcgcsv.com — the nightly TCGPlayer pricing mirror. Covers 89+ TCGs: Magic, Pokemon, Yu-Gi-Oh, Lorcana, One Piece, Flesh & Blood, Star Wars Unlimited, and more. Walk sets or fetch specific cards. Sub-type-aware prices (Normal/Foil/Holofoil/1st Edition) with market/mid/low/high.", "version": "0.1", "x-build-id": "3MbHJ5A2cEJ0bT3RB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~tcgcsv-tcgplayer-pricing-wrapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-tcgcsv-tcgplayer-pricing-wrapper", "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/jungle_synthesizer~tcgcsv-tcgplayer-pricing-wrapper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-tcgcsv-tcgplayer-pricing-wrapper", "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/jungle_synthesizer~tcgcsv-tcgplayer-pricing-wrapper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-tcgcsv-tcgplayer-pricing-wrapper", "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": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Mode", "enum": [ "categories", "category_walk", "group_walk", "by_product" ], "type": "string", "description": "List categories, walk a category's groups, walk a single group's products+prices, or look up by product ID." }, "categoryId": { "title": "Category ID", "type": "integer", "description": "TCG category. 1=Magic, 2=YuGiOh, 3=Pokemon, 85=Pokemon Japan, etc. Run mode=categories to discover full list.", "default": 3 }, "groupIds": { "title": "Group IDs", "type": "array", "description": "When mode=group_walk, list of group (set) IDs within the category. Leave empty + mode=category_walk to walk all groups.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "When mode=by_product, list of TCGPlayer product IDs.", "items": { "type": "string" } }, "includePrices": { "title": "Include Prices", "type": "boolean", "description": "Join product metadata with current price rows (sub-type aware).", "default": true }, "includeExtendedData": { "title": "Include Extended Data", "type": "boolean", "description": "Include category-specific fields (rarity, card number, type, etc.).", "default": true }, "onlyFoil": { "title": "Foil Sub-Types Only", "type": "boolean", "description": "Filter to Foil / Holofoil / Reverse Holo / 1st Edition rows only.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum product/price rows. 0 = unlimited.", "default": 10 } } }, "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 } } } } } } } } } } ```