{ "openapi": "3.0.1", "info": { "title": "TCGplayer Scraper - Card Prices, Listings & Market Data", "description": "Scrape TCGplayer card and sealed product prices without a login. Search any card or browse a whole game, filter by set, rarity and type, and get market price, lowest price with shipping, listing count, card details and the cheapest live offers. Optional price change tracking.", "version": "0.1", "x-build-id": "FofXv0bliK57fI76a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goat255~tcgplayer-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goat255-tcgplayer-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/goat255~tcgplayer-scraper/runs": { "post": { "operationId": "runs-sync-goat255-tcgplayer-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/goat255~tcgplayer-scraper/run-sync": { "post": { "operationId": "run-sync-goat255-tcgplayer-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", "properties": { "searchQueries": { "title": "Search phrases", "type": "array", "description": "Card names, set names or product names to search for, the same way you would type them into the marketplace search box. Each phrase is walked through as many result pages as your per-search limit allows. Leave empty and pick a game below to browse a whole game instead. Example: charizard, black lotus, booster box.", "items": { "type": "string" } }, "productLines": { "title": "Games", "type": "array", "description": "Restrict results to one or more games. Use the game name as the marketplace writes it, for example pokemon, pokemon japan, magic, yugioh, one piece card game, lorcana, flesh and blood, digimon card game, star wars unlimited. Short forms such as mtg, ygo and fab also work.", "default": [], "items": { "type": "string" } }, "setNames": { "title": "Sets", "type": "array", "description": "Restrict results to one or more sets, written as the marketplace shows them. Example: SV03: Obsidian Flames, Base Set, SWSH: Crown Zenith. A set name that matches nothing is ignored and reported in the run log.", "default": [], "items": { "type": "string" } }, "rarities": { "title": "Rarities", "type": "array", "description": "Restrict results to one or more rarities, written as the marketplace shows them. Example: Special Illustration Rare, Mythic, Secret Rare.", "default": [], "items": { "type": "string" } }, "productTypes": { "title": "Product types", "type": "array", "description": "Restrict results to singles or sealed product. Use Cards for single cards and Sealed Products for booster boxes, packs, tins and collections.", "default": [], "items": { "type": "string" } }, "sort": { "title": "Sort by", "enum": [ "relevance", "best_selling", "price_high", "price_low", "newest", "name" ], "type": "string", "description": "Order of the results. Relevance is the marketplace's own ranking for the search phrase.", "default": "relevance" }, "maxItemsPerSource": { "title": "Max products per search", "minimum": 1, "maximum": 9999, "type": "integer", "description": "Cap on products returned for each search phrase (or for the whole game when browsing). Results are walked 50 at a time until this is reached or the results run out. The marketplace serves at most 9,999 results for any one search, so split very large sweeps by set or rarity.", "default": 100 }, "trackChanges": { "title": "Track price changes between runs", "type": "boolean", "description": "Compare every product with the previous run that used the same watch name, and add the previous market price, lowest price and listing count plus the change in each. Schedule the actor daily to get a price and supply history.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the price watch to compare against when change tracking is on. Use a different name for each watch list you schedule, for example modern-staples or sealed-pokemon.", "default": "default" }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search phrases to process in parallel.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. The default works for most runs.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }