{ "openapi": "3.0.1", "info": { "title": "Yahoo Auctions Scraper", "description": "Scrape products from Yahoo Auctions Japan category and search URLs - prices, bids, end time, seller, category and images.", "version": "0.1", "x-build-id": "4FXQKHvgdthahUC9H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sigma-dev~yahoo-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sigma-dev-yahoo-auctions-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/sigma-dev~yahoo-auctions-scraper/runs": { "post": { "operationId": "runs-sync-sigma-dev-yahoo-auctions-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/sigma-dev~yahoo-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-sigma-dev-yahoo-auctions-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", "required": [ "startUrl" ], "properties": { "startUrl": { "title": "Start URL", "type": "string", "description": "A Yahoo Auctions category or search results URL to scrape. Open the category/search on auctions.yahoo.co.jp, apply any filters you want, and paste the URL from your browser's address bar.", "default": "https://auctions.yahoo.co.jp/category/list/23000/?min=160000&max=&price_type=currentprice&auccat=23000&fixed=3&is_postage_mode=1&dest_pref_code=13&b=1&n=100&s1=new&o1=d" }, "splitByPrice": { "title": "Collect more than 15,000 items (auto price-band splitting)", "type": "boolean", "description": "Yahoo Auctions only lets you page through 150 pages (~15,000 items) per URL, no matter how many results exist. When enabled, the scraper automatically subdivides the search into narrower price bands so it can collect the whole category (potentially hundreds of thousands of items). IMPORTANT: for large categories, always set a 'Max items' cap to control run time and cost. When enabled, the Start/End page settings are ignored.", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape. Use 0 for no limit. Strongly recommended when 'Collect more than 15,000 items' is enabled, since a full category can contain hundreds of thousands of items.", "default": 0 }, "imageMode": { "title": "Images to collect", "enum": [ "thumbnail", "all" ], "type": "string", "description": "\"Thumbnail image only\" reads just the listing thumbnail and is fast (one request per results page). \"All images from each product\" opens every product page and collects its full image gallery (one extra request per product, so it is slower and uses more compute).", "default": "thumbnail" }, "startPage": { "title": "Start page", "minimum": 0, "type": "integer", "description": "First results page to scrape (page 1 is the first page). Leave as 0 to start from the very first page. Only used when 'Collect more than 15,000 items' is turned OFF.", "default": 0 }, "endPage": { "title": "End page", "minimum": 0, "type": "integer", "description": "Last results page to scrape. Leave as 0 to keep scraping until the final available page (max 150 due to Yahoo's cap). Only used when 'Collect more than 15,000 items' is turned OFF.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used for requests. Apify Proxy is recommended to avoid rate-limiting by Yahoo Auctions. For best reliability with this Japanese site you can select Residential proxies with country Japan.", "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 } } } } } } } } } }