{ "openapi": "3.0.1", "info": { "title": "Yahoo! Auctions Japan Underpriced Deals — Live vs Sold", "description": "Which Yahoo! Auctions listings are cheap right now? Builds the sold-comp median for your keyword from closed auctions, then scores every live listing against it and returns the ones below your threshold, with the discount distribution and the comp basis. For resellers and proxy buyers. From $0.02.", "version": "0.1", "x-build-id": "IbTCVQigTBFGle3cA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~yahoo-auction-underpriced-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-yahoo-auction-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~yahoo-auction-underpriced-deals/runs": { "post": { "operationId": "runs-sync-jpmarketdata-yahoo-auction-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~yahoo-auction-underpriced-deals/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-yahoo-auction-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 current 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 auctions to sample for the basis. Only auctions that received a bid count as sold.", "default": 120 }, "maxLiveListings": { "title": "Max live listings", "minimum": 20, "maximum": 600, "type": "integer", "description": "How many current 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 is mixing price tiers (a camera search also returns its batteries and manuals) and is refused rather than scored.", "default": "4.0" }, "priceMinJpy": { "title": "Min price (JPY)", "minimum": 0, "type": "integer", "description": "Pushed to Yahoo on both sides of the comparison, so the sold basis and the live candidates cover the same product tier." }, "priceMaxJpy": { "title": "Max price (JPY)", "minimum": 0, "type": "integer", "description": "Pushed to Yahoo on both sides, like the minimum." }, "includeIndividualDeals": { "title": "Include individual deals", "type": "boolean", "description": "Also return each matching auction (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 } } } } } } } } } }