{ "openapi": "3.0.1", "info": { "title": "magi Japan Card Prices — Sold, Asking, Shop or Person", "description": "Type a card name and get what copies sold for on magi, Japan's card-only marketplace, and what sellers still ask. Returns median sold price and range, how many copies have sold, new versus used counts, and the share sold by card shops. $0.02 per card name, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "BCUje2em6rxXjzi4v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~magi-japan-card-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-magi-japan-card-price-checker", "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~magi-japan-card-price-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-magi-japan-card-price-checker", "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~magi-japan-card-price-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-magi-japan-card-price-checker", "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": [ "keywords" ], "properties": { "keywords": { "title": "Card names", "type": "array", "description": "The card names to look up on magi, in Japanese: `リザードン` (Charizard), `青眼の白龍` (Blue-Eyes White Dragon). A shorter name matches more copies. One row per name. Each card name is charged $0.02; a name magi finds nothing for is not charged. A name takes 25 to 45 seconds, so keep the list to 2 or 3. A run stops at its Maximum cost per run, $3.00 by default — raise it in the run options.", "default": [ "リザードン" ], "items": { "type": "string" } }, "includeSoldOut": { "title": "Sold copies", "type": "boolean", "description": "On by default. Measures the copies that have already sold: how many, their typical price, the cheapest and dearest they went for and the two ends of the middle 50% range, plus the used / new / not-stated split. Off, only the copies still for sale are measured — that drops the share that sold and the sold-to-asking comparison, and gives the asking side the middle 50% reads. Charges do not change.", "default": true }, "includeOnSale": { "title": "Copies still for sale", "type": "boolean", "description": "On by default. Measures the copies sellers are still asking for: how many, their typical price, and the cheapest and dearest asking price. With both sides on, the two ends of the middle 50% range are read on the sold side first, so here they come back empty — turn Sold copies off to get them on this side. Off, only sold copies are measured and the sold-to-asking comparison goes.", "default": true }, "sortBy": { "title": "Which end of the market to list", "enum": [ "price_asc", "price_desc" ], "type": "string", "description": "Which end of the market the individual listings come from: `price_asc` starts at the cheapest copy, `price_desc` at the dearest. The typical price and the price range cover every matching copy either way, because they are read from magi's own price order — and when that order wobbles on one side, that side reports the listings read instead and says so. This does not change what you are charged.", "default": "price_asc" }, "maxItemsPerKeyword": { "title": "Listings read per card name", "minimum": 1, "maximum": 288, "type": "integer", "description": "How many individual listings come back per card name when Include individual listings is on: 96 is one page of results, 288 is three. At 288 you can be charged for up to 288 rows instead of 96. The typical price and the price range do not move with it — they come off magi's own price order, on a fixed number of page reads. It does widen the card shop share, which is measured on the listings read.", "default": 96 }, "includeIndividualItems": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per card name. Switch it on to also get every listing that was read as its own row — card name, price, sold or still for sale, whether the seller is a certified card shop, favourites and the link — at +$0.002 per row. How many rows you get is set by Listings read per card name.", "default": false }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD figures next to the yen ones at the current exchange rate (open.er-api.com). A failed rate lookup never fails the run — the yen numbers simply come back on their own. This does not change what you are charged.", "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 } } } } } } } } } }