{ "openapi": "3.0.1", "info": { "title": "Hobby Search Japan Prices — What's In Stock and % Off", "description": "Type a hobby keyword and see what model kits and figures cost on Hobby Search in Japan today. You get the typical price and price range over every item you can actually buy, how many that is of all found, and the usual discount off list. $0.02 per keyword, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "83m8ZBqaaYyU9zdR9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~hobbysearch-japan-stock-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-hobbysearch-japan-stock-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~hobbysearch-japan-stock-price-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-hobbysearch-japan-stock-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~hobbysearch-japan-stock-price-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-hobbysearch-japan-stock-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": "Search words", "minItems": 1, "maxItems": 10, "type": "array", "description": "One or more search words; each gets its own summary row. Japanese finds far more than English here (measured 2026-09-09: `gundam` 223 items in stock, `ガンダム` 1,075); part numbers work as printed (`HGUC`, `MG`). Each word is charged $0.02, and a word that finds nothing is not charged. At most 10 words run per call, inside the $3.00 Maximum cost per run; split the run to do more.", "default": [ "HGUC" ], "items": { "type": "string" } }, "category": { "title": "Shop section", "enum": [ "all", "gunpla", "figure", "mecha", "plamo", "car", "paint", "rail", "train", "mini", "chara", "doll", "toy", "rc", "military", "toreca", "book" ], "type": "string", "description": "Which part of the shop to look in. `all` searches everything; picking a section removes items that merely share the word (searching `ガンダム` in everything also returns marker pens and tools). Narrowing a section lowers the counts and can change the typical price a lot. It does not change what you are charged.", "default": "gunpla" }, "inStockOnly": { "title": "Only what is in stock", "type": "boolean", "description": "On by default: the shop hides everything it cannot sell today, and the prices you get cover only items you could buy right now. Turn it off to price the whole catalogue including sold-out items — the typical price usually moves, because old sold-out items sit at a different price than current stock. Either way you get both counts and the share in stock. It does not change what you are charged.", "default": true }, "useJapaneseAliases": { "title": "Swap known English words", "type": "boolean", "description": "On by default: a short list of English words is swapped for the Japanese the shop indexes (`gundam` to `ガンダム`, `nendoroid` to `ねんどろいど`). Without it those words find far fewer items, or none. Only whole listed words are swapped, so part numbers go through as typed, and `searchTermUsed` says what was searched. It does not change what you are charged.", "default": true }, "includeIndividualItems": { "title": "Also list every item", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per search word for the summary. Turn it on to also get one row per item (name, code, link, price, list price, discount, stock tags, units left, release line) at +$0.002 per row. The rows are the items on the pages set below, 60 to a page.", "default": false }, "maxItemPages": { "title": "Pages of items to list", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many pages of items to return when the item list above is on, cheapest first, 60 items to a page. This is the cap on rows charged at $0.002 each: 1 page is at most 60 rows, 3 pages at most 180. It has no effect while the item list is off, and it never changes the summary numbers.", "default": 1 }, "convertToUsd": { "title": "Also show prices in USD", "type": "boolean", "description": "Adds USD figures next to the yen ones using today's exchange rate. A failed rate lookup never fails the run — you simply get the yen numbers on their own. It 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 } } } } } } } } } }