{ "openapi": "3.0.1", "info": { "title": "Yahoo Auctions JP Scraper: New Listing Alerts & Sold Items", "description": "Yahoo Auctions Japan scraper without login: search by keyword for current bid, start and buy-now price, bids, end time and seller type. Alerts for new auctions, price rises and auctions ending soon, plus a sold items tracker with Yahoo's final price and sell-through rate. Pay per auction.", "version": "1.0", "x-build-id": "hbuGjd6NddenJgv6l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~yahoo-auctions-jp-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-yahoo-auctions-jp-lookup", "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/accountable_eel~yahoo-auctions-jp-lookup/runs": { "post": { "operationId": "runs-sync-accountable_eel-yahoo-auctions-jp-lookup", "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/accountable_eel~yahoo-auctions-jp-lookup/run-sync": { "post": { "operationId": "run-sync-accountable_eel-yahoo-auctions-jp-lookup", "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": [ "searches" ], "properties": { "searches": { "title": "Yahoo Auctions Japan searches (keywords or a pasted search link)", "type": "array", "description": "One search per line: keywords like \"ゲームボーイ\" or \"nintendo switch\", or a search link copied from auctions.yahoo.co.jp (its own category, brand, price and sort filters are kept). No login required. Accepted formats: ゲームボーイ, nintendo switch, https://auctions.yahoo.co.jp/search/search?p=%E3%83%9D%E3%82%B1%E3%83%A2%E3%83%B3%E3%82%AB%E3%83%BC%E3%83%89&s1=end&o1=a. You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit." }, "maxListingsPerSearch": { "title": "Most auctions to return per search", "type": "integer", "description": "Yahoo shows 50 or 100 auctions per page; this actor pages automatically, up to 1,000 per search. You pay per auction returned, so this is also your budget control.", "default": 100 }, "sort": { "title": "Sort", "enum": [ "newest", "ending_soonest", "price_low", "price_high", "buy_now_low", "most_bids" ], "type": "string", "description": "Yahoo Auctions' own sort orders. Keep \"Newest first\" for new-auction alerts: it is the order the sold signal can read best.", "default": "newest" }, "minPrice": { "title": "Minimum current price (JPY)", "type": "integer", "description": "Optional. Sent to Yahoo as its own price filter and checked again on every row. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum current price (JPY)", "type": "integer", "description": "Optional. Sent to Yahoo as its own price filter and checked again on every row. With monitoring, an auction whose bids pass this price drops out of the search, so it is only called gone once its end time has passed." }, "endingWithinHours": { "title": "Ending within (hours)", "type": "integer", "description": "Optional. Without monitoring: return only auctions that end within this many hours (the search is read in \"Ending soonest\" order). With monitoring: every auction is still tracked, and one already on your watchlist comes back once more, as changeType \"ending-soon\", when it enters its last hours." }, "deltaMode": { "title": "Only return auctions that are new or changed since the last run", "type": "boolean", "description": "Turns a search into a watchlist: a Yahoo Auctions alert for new listings. An auction is new when its Yahoo auction ID hasn't been returned by a previous run of the same watchlist. Also alerts on buy-it-now price drops, and optionally on price rises, auctions entering their last hours and gone auctions (sold, with Yahoo's final price). Unchanged auctions are removed before you are billed, so a quiet run costs only the run fee. The first run returns and remembers everything; from the second run on you get only what changed. Schedule it and send the rows to Google Sheets, Slack or n8n.", "default": false }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty and we derive one from this run's filters, so two schedules with different filters keep separate memories. Type your own name to keep one memory across a filter change, or to have two schedules share one.", "default": "" }, "alertOnNew": { "title": "Alert on new listings", "type": "boolean", "description": "Part of \"Alert on\" (split into checkboxes so the Console can render it as a plain toggle). On by default.", "default": true }, "alertOnPriceDrop": { "title": "Alert on price drops", "type": "boolean", "description": "Part of \"Alert on\". On by default. For auctions this is the buy-it-now price (即決): bids only ever go up.", "default": true }, "alertOnPriceRise": { "title": "Alert on price rises", "type": "boolean", "description": "Off by default. On: an auction already on your watchlist comes back when its current price has risen, or, with a threshold below, when it has crossed that price since the last run.", "default": false }, "priceRiseAbove": { "title": "Price rise threshold (JPY)", "type": "integer", "description": "Optional, used with \"Alert on price rises\". Alert only when an auction's current price goes from under this amount to this amount or more. Leave empty to alert on every new bid." }, "alertOnGone": { "title": "Alert on gone auctions (sold signal)", "type": "boolean", "description": "Off by default. On: auctions on your watchlist that left Yahoo's open auctions since the last run come back as rows with changeType \"gone\", billed as ordinary rows. When Yahoo's closed-auction results show the sale, soldConfirmed is true and the row carries the final price, bids and sale time. Gone auctions are always counted for the sell-through rate, even with this off.", "default": false }, "minPriceDropPct": { "title": "Minimum price drop to alert on (%)", "type": "integer", "description": "The buy-it-now price must fall at least this much since it was last seen. Default 5%.", "default": 5 }, "skipFirstRun": { "title": "Skip alerts on the first run", "type": "boolean", "description": "On: the run that first starts a watchlist banks every auction silently (no rows, no charge) instead of reporting everything that already existed as \"new\". Off (default): the first run returns everything it finds, all marked new.", "default": false }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "searchQuery", "sort", "listingCount", "totalAvailable", "truncated", "newCount", "priceDropCount", "priceRiseCount", "endingSoonCount", "goneCount", "soldCount", "sellThroughRate", "medianPrice", "listings", "listingId", "url", "title", "price", "currency", "priceEur", "currentPrice", "startPrice", "buyNowPrice", "bidCount", "endsAt", "endsInHours", "postedAt", "auctionStatus", "condition", "categoryId", "shippingFee", "isFreeShipping", "imageUrl", "sellerType", "sellerRatingPct", "sellerHash", "isPromoted", "isNew", "changeType", "previousPrice", "priceDropPct", "firstSeenAt", "lastSeenAt", "daysListed", "lastPrice", "finalPrice", "endedAt", "gonePresumedSold", "soldConfirmed" ], "enumTitles": [ "Search", "Sort order used", "Auctions returned", "Total matching on Yahoo Auctions", "More results were available", "New auctions this run", "Buy-now price drops this run", "Price rises this run", "Entered the ending-soon window this run", "Gone since last run (sold or ended; monitoring only)", "Of those, sold per Yahoo's closed auctions", "Sell-through rate, watchlist lifetime (0-1; monitoring only)", "Median current price of the search, JPY (monitoring only)", "All auctions found (full list)", "Yahoo auction ID", "Auction link", "Title", "Price, JPY (current bid; final price on sold rows)", "Currency", "Price in EUR (ECB rate)", "Current price, JPY", "Start price, JPY", "Buy-it-now price (即決), JPY", "Bids", "Auction ends", "Hours left", "Auction started", "Status (open / sold / ended_unsold / gone)", "Condition (unused when Yahoo marks it 未使用)", "Yahoo category ID", "Shipping fee, JPY (0 = free)", "Free shipping", "Image", "Seller type (store / private)", "Seller good ratings %", "Seller (anonymous hash)", "Promoted (seller pays for placement)", "Is this auction new?", "Change (new / price-drop / price-rise / ending-soon / gone / seen)", "Price at the last sighting, JPY", "Buy-now price drop %", "First seen on a run", "Last seen on a run", "Days tracked (first to last seen)", "Last price seen before it went, JPY (gone rows)", "Final sold price, JPY (sold rows)", "Sold at (sold rows)", "Sold or presumed sold (gone rows)", "Sale confirmed by Yahoo (true sold / false ended unsold / empty unknown)" ] }, "default": [ "searchQuery", "sort", "listingCount", "totalAvailable", "truncated", "newCount", "priceDropCount", "priceRiseCount", "endingSoonCount", "goneCount", "soldCount", "sellThroughRate", "medianPrice", "listings", "listingId", "url", "title", "price", "currency", "priceEur", "currentPrice", "startPrice", "buyNowPrice", "bidCount", "endsAt", "endsInHours", "postedAt", "auctionStatus", "condition", "categoryId", "shippingFee", "isFreeShipping", "imageUrl", "sellerType", "sellerRatingPct", "sellerHash", "isPromoted", "isNew", "changeType", "previousPrice", "priceDropPct", "firstSeenAt", "lastSeenAt", "daysListed", "lastPrice", "finalPrice", "endedAt", "gonePresumedSold", "soldConfirmed" ] }, "expandRows": { "title": "One row per listing (recommended) — turn off for one row per search instead", "type": "boolean", "description": "When on, each listing found gets its own row instead of being grouped under its search. You're still only charged once per search, no matter how many rows it produces.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy config. Residential recommended for anti-bot-sensitive targets.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }