{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Sold Prices — What Items Really Sell For", "description": "Type one keyword or a whole list and get what each item actually sold for on Mercari Japan. Returns the median sold price (sold comps), the lowest–highest range, median days to sell and how many sold listings were found, in yen and US dollars. $0.02 per keyword, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "hpLw8fZcVXo4T0X7l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~mercari-japan-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-mercari-japan-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~mercari-japan-price-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-mercari-japan-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~mercari-japan-price-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-mercari-japan-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 keywords", "type": "array", "description": "One or more things to look up. Japanese keywords match the most listings (`ポケモンカード リザードン psa10`), English brand names work too (`Leica M6`). Each keyword is charged $0.02, and a keyword that finds nothing is not charged. About 130 keywords fill a run's default limits (300-second time limit, $3.00 Maximum cost per run); raise both in the run options or split the list.", "items": { "type": "string" } }, "itemStatus": { "title": "Which listings to price", "enum": [ "sold_out", "on_sale", "both" ], "type": "string", "description": "`sold_out` prices completed sales — what buyers actually paid, and the soundest basis for pricing. `on_sale` prices what sellers are asking right now. `both` runs the two separately and returns two rows per keyword, so it costs $0.04 per keyword instead of $0.02.", "default": "sold_out" }, "maxItemsPerKeyword": { "title": "Listings sampled per keyword", "minimum": 30, "maximum": 600, "type": "integer", "description": "How many listings the price summary is measured on (120 = one page of results). A bigger sample steadies the median and takes longer. It changes your bill only when 'Include individual listings' is on, because each listing returned is $0.002.", "default": 120 }, "priceMinJpy": { "title": "Lowest price to include (JPY)", "minimum": 0, "type": "integer", "description": "Listings under this yen amount are dropped before the summary is worked out — useful for keeping fakes, parts and accessories out of the price. Leave empty for no lower bound." }, "priceMaxJpy": { "title": "Highest price to include (JPY)", "minimum": 0, "type": "integer", "description": "Listings over this yen amount are dropped before the summary is worked out — useful for keeping bundles and lot sales out of the price. Leave empty for no upper bound." }, "includeIndividualItems": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per keyword and returns the price summary only. Turn it on to also get every sampled listing as its own row (title, price, link, photo, condition, dates) at $0.002 per listing — at the default 120 listings a run then reaches the $3.00 Maximum cost per run after about 11 keywords.", "default": false }, "convertToUsd": { "title": "Also show prices in US dollars", "type": "boolean", "description": "Adds a US dollar figure next to every yen figure, using today's rate from open.er-api.com. Nothing else about the result changes.", "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 } } } } } } } } } }