{ "openapi": "3.0.1", "info": { "title": "Japan Resale Cross-Market Checker — Yahoo, Mercari, PayPay", "description": "One keyword, three Japanese resale markets, one call: Yahoo! Auctions sold prices, Mercari (sold out / on sale) and PayPay Flea Market. Returns median and quartiles per market plus the cross-market price gap, every number labelled sold or asking. From $0.02 — no subscription. 日本3市場の相場差を1コールで比較。", "version": "0.1", "x-build-id": "fW1FZCU027rO03WKy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~japan-resale-cross-market-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-japan-resale-cross-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~japan-resale-cross-market-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-japan-resale-cross-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~japan-resale-cross-market-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-japan-resale-cross-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "One or more search keywords, compared across every selected market. Japanese usually matches more listings than English (Nintendo Switch, ポケモンカード, ロレックス). Each keyword costs $0.02.", "default": [ "nintendo switch" ], "items": { "type": "string" } }, "markets": { "title": "Markets to compare", "type": "array", "description": "Which Japanese marketplaces to price. Yahoo! Auctions returns SOLD prices (ended auctions with at least one bid), Mercari can return either, PayPay Flea Market can only return ASKING prices (it does not publish sold listings). The price of a keyword is the same whichever markets you pick.", "items": { "type": "string", "enum": [ "yahoo_auction", "mercari", "paypay_flea" ], "enumTitles": [ "Yahoo! Auctions Japan — sold (ヤフオク落札)", "Mercari Japan (メルカリ)", "PayPay Flea Market — asking (PayPayフリマ)" ] }, "default": [ "yahoo_auction", "mercari", "paypay_flea" ] }, "mercariStatus": { "title": "Mercari listing status", "enum": [ "both", "sold_out", "on_sale" ], "type": "string", "description": "Which Mercari listings to price. 'Sold out' gives real sold comps (comparable with Yahoo! Auctions), 'On sale' gives asking prices (comparable with PayPay Flea Market), 'Both' returns them as two separate blocks so each keeps a single, honest price basis.", "default": "both" }, "maxItemsPerMarket": { "title": "Max listings sampled per market", "minimum": 30, "maximum": 300, "type": "integer", "description": "How many listings to sample per market (and per Mercari status) before computing the statistics. Larger samples are steadier but slower: Yahoo returns 50 per request, Mercari 120, PayPay 100, and requests are throttled to one per 1.5 s.", "default": 100 }, "priceMinJpy": { "title": "Minimum price (JPY, optional)", "minimum": 0, "type": "integer", "description": "Drop listings priced below this before computing the statistics. Applied identically to every market so the medians stay comparable. Useful to cut accessory/junk listings out of a keyword." }, "priceMaxJpy": { "title": "Maximum price (JPY, optional)", "minimum": 0, "type": "integer", "description": "Drop listings priced above this before computing the statistics. Applied identically to every market. Useful to cut bundles and lot sales out of a keyword." }, "includeIndividualItems": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per keyword, whatever the number of markets. Enable to also get every sampled listing from every market (title, price, status, condition, URL) at +$0.002 per listing.", "default": false }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD statistics next to JPY using the current exchange rate (open.er-api.com, looked up once per run).", "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 } } } } } } } } } }