{ "openapi": "3.0.1", "info": { "title": "KOMEHYO Japan Luxury Resale Prices by Condition", "description": "Type a brand or model and get what KOMEHYO, Japan's largest second-hand luxury chain, asks for it today. Returns typical price and lowest–highest, in-stock count, new vs used (S/A/B) mix, how many just sold out, and which stores hold them. $0.02 per keyword, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "xD9vgOtjca4Sjwgd3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~komehyo-luxury-market-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-komehyo-luxury-market-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~komehyo-luxury-market-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-komehyo-luxury-market-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~komehyo-luxury-market-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-komehyo-luxury-market-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": [ "keyword" ], "properties": { "keyword": { "title": "Brand or model", "type": "string", "description": "What to look up at KOMEHYO, in Japanese or in Latin letters: `ロレックス`, `rolex` and `Hermes Birkin` all work, and the Japanese and the Latin spelling of a brand return the same items. This word decides everything the run reports — the number in stock, the price figures, the new/used split and the branch list. Each keyword is charged $0.02, and a keyword that finds nothing is not charged.", "default": "ロレックス" }, "condition": { "title": "Condition", "enum": [ "all", "new", "used_s", "used_a", "used_b" ], "type": "string", "description": "Which items get measured. Every condition covers the whole search; the other four narrow it to one of KOMEHYO's own condition labels, and then the item count, the price figures and the branch list all describe that condition alone. Narrowing does not change what a run costs.", "default": "all" }, "includeSoldOut": { "title": "Include sold-out items", "type": "boolean", "description": "Off by default: items that have already sold are counted for you (`soldOutCount` and `soldOutShare`) but stay out of the price figures. Turn it on to fold them in, so the typical price and the lowest-highest range describe what recently sold as well as what is still on the shelf. Does not change what a run costs.", "default": false }, "maxItems": { "title": "Listing rows per run", "minimum": 1, "maximum": 250, "type": "integer", "description": "How many listing rows come back when Include individual listings is on, 1 to 250, read 50 at a time. Each row is charged $0.002 on top of the $0.02 for the keyword; 250 rows stays far below the $3.00 Maximum cost per run. Every extra 50 rows is one more page read, so a high number makes the run slower. With the toggle off this changes nothing: the summary is always read the same way.", "default": 50 }, "itemOrder": { "title": "Order of the listing rows", "enum": [ "price_asc", "price_desc", "newest" ], "type": "string", "description": "The order of the listing rows when Include individual listings is on. It decides which listings you see first and which ones fall outside the row limit. The summary is always read cheapest-first whatever you pick here, so this does not move the price figures, and it does not change what a run costs.", "default": "price_asc" }, "includeIndividualItems": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 for the keyword summary. Turn it on to also get one row per listing — name, brand, condition label, price, pre-discount price, branch, sold-out and new-arrival marks and the product link — at +$0.002 per row.", "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.", "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 } } } } } } } } } }