{ "openapi": "3.0.1", "info": { "title": "Sofmap Japan Used Prices — By Condition Rank S to E", "description": "Type a model like MacBook Pro and see what used stock costs at Sofmap Japan today, split by the shop's own condition rank S to E. You get the typical price and range in yen per rank, how many units that is, and how long it has been sitting. $0.02 per search, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "YytLbgzcgSMEdrPTA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~sofmap-japan-used-rank-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-sofmap-japan-used-rank-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~sofmap-japan-used-rank-price-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-sofmap-japan-used-rank-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~sofmap-japan-used-rank-price-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-sofmap-japan-used-rank-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": [ "keyword" ], "properties": { "keyword": { "title": "Model or part number", "type": "string", "description": "What to look for in Sofmap's used stock: a model name or a part number as printed, such as `MacBook Pro`, `ThinkPad X1` or `MMMQ3J`. Everything in the run is measured over the used stock this word finds, so a narrower word gives a tighter typical price and a wider one covers more of the shelf. One run is one search and costs a flat $0.02; a search that finds nothing is not charged.", "default": "MacBook Pro" }, "category": { "title": "Section of the used shop", "enum": [ "all", "pc", "gaming", "smp", "tab", "wtc", "mac", "iphone", "ipad", "surface", "video", "cam", "dslr", "lens", "headphone", "audio", "visual", "rec-visual", "device", "parts", "game", "kaden-life", "kaden-light", "kaden-joho", "kaden-season", "kaden-kitchen1", "kaden-kitchen2", "kaden-appearance", "kaden-beauty" ], "type": "string", "description": "Which of the shop's 28 used sections to look in. `all` searches every section; picking one drops items that merely share the word, which lowers the counts and can move the typical price a lot. If you change the model above, check this too — searching `ThinkPad` inside `Mac` finds nothing. It does not change what you are charged.", "default": "mac" }, "maker": { "title": "Maker (optional)", "type": "string", "description": "Leave empty for every maker. Filling it keeps only that maker's used stock, so every count and price covers that maker alone. It has to be spelled the shop's way, Japanese brackets included: `Apple(アップル)` works, `Apple` returns nothing. Every spelling the shop uses for your search comes back in `makerOptions`, so an empty first run tells you what to type. It does not change what you are charged.", "default": "" }, "includeListings": { "title": "Also list every used item", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 for the summary. Turn it on to also get one row per used product (name, maker, condition ranks it holds, units, price in yen with tax, listing day, days on the shelf, markdown date, branch, condition note, link) at +$0.002 per row. The rows are the products already read for the summary, so this adds rows, not waiting — capped by the pages setting below.", "default": false }, "maxPages": { "title": "Pages of products to read", "minimum": 1, "maximum": 3, "type": "integer", "description": "How much of the shelf the summary covers, 200 products a page. `priceBasis` says `exact` when every product was read and `sample` when this cut it short — and short moves the typical price: `iPhone 15` came out at ¥35,230 over the first 200 of its 353 products and ¥64,480 over all. It also caps the rows charged at $0.002 each when the list above is on: 200 rows a page, 600 at 3 pages.", "default": 1 } } }, "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 } } } } } } } } } }