{ "openapi": "3.0.1", "info": { "title": "Pokemon Card Japan Sold Prices — Raw vs Graded per Card", "description": "Type a Japanese card name and get what each card sold for on Yahoo! Auctions and Mercari, by set, number and rarity. Returns median sold prices (sold comps) for raw and graded copies apart, the PSA/BGS multiple and a shop ask. $0.02 per name, charged only when a sale matches a card. Unofficial.", "version": "0.1", "x-build-id": "L0gDULzXNRcLi0dGt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~japan-tcg-sold-comps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-japan-tcg-sold-comps", "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/jpmarketdata~japan-tcg-sold-comps/runs": { "post": { "operationId": "runs-sync-jpmarketdata-japan-tcg-sold-comps", "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/jpmarketdata~japan-tcg-sold-comps/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-japan-tcg-sold-comps", "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": [ "cardNames" ], "properties": { "cardNames": { "title": "Card names in Japanese", "type": "array", "description": "One or more card names, in Japanese (リザードン, not 'charizard' — measured 2026-08-18 the shop catalog has 126 cards for リザードン and 0 for charizard; an English name resolves no sale to a card and is not charged). Search BROADLY — 'リザードン' rather than 'リザードンex': the shop catalog is fetched with the same word, and a narrow word leaves prints like 'メガリザードンXex' out of it (11 sales lost when measured). Individual cards are separated afterwards, locally, at no extra cost. Each name costs $0.02.", "default": [ "リザードン" ], "items": { "type": "string" } }, "game": { "title": "Card game", "enum": [ "poc", "ygo", "opc", "dm", "ws", "ua", "vg", "digi", "bs", "gcg" ], "type": "string", "description": "Which Yuyu-tei catalog section supplies the card identities. Pokemon (poc) is the measured default: the collector-number match works for any game, but the Japanese set-name and series tables are Pokemon-tuned, so other games resolve fewer listings. Whatever happens, the achieved rate is reported as coverage.coverageRate.", "default": "poc" }, "maxSoldPerSource": { "title": "Max sold listings sampled per marketplace", "minimum": 30, "maximum": 300, "type": "integer", "description": "How many listings to sample from Yahoo! Auctions and from Mercari before computing the statistics. Larger samples give more cards a usable n, but cost time: Yahoo returns 50 per request, Mercari 120, and requests are throttled to one per 1.5 s.", "default": 100 }, "minSoldPerCard": { "title": "Minimum sold listings per card", "minimum": 1, "maximum": 50, "type": "integer", "description": "Drop identified cards backed by fewer than this many sold listings from the `cards` array. They are still counted in `coverage` and in the keyword band, so raising this never changes a denominator — it only hides thin cards. Every card keeps its own `n` either way.", "default": 1 }, "includeIndividualListings": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per card name. Enable to also get every sampled sold listing with the card it was resolved to and WHY (match verdict and reason), so you can audit which listings produced each median. +$0.002 per listing.", "default": false }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD statistics next to JPY using the current exchange rate (open.er-api.com, looked up once per run).", "default": true } } }, "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 } } } } } } } } } }