{ "openapi": "3.0.1", "info": { "title": "Yahoo! Auctions Japan Sold Price Summary & History", "description": "Get Yahoo! Auctions Japan sold-price medians, range, bids and optional monthly history. $0.02 per keyword + $0.002 per returned auction. Individual rows are ON by default; turn them off for summaries only. Based on ended auctions with bids, not verified payments. Unofficial.", "version": "0.1", "x-build-id": "qjnYc296izvOAQTWp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~yahoo-auction-sold-comps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-yahoo-auction-sold-comps", "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~yahoo-auction-sold-comps/runs": { "post": { "operationId": "runs-sync-jpmarketdata-yahoo-auction-sold-comps", "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~yahoo-auction-sold-comps/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-yahoo-auction-sold-comps", "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 keywords", "type": "array", "description": "One or more searches for ended Yahoo! Auctions Japan sales, for example ポケモンカード リザードン psa10. Japanese spelling gives the tightest match. Each keyword with sold auctions costs $0.02; a keyword with no sold auctions is not charged.", "items": { "type": "string" } }, "maxItemsPerKeyword": { "title": "Max auctions per keyword", "minimum": 30, "maximum": 1000, "type": "integer", "description": "Maximum ended auctions in the normal sold-price sample (30–1000; default 100). Yahoo determines each page width. Optional individual rows come only from this sample; additional rows read for monthly history are calculation-only and not billed individually.", "default": 100 }, "soldOnly": { "title": "Individual results: sold only", "type": "boolean", "description": "If enabled (default), only auctions that actually sold (>=1 bid) are pushed as individual records. Statistics are always computed from sold auctions.", "default": true }, "includeIndividualItems": { "title": "Include individual auctions", "type": "boolean", "description": "On by default: return each sampled auction with its final price, bids, condition, end time and URL. Each individual auction row costs an additional $0.002. Turn this off for only the $0.02 per-keyword summary.", "default": true }, "includePriceTrend": { "title": "Add monthly sold-price history", "type": "boolean", "description": "Add monthly sold-price medians at the same $0.02 per-keyword fee. A keyword is charged when either the main sample or requested history contains priced sold auctions. Extra auctions read only for history are not returned or billed as individual rows. Off by default; saved inputs keep the same behavior.", "default": false }, "trendMonthsBack": { "title": "Trend months to cover", "minimum": 2, "maximum": 12, "type": "integer", "description": "How far back the optional monthly history should cover. Yahoo normally keeps about six months of ended auctions.", "default": 6 }, "trendMaxItemsPerKeyword": { "title": "Trend sampling budget", "minimum": 50, "maximum": 1000, "type": "integer", "description": "Target maximum matching auctions used for monthly history (50–1000). Collection uses the larger of this value and maxItemsPerKeyword. Local price filtering can require additional source pages. Collection also stops at source exhaustion or a page older than the requested start month. History-only auctions are not returned or charged individually.", "default": 300 }, "trendMinSoldPerMonth": { "title": "Minimum sales per trend month", "minimum": 1, "maximum": 50, "type": "integer", "description": "Months below this sold count are still reported but do not decide the trend direction.", "default": 5 }, "priceMinJpy": { "title": "Trend price floor (JPY)", "minimum": 0, "type": "integer", "description": "Optional local minimum JPY price when monthly history is enabled. Matching rows fill the sample while allowed unfiltered closed-auction pages are read. The band applies to the main summary, monthly history and returned auctions. totalListingsFound is null unless all source results were inspected." }, "priceMaxJpy": { "title": "Trend price ceiling (JPY)", "minimum": 0, "type": "integer", "description": "Optional local maximum JPY price when monthly history is enabled, inclusive. It scopes the main summary, monthly history and returned auctions without adding source price-query parameters. totalListingsFound is null when source inspection is incomplete." }, "convertToUsd": { "title": "Convert prices to USD", "type": "boolean", "description": "Adds USD prices next to JPY using the current exchange rate (open.er-api.com).", "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 } } } } } } } } } }