{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Underpriced Deals — Live vs Sold Comps", "description": "Which listings on Mercari Japan are cheap right now? Builds the sold-comp median for your keyword, then scores every live listing against it and returns the ones below your discount threshold, with the discount distribution and the sold-comp basis. For resellers and proxy buyers. From $0.02.", "version": "0.1", "x-build-id": "R0jeJnhydC27Jh3pq" }, "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 keyword gets its own sold-comp basis.", "items": { "type": "string" } }, "dealThresholdPct": { "title": "Deal threshold (% of sold median)", "minimum": 10, "maximum": 100, "type": "integer", "description": "A live listing counts as a deal when its price is at or below this percentage of the sold-comp median. 80 means \"20% under the going rate\".", "default": 80 }, "maxSoldComps": { "title": "Max sold comps", "minimum": 20, "maximum": 600, "type": "integer", "description": "How many sold listings to sample for the basis. More comps mean a steadier median.", "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": "Min comps required", "minimum": 2, "maximum": 100, "type": "integer", "description": "Refuse to score a keyword with fewer sold comps than this. Guards against a median built on two data points.", "default": 8 }, "maxCompSpread": { "title": "Max comp spread (p75 / p25)", "type": "string", "description": "Coherence ceiling for the basis. A keyword whose sold comps span more than this ratio from p25 to p75 is mixing price tiers (a camera search also returns its batteries and manuals) and is refused rather than scored. Raise it only if you know the keyword is one product tier.", "default": "4.0" }, "priceMinJpy": { "title": "Min price (JPY)", "minimum": 0, "type": "integer", "description": "Applied to both the sold comps and the live listings. The way to pin a wide keyword to one product tier." }, "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": "Also return each matching listing (charged per deal).", "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 } } }, "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 } } } } } } } } } }