{ "openapi": "3.0.1", "info": { "title": "Rakuma Japan Sold and Asking Prices — Median, Range", "description": "Look up any keyword on Rakuma, Rakuten's flea market in Japan. You get one row: the typical price and the lowest-to-highest range, how many of the listings found are already sold, and the shop versus private seller mix. $0.02 per keyword, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "nZKts43aMNdlVvSwH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~rakuma-japan-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-rakuma-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~rakuma-japan-price-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-rakuma-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~rakuma-japan-price-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-rakuma-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 words", "type": "array", "description": "Words to look up on Rakuma, one per entry — Japanese or Latin (`ポケモンカード`, `leica m6`). Each gets a row and is charged $0.02; one that finds nothing is not charged. About 12 fit a run at the default depth, two at 800 listings each; the rest are read from page 1 and marked `truncatedForTimeLimit`. A run also stops at the $3.00 Maximum cost per run — raise that in the run options, or split the run.", "default": [ "leica m6" ], "items": { "type": "string" } }, "maxItemsPerKeyword": { "title": "Listings read per keyword", "minimum": 40, "maximum": 800, "type": "integer", "description": "How many listings each price figure is measured on, 40 to 800. Rakuma serves 40 listings per page and offers no setting for that, so this divided by 40 is the number of pages read per word — 120 is three. A bigger number is a steadier price and a slower run. It is also the cap on listing rows, and each row is charged $0.002 when Include individual listings is on.", "default": 120 }, "titleMatch": { "title": "Title match", "enum": [ "all", "any", "off" ], "type": "string", "description": "Which listings count as your item and feed the price figures — and the guard on your money: Rakuma answers a word it does not know with a few hundred unrelated goods instead of an empty page, so a word matching none of them comes back marked `not_found` and is not charged. Card titles are cut short by the site, so `all` widens to `any` when it keeps none.", "default": "all" }, "includeSoldOut": { "title": "Include sold items in the price", "type": "boolean", "description": "On by default: items that have already sold are folded into the headline price, so it covers what buyers paid as well as what sellers are asking. Turn it off to price only what is still on sale. Sold items are counted for you either way (`soldListings`, `soldShare`) and keep their own price figures in `soldPriceJpy`. Does not change what a run costs.", "default": true }, "includeIndividualItems": { "title": "Include individual listings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per keyword summary. Turn it on to also get one row per listing read — item number, link, name, price, sold mark, shop or private seller, point-back rate, category and whether the title matched your words — at +$0.002 per row. Listings read per keyword sets how many rows that is. A word that finds nothing returns no rows and is charged nothing.", "default": false }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds US dollar figures next to the yen ones at the current exchange rate (open.er-api.com). A failed rate lookup never fails the run — the yen numbers simply come back on their own. Does not change what a run costs.", "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 } } } } } } } } } }