{ "openapi": "3.0.1", "info": { "title": "Japan MTG Card Prices (晴れる屋 Hareruya)", "description": "Magic: the Gathering single-card prices from Hareruya (hareruyamtg.com): price JPY, condition grade (NM/EX/MP/HP), stock, foil, set code, printing language, image and product URL, in an English schema. Product facts only. Unofficial; not affiliated with Hareruya Inc.", "version": "0.1", "x-build-id": "BZV5x1qK4BzQs1nbj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpopendata~japan-tcg-hareruya/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpopendata-japan-tcg-hareruya", "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/jpopendata~japan-tcg-hareruya/runs": { "post": { "operationId": "runs-sync-jpopendata-japan-tcg-hareruya", "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/jpopendata~japan-tcg-hareruya/run-sync": { "post": { "operationId": "run-sync-jpopendata-japan-tcg-hareruya", "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": { "cardName": { "title": "Card name", "type": "string", "description": "Magic: the Gathering card name to search, e.g. \"Black Lotus\", \"Ragavan, Nimble Pilferer\", \"Sheoldred, the Apocalypse\". English names match best (Japanese names work on the ja site). Required unless setName is given; an empty input searches \"Black Lotus\".", "default": "Black Lotus" }, "setName": { "title": "Set / edition (optional)", "type": "string", "description": "Optional set name or set code to narrow the search, e.g. \"Beta\", \"2ED\", \"The Brothers' War\", \"MH3\". Added to the search keyword. Leave empty to search all sets." }, "language": { "title": "Site language", "enum": [ "en", "ja" ], "type": "string", "description": "Which Hareruya site locale to query — \"en\" (English names/URLs, default) or \"ja\" (Japanese). Aliases such as \"English\"/\"Japanese\"/\"jp\" are accepted. This is the site UI locale; each card record still reports its own printing language separately.", "default": "en" }, "inStockOnly": { "title": "In-stock only", "type": "boolean", "description": "Keep only listings Hareruya itself currently has in stock (stock > 0). Applied client-side after fetching.", "default": false }, "priceMin": { "title": "Min price (JPY)", "minimum": 0, "type": "integer", "description": "Optional lower bound on priceJpy (yen, whole number, e.g. 1000). Applied client-side after fetching." }, "priceMax": { "title": "Max price (JPY)", "minimum": 0, "type": "integer", "description": "Optional upper bound on priceJpy (yen, whole number, e.g. 500000). Applied client-side after fetching." }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many dataset records (1-1000, default 10). One run fetches a single search page (up to 250 listings, no pagination — a deliberate robots.txt-compliance choice). Narrow the query for larger result sets.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Default: no proxy. If a run fails with HTTP 403, use RESIDENTIAL proxies with country JP. Never used for rotation/evasion — one client identity per run." } } }, "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 } } } } } } } } } }