{ "openapi": "3.0.1", "info": { "title": "Japanese Pokemon Card Sold Comps — Japan TCG Sold Prices", "description": "What did this card actually sell for in Japan? Sold comps from Yahoo! Auctions and Mercari, resolved to set code + collector number + rarity, with raw and PSA/BGS graded medians kept apart — they differ 1.6x to 5x. Coverage always published. From $0.02 — no subscription. 日本の落札実売を1コールで。", "version": "0.1", "x-build-id": "ltjb7v1sXp3r4OIIm" }, "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", "type": "array", "description": "One or more card names, in Japanese. 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 } } } } } } } } } }