{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Underpriced Deals — Under the Sold Price", "description": "Type a keyword and get the Mercari Japan listings on sale now for less than the item usually sells for. Returns each deal with price, discount vs the sold median, condition and link, plus the sold median behind it. $0.02 per keyword + $0.002 per deal; unusable sold prices = no charge. Unofficial.", "version": "0.1", "x-build-id": "arhta96amX2njur1L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~mercari-japan-underpriced-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-mercari-japan-underpriced-deals", "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-underpriced-deals/runs": { "post": { "operationId": "runs-sync-jpmarketdata-mercari-japan-underpriced-deals", "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-underpriced-deals/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-mercari-japan-underpriced-deals", "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": "Keywords", "type": "array", "description": "Search terms, e.g. `Nikon Z6`, each with its own sold-out price comparison. Each usable comparison costs $0.02 even if no deal is found; unusable comparisons are free. Maximum cost per run defaults to $3.00; raise it in run options or split the list.", "items": { "type": "string" } }, "dealThresholdPct": { "title": "Deal threshold (% of sold median)", "minimum": 10, "maximum": 100, "type": "integer", "description": "A live listing is a deal when its asking price is at or below this percentage of the median source-labelled sold-out price. 80 means at least 20% below that reference median. Sold-out labels do not independently prove completed payment.", "default": 80 }, "maxSoldComps": { "title": "Sold-out listings sampled", "minimum": 20, "maximum": 600, "type": "integer", "description": "Maximum sold-out listings used as the price reference. A larger sample can make the median steadier but takes longer.", "default": 120 }, "maxLiveListings": { "title": "Max live listings", "minimum": 20, "maximum": 600, "type": "integer", "description": "How many on-sale listings to score against the basis.", "default": 120 }, "minComps": { "title": "Minimum reference listings", "minimum": 2, "maximum": 100, "type": "integer", "description": "Minimum sold-out listings required before scoring a keyword. Higher values reject smaller reference samples where a median could depend on only a few prices.", "default": 8 }, "maxCompSpread": { "title": "Widest reference-price ratio", "type": "string", "description": "Maximum ratio of the upper to lower prices enclosing the middle 50% of the sold-out sample. A larger ratio can indicate mixed products, such as cameras together with batteries and manuals; the keyword is then refused. Raise only for a known comparable product group.", "default": "4.0" }, "priceMinJpy": { "title": "Min price (JPY)", "minimum": 0, "type": "integer", "description": "Include only reference and live listings priced at or above this yen amount. This can separate a product from cheap accessories sharing its name and determine whether its reference prices are comparable enough to score. Empty sets no lower price bound." }, "priceMaxJpy": { "title": "Max price (JPY)", "minimum": 0, "type": "integer", "description": "Applied to both sides, like the minimum." }, "includeIndividualDeals": { "title": "Include individual deals", "type": "boolean", "description": "On by default. Return each matching listing at $0.002 per deal, in addition to the $0.02 usable keyword comparison. Turn off for summary rows only.", "default": true }, "convertToUsd": { "title": "Convert to USD", "type": "boolean", "description": "Add USD figures alongside JPY.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }