{ "openapi": "3.0.1", "info": { "title": "Yahoo Auctions Japan – Sold Price Scraper", "description": "Scrape sold-price history from Yahoo! Auctions Japan (Yahuoku), the largest Japanese auction site. Get final sold prices, bid counts, condition, seller, and images as clean JSON — real closed-auction comps for resale research and cross-marketplace pricing. No code required.", "version": "0.0", "x-build-id": "qSM2ouW9PAAPpAfGb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~yahoo-auctions-sold-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-yahoo-auctions-sold-scraper", "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/datalab-jp~yahoo-auctions-sold-scraper/runs": { "post": { "operationId": "runs-sync-datalab-jp-yahoo-auctions-sold-scraper", "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/datalab-jp~yahoo-auctions-sold-scraper/run-sync": { "post": { "operationId": "run-sync-datalab-jp-yahoo-auctions-sold-scraper", "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", "properties": { "searchKeyword": { "title": "Search keyword", "type": "string", "description": "The keyword to search for closed (sold) auctions on Yahoo! Auctions Japan, for example 'Nintendo Switch' or 'ポケモンカード' (Pokémon cards). Works with English or Japanese; Japanese keywords typically surface more results since Yahoo Auctions is a Japan-only marketplace. If left empty you must instead supply a `categoryId`; if neither is set the run fails. Each matching sold listing becomes one row in the output dataset (one billable result).", "default": "Nintendo Switch" }, "categoryId": { "title": "Category ID (optional)", "type": "string", "description": "Optional Yahoo Auctions category ID (the `auccat` URL parameter), for example '2084048668' for trading cards or '23211' for cameras. Enter it as the numeric string shown in a Yahoo Auctions category URL; find it by browsing the category on the site and copying the `auccat` value from the address bar. Leave empty to search across all categories using only `searchKeyword`. You must provide at least one of `searchKeyword` or `categoryId`, or the run fails immediately." }, "minPrice": { "title": "Minimum sold price (JPY)", "minimum": 0, "type": "integer", "description": "Lower bound in Japanese yen (JPY) for the final sold price, for example 1000 to exclude very cheap junk listings or 5000 to focus on higher-value items. Enter a whole number; it is sent to Yahoo Auctions as the `aucminprice` filter. Leave empty (the default) to apply no minimum, returning sold listings at any price. Works together with `maxPrice` to define a price range for market research." }, "maxPrice": { "title": "Maximum sold price (JPY)", "minimum": 0, "type": "integer", "description": "Upper bound in Japanese yen (JPY) for the final sold price, for example 20000 to exclude outlier high-end listings or 50000 to cap a budget search. Enter a whole number; it is sent to Yahoo Auctions as the `aucmaxprice` filter. Leave empty (the default) to apply no maximum, returning sold listings at any price. Works together with `minPrice` to define a price range for market research." }, "sortBy": { "title": "Sort by", "enum": [ "endTime", "priceHigh", "priceLow", "bids" ], "type": "string", "description": "Sort order for the returned sold listings, mirroring the sort options on the Yahoo Auctions closed-search page. 'endTime' (default) returns the most recently ended auctions first, best for tracking the latest sold prices. 'priceHigh' and 'priceLow' sort by sold price descending or ascending, useful for finding top comps or price floors. 'bids' sorts by number of bids, highlighting the most competitively fought-over items. If omitted, defaults to 'endTime'.", "default": "endTime" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of sold listings to return across all paginated pages, for example 100 for a quick price check or 1000 for a thorough market survey. Each returned item is one billable result, so this is the main cost control for a run. Defaults to 100 if omitted, and accepts values from 1 to 5000. The Actor paginates automatically through Yahoo Auctions' closed-search results and stops once this limit is reached or no more matching listings exist.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration used to fetch Yahoo Auctions pages while avoiding rate limiting and IP blocks. This Actor defaults to Apify's standard datacenter proxy (`useApifyProxy: true`), which has proven sufficient for Yahoo Auctions' closed-search pages, unlike some Japanese marketplaces that need residential IPs. Override to a residential or country-specific group here if you hit blocking. Keep the default enabled for normal use; disabling it raises the risk of failed or blocked requests.", "default": { "useApifyProxy": 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 } } } } } } } } } }