{ "data": { "id": "AOIXInZdB0eCJcZAv", "actId": "8raiIZV6QWeCsD4z3", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-11-08T13:01:34.614Z", "finishedAt": "2026-11-08T13:01:39.845Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 5092, "runTimeSecs": 5.092, "computeUnits": 0.005657777777777778, "imageSizeBytes": 361230848 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"Yahoo Auctions Japan Live & Sold Auction Scraper Input\",\n \"description\": \"Search live or sold Yahoo Auctions Japan listings by keyword, category, seller or item ID. Filter by price, condition, listing type and prefecture, then enrich rows with full item details.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"What to scrape on Yahoo Auctions Japan.\",\n \"editor\": \"select\",\n \"enum\": [\n \"keywordSearch\",\n \"browseCategory\",\n \"soldSearch\",\n \"sellerListings\",\n \"itemDetails\",\n \"searchItems\",\n \"soldItems\",\n \"sellerItems\"\n ],\n \"enumTitles\": [\n \"Keyword search (live auctions)\",\n \"Browse category (live auctions)\",\n \"Sold search (closed auctions, final prices)\",\n \"Seller listings (live auctions by seller)\",\n \"Item details (by item ID or URL)\",\n \"Search items (legacy alias)\",\n \"Sold items (legacy alias)\",\n \"Seller items (legacy alias)\"\n ],\n \"default\": \"keywordSearch\",\n \"prefill\": \"keywordSearch\",\n \"sectionCaption\": \"What to scrape\"\n },\n \"searchQueries\": {\n \"title\": \"Search keywords\",\n \"type\": \"array\",\n \"description\": \"One or more keywords, Japanese or English (mode=keywordSearch, soldSearch). Each keyword is searched separately until maxItems is reached.\",\n \"editor\": \"stringList\",\n \"prefill\": [\n \"PlayStation 5\"\n ]\n },\n \"excludeKeywords\": {\n \"title\": \"Exclude keywords\",\n \"type\": \"array\",\n \"description\": \"Listings containing any of these words are removed (all search modes).\",\n \"editor\": \"stringList\"\n },\n \"categoryIds\": {\n \"title\": \"Category IDs\",\n \"type\": \"array\",\n \"description\": \"Yahoo Auctions category IDs, e.g. 23336 for Computers. Used by browseCategory and as an optional filter for keywordSearch/soldSearch.\",\n \"editor\": \"stringList\"\n },\n \"sellerIds\": {\n \"title\": \"Seller IDs\",\n \"type\": \"array\",\n \"description\": \"Seller IDs or seller page URLs (mode=sellerListings), e.g. FCm8JEeKSC4qTg4Ww3SAS54XL2aKF.\",\n \"editor\": \"stringList\"\n },\n \"itemIds\": {\n \"title\": \"Item IDs or URLs\",\n \"type\": \"array\",\n \"description\": \"Auction IDs or item page URLs (mode=itemDetails), e.g. w1250838886 or https://page.auctions.yahoo.co.jp/jp/auction/w1250838886.\",\n \"editor\": \"stringList\"\n },\n \"condition\": {\n \"title\": \"Item condition\",\n \"type\": \"string\",\n \"description\": \"Only return listings in this condition grade.\",\n \"editor\": \"select\",\n \"enum\": [\n \"any\",\n \"new\",\n \"used\",\n \"likeNew\",\n \"excellent\",\n \"good\",\n \"acceptable\",\n \"poor\"\n ],\n \"enumTitles\": [\n \"Any condition\",\n \"New\",\n \"Used (any grade)\",\n \"Used - Like New\",\n \"Used - Excellent\",\n \"Used - Good\",\n \"Used - Acceptable\",\n \"Used - Poor\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\",\n \"sectionCaption\": \"Filters\"\n },\n \"listingType\": {\n \"title\": \"Listing type\",\n \"type\": \"string\",\n \"description\": \"Auctions, fixed-price listings, or both.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"auction\",\n \"fixedPrice\"\n ],\n \"enumTitles\": [\n \"Auctions and fixed-price\",\n \"Auctions only\",\n \"Fixed-price only\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n },\n \"sortBy\": {\n \"title\": \"Sort by\",\n \"type\": \"string\",\n \"description\": \"Result order. When Yahoo's JSON endpoint is unavailable, fallback pages are sorted locally within each fetched page window.\",\n \"editor\": \"select\",\n \"enum\": [\n \"endingSoon\",\n \"endingLast\",\n \"newest\",\n \"priceAsc\",\n \"priceDesc\",\n \"bidsDesc\",\n \"bidsAsc\",\n \"buyNowPriceAsc\",\n \"buyNowPriceDesc\",\n \"totalPriceAsc\",\n \"totalPriceDesc\",\n \"watchCountDesc\",\n \"relevance\",\n \"featured\",\n \"endTime\",\n \"price_asc\",\n \"price_desc\",\n \"bids\",\n \"new\",\n \"popular\"\n ],\n \"enumTitles\": [\n \"Ending soonest\",\n \"Ending last\",\n \"Newest listed\",\n \"Price: low to high\",\n \"Price: high to low\",\n \"Most bids\",\n \"Fewest bids\",\n \"Buy-it-now price: low to high\",\n \"Buy-it-now price: high to low\",\n \"Total price incl. shipping: low to high\",\n \"Total price incl. shipping: high to low\",\n \"Most watched\",\n \"Best match\",\n \"Featured first\",\n \"Ending soonest (legacy alias)\",\n \"Price: low to high (legacy alias)\",\n \"Price: high to low (legacy alias)\",\n \"Most bids (legacy alias)\",\n \"Newest listed (legacy alias)\",\n \"Best match (legacy alias)\"\n ],\n \"default\": \"relevance\",\n \"prefill\": \"relevance\"\n },\n \"minPrice\": {\n \"title\": \"Minimum price (JPY)\",\n \"type\": \"integer\",\n \"description\": \"Only include listings at or above this price in yen.\",\n \"minimum\": 0,\n \"maximum\": 1000000000\n },\n \"maxPrice\": {\n \"title\": \"Maximum price (JPY)\",\n \"type\": \"integer\",\n \"description\": \"Only include listings at or below this price in yen.\",\n \"minimum\": 0,\n \"maximum\": 1000000000\n },\n \"priceType\": {\n \"title\": \"Price filter applies to\",\n \"type\": \"string\",\n \"description\": \"Use the current bid price or the buy-it-now price for minPrice/maxPrice.\",\n \"editor\": \"select\",\n \"enum\": [\n \"currentPrice\",\n \"buyNowPrice\"\n ],\n \"enumTitles\": [\n \"Current bid price\",\n \"Buy-it-now price\"\n ],\n \"default\": \"currentPrice\",\n \"prefill\": \"currentPrice\"\n },\n \"prefecture\": {\n \"title\": \"Item location\",\n \"type\": \"string\",\n \"description\": \"Only include listings located in this prefecture.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"01\",\n \"02\",\n \"03\",\n \"04\",\n \"05\",\n \"06\",\n \"07\",\n \"08\",\n \"09\",\n \"10\",\n \"11\",\n \"12\",\n \"13\",\n \"14\",\n \"15\",\n \"16\",\n \"17\",\n \"18\",\n \"19\",\n \"20\",\n \"21\",\n \"22\",\n \"23\",\n \"24\",\n \"25\",\n \"26\",\n \"27\",\n \"28\",\n \"29\",\n \"30\",\n \"31\",\n \"32\",\n \"33\",\n \"34\",\n \"35\",\n \"36\",\n \"37\",\n \"38\",\n \"39\",\n \"40\",\n \"41\",\n \"42\",\n \"43\",\n \"44\",\n \"45\",\n \"46\",\n \"47\"\n ],\n \"enumTitles\": [\n \"Any prefecture\",\n \"Hokkaido\",\n \"Aomori\",\n \"Iwate\",\n \"Miyagi\",\n \"Akita\",\n \"Yamagata\",\n \"Fukushima\",\n \"Ibaraki\",\n \"Tochigi\",\n \"Gunma\",\n \"Saitama\",\n \"Chiba\",\n \"Tokyo\",\n \"Kanagawa\",\n \"Niigata\",\n \"Toyama\",\n \"Ishikawa\",\n \"Fukui\",\n \"Yamanashi\",\n \"Nagano\",\n \"Gifu\",\n \"Shizuoka\",\n \"Aichi\",\n \"Mie\",\n \"Shiga\",\n \"Kyoto\",\n \"Osaka\",\n \"Hyogo\",\n \"Nara\",\n \"Wakayama\",\n \"Tottori\",\n \"Shimane\",\n \"Okayama\",\n \"Hiroshima\",\n \"Yamaguchi\",\n \"Tokushima\",\n \"Kagawa\",\n \"Ehime\",\n \"Kochi\",\n \"Fukuoka\",\n \"Saga\",\n \"Nagasaki\",\n \"Kumamoto\",\n \"Oita\",\n \"Miyazaki\",\n \"Kagoshima\",\n \"Okinawa\"\n ],\n \"default\": \"\"\n },\n \"freeShippingOnly\": {\n \"title\": \"Free shipping only\",\n \"type\": \"boolean\",\n \"description\": \"Only return listings whose seller offers free shipping.\",\n \"default\": false,\n \"prefill\": false\n },\n \"buyItNowOnly\": {\n \"title\": \"Has buy-it-now price\",\n \"type\": \"boolean\",\n \"description\": \"Only return listings that offer a buy-it-now price.\",\n \"default\": false,\n \"prefill\": false\n },\n \"maxItems\": {\n \"title\": \"Max records\",\n \"type\": \"integer\",\n \"description\": \"Maximum number of auction records to return across all keywords and pages.\",\n \"minimum\": 1,\n \"maximum\": 5000,\n \"default\": 20,\n \"prefill\": 3,\n \"sectionCaption\": \"Output\"\n },\n \"includeDetails\": {\n \"title\": \"Fetch full item details\",\n \"type\": \"boolean\",\n \"description\": \"Open each item page to add description, all photos, bidder count, seller rating/location and shipping methods. Adds one request per record.\",\n \"default\": false,\n \"prefill\": false\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# Yahoo Auctions Japan Live & Sold Auction Scraper\n\nYahoo Auctions Japan (ヤフオク!) is the country's biggest consumer auction site. This actor turns its public listings into clean JSON: live auctions with current bids and buy-it-now prices, closed auctions with the price they actually sold for, seller storefronts, and individual item pages with descriptions and full photo sets.\n\nNo Yahoo account, cookie, API key or proxy setup is needed.\n\n## What you can scrape\n\n| Mode | What it returns |\n|---|---|\n| `keywordSearch` | Live listings for one or more keywords |\n| `browseCategory` | Live listings from a category ID, optionally narrowed by keyword |\n| `soldSearch` | Closed auctions with final sold prices — useful for sold-price comparisons |\n| `sellerListings` | Live listings from one or more seller IDs |\n| `itemDetails` | Full detail pages for a list of item IDs or item URLs |\n\nEvery mode supports price bounds, condition grade, listing type, prefecture, free-shipping and buy-it-now filters where Yahoo exposes them. Keyword modes also accept excluded words.\n\n## Record fields\n\nPrices are whole yen (`JPY`). Empty fields are omitted rather than written as `null`.\n\n| Field | Meaning |\n|---|---|\n| `itemId` | Yahoo auction ID |\n| `itemUrl` | Direct link to the listing |\n| `title` | Listing title |\n| `currentPrice` | Current bid, or the final price on sold rows |\n| `soldPrice` | Final winning price on closed auctions |\n| `priceType` | `current` or `final` |\n| `buyItNowPrice` | Buy-it-now price, when offered |\n| `startPrice` | Starting price |\n| `currency` | Always `JPY` |\n| `bids` | Bid count (`0` is kept) |\n| `watchCount` | Number of watchers |\n| `biddersCount` | Distinct bidders (detail pages) |\n| `condition`, `conditionCode` | English condition and Yahoo's grade code |\n| `conditionNameJa` | Yahoo's Japanese condition label (detail pages) |\n| `startDate`, `endDate` | ISO 8601 timestamps |\n| `timeRemainingSeconds` | Seconds left on live listings |\n| `seller`, `sellerId`, `sellerUrl` | Seller identity and storefront link |\n| `sellerDisplayName`, `sellerRating`, `sellerRatingCount` | Seller reputation |\n| `sellerLocation`, `prefecture`, `prefectureCode` | Item location |\n| `category`, `categoryId`, `categoryPath` | Category name, ID and hierarchy |\n| `brand` | Brand path, when Yahoo lists one |\n| `imageUrl`, `imageUrls` | Main image and full photo set |\n| `shippingFee`, `shippingFeeType`, `freeShipping` | Shipping cost and who pays |\n| `shippingMethods`, `shipSchedule`, `shippingPaidBy` | Delivery options |\n| `listingType` | `auction` or `fixedPrice` |\n| `marketplace` | `yahooAuctions` or `paypayFleaMarket` |\n| `status` | `open` or `closed` |\n| `quantity`, `returnable`, `isWorldwideDelivery` | Item terms |\n| `description`, `descriptionHtml` | Full item description (detail pages) |\n| `scrapedAt` | ISO 8601 scrape timestamp |\n\n## Input reference\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `keywordSearch` | `keywordSearch`, `browseCategory`, `soldSearch`, `sellerListings` or `itemDetails` |\n| `searchQueries` | array | – | Keywords, Japanese or English; each runs until `maxItems` |\n| `excludeKeywords` | array | – | Remove listings containing any of these words |\n| `categoryIds` | array | – | Numeric category IDs, e.g. `23336` for Computers |\n| `sellerIds` | array | – | Seller IDs or seller page URLs (`sellerListings`) |\n| `itemIds` | array | – | Auction IDs or item URLs (`itemDetails`) |\n| `condition` | string | `any` | `any`, `new`, `used`, `likeNew`, `excellent`, `good`, `acceptable` or `poor` |\n| `listingType` | string | `all` | `all`, `auction` or `fixedPrice` |\n| `sortBy` | string | `relevance` | 14 orders: ending soonest/last, newest, price, bids, buy-it-now price, total price incl. shipping, watchers, relevance, featured |\n| `minPrice` | integer | – | Minimum price in yen |\n| `maxPrice` | integer | – | Maximum price in yen |\n| `priceType` | string | `currentPrice` | Apply `minPrice`/`maxPrice` to `currentPrice` or `buyNowPrice` |\n| `prefecture` | string | Any prefecture | Two-digit Japanese prefecture code; use the dropdown for names |\n| `freeShippingOnly` | boolean | `false` | Keep only free-shipping listings |\n| `buyItNowOnly` | boolean | `false` | Keep only listings with a buy-it-now price |\n| `maxItems` | integer | `20` | 1 to 5,000 records per run |\n| `includeDetails` | boolean | `false` | Open each item page for description, photos, bidder count, seller rating/location and shipping methods |\n\n### Example: live keyword search\n\n```json\n{\n \"mode\": \"keywordSearch\",\n \"searchQueries\": [\"PlayStation 5\", \"Nintendo Switch\"],\n \"condition\": \"used\",\n \"minPrice\": 5000,\n \"maxPrice\": 40000,\n \"sortBy\": \"endingSoon\",\n \"maxItems\": 100\n}\n```\n\n### Example: sold-price comparison\n\n```json\n{\n \"mode\": \"soldSearch\",\n \"searchQueries\": [\"Leica M6\"],\n \"sortBy\": \"endingLast\",\n \"maxItems\": 50,\n \"includeDetails\": true\n}\n```\n\n### Example: browse a category\n\n```json\n{\n \"mode\": \"browseCategory\",\n \"categoryIds\": [\"23336\"],\n \"listingType\": \"fixedPrice\",\n \"sortBy\": \"priceAsc\",\n \"maxItems\": 200\n}\n```\n\n### Example: item pages from a list of URLs\n\n```json\n{\n \"mode\": \"itemDetails\",\n \"itemIds\": [\n \"w1250838886\",\n \"https://page.auctions.yahoo.co.jp/jp/auction/e1251357399\"\n ]\n}\n```\n\n## Pagination and limits\n\nThe actor follows result pages until `maxItems` is reached or Yahoo stops returning new records. Yahoo serves roughly 100 records per page and makes about 15,000 results browsable per search; very broad queries can hit that window. Split a broad search by category, price band or condition to reach deeper stock. Closed-auction history covers roughly the last 180 days.\n\n## FAQ\n\n**Do I need a Yahoo Japan login or API key?**\nNo. The actor reads publicly visible Yahoo Auctions Japan pages and the site's own public JSON endpoints.\n\n**Are sold prices real winning prices?**\nYes — `soldSearch` reads closed auctions and reports the final price Yahoo records, not an estimate.\n\n**Why do some rows have no buy-it-now price?**\nOnly fixed-price listings and auctions that offer instant purchase have one; the field is omitted otherwise.\n\n**Can I search in Japanese?**\nYes. Pass Japanese keywords directly, exactly as you would type them into Yahoo's search box.\n\n**How do I find a category or seller ID?**\nOpen the category or seller page on auctions.yahoo.co.jp and copy the numeric category ID or the seller ID from the URL. Seller and item URLs are accepted too.\n\n**Why are some prices 0 or 1 yen?**\nThose are live auctions with a low starting bid and no bids yet. Check `bids` and `startPrice` to tell them apart.\n\n**Does this actor cover PayPay Flea Market?**\nClosed searches can include flea-market rows from Yahoo's network; they are marked with `marketplace: \"paypayFleaMarket\"` and link to the flea-market item page. `itemDetails` covers Yahoo auction pages only.\n\n**Is this affiliated with Yahoo Japan?**\nNo. This is an independent tool that reads publicly available pages and is not endorsed by LY Corporation.\n\n## Data source\n\nPublic listing, category, seller, closed-auction and item pages on `auctions.yahoo.co.jp` (plus the site's own JSON endpoints). No login, cookies, credentials or user proxy configuration are required.\n", "actorDefinition": { "actorSpecification": 1, "name": "yahoo-auctions-japan-keyword-and-category-price", "title": "Yahoo Auctions Japan Live & Sold Auction Scraper", "description": "Search Yahoo Auctions Japan by keyword, category, seller or item ID. Get live bids and buy-it-now prices, ended-auction final prices, condition, bid and watch counts, shipping, seller ratings and full item details — with price, condition, listing-type and prefecture filters.", "version": "1.1", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# Yahoo Auctions Japan Live & Sold Auction Scraper\n\nYahoo Auctions Japan (ヤフオク!) is the country's biggest consumer auction site. This actor turns its public listings into clean JSON: live auctions with current bids and buy-it-now prices, closed auctions with the price they actually sold for, seller storefronts, and individual item pages with descriptions and full photo sets.\n\nNo Yahoo account, cookie, API key or proxy setup is needed.\n\n## What you can scrape\n\n| Mode | What it returns |\n|---|---|\n| `keywordSearch` | Live listings for one or more keywords |\n| `browseCategory` | Live listings from a category ID, optionally narrowed by keyword |\n| `soldSearch` | Closed auctions with final sold prices — useful for sold-price comparisons |\n| `sellerListings` | Live listings from one or more seller IDs |\n| `itemDetails` | Full detail pages for a list of item IDs or item URLs |\n\nEvery mode supports price bounds, condition grade, listing type, prefecture, free-shipping and buy-it-now filters where Yahoo exposes them. Keyword modes also accept excluded words.\n\n## Record fields\n\nPrices are whole yen (`JPY`). Empty fields are omitted rather than written as `null`.\n\n| Field | Meaning |\n|---|---|\n| `itemId` | Yahoo auction ID |\n| `itemUrl` | Direct link to the listing |\n| `title` | Listing title |\n| `currentPrice` | Current bid, or the final price on sold rows |\n| `soldPrice` | Final winning price on closed auctions |\n| `priceType` | `current` or `final` |\n| `buyItNowPrice` | Buy-it-now price, when offered |\n| `startPrice` | Starting price |\n| `currency` | Always `JPY` |\n| `bids` | Bid count (`0` is kept) |\n| `watchCount` | Number of watchers |\n| `biddersCount` | Distinct bidders (detail pages) |\n| `condition`, `conditionCode` | English condition and Yahoo's grade code |\n| `conditionNameJa` | Yahoo's Japanese condition label (detail pages) |\n| `startDate`, `endDate` | ISO 8601 timestamps |\n| `timeRemainingSeconds` | Seconds left on live listings |\n| `seller`, `sellerId`, `sellerUrl` | Seller identity and storefront link |\n| `sellerDisplayName`, `sellerRating`, `sellerRatingCount` | Seller reputation |\n| `sellerLocation`, `prefecture`, `prefectureCode` | Item location |\n| `category`, `categoryId`, `categoryPath` | Category name, ID and hierarchy |\n| `brand` | Brand path, when Yahoo lists one |\n| `imageUrl`, `imageUrls` | Main image and full photo set |\n| `shippingFee`, `shippingFeeType`, `freeShipping` | Shipping cost and who pays |\n| `shippingMethods`, `shipSchedule`, `shippingPaidBy` | Delivery options |\n| `listingType` | `auction` or `fixedPrice` |\n| `marketplace` | `yahooAuctions` or `paypayFleaMarket` |\n| `status` | `open` or `closed` |\n| `quantity`, `returnable`, `isWorldwideDelivery` | Item terms |\n| `description`, `descriptionHtml` | Full item description (detail pages) |\n| `scrapedAt` | ISO 8601 scrape timestamp |\n\n## Input reference\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `keywordSearch` | `keywordSearch`, `browseCategory`, `soldSearch`, `sellerListings` or `itemDetails` |\n| `searchQueries` | array | – | Keywords, Japanese or English; each runs until `maxItems` |\n| `excludeKeywords` | array | – | Remove listings containing any of these words |\n| `categoryIds` | array | – | Numeric category IDs, e.g. `23336` for Computers |\n| `sellerIds` | array | – | Seller IDs or seller page URLs (`sellerListings`) |\n| `itemIds` | array | – | Auction IDs or item URLs (`itemDetails`) |\n| `condition` | string | `any` | `any`, `new`, `used`, `likeNew`, `excellent`, `good`, `acceptable` or `poor` |\n| `listingType` | string | `all` | `all`, `auction` or `fixedPrice` |\n| `sortBy` | string | `relevance` | 14 orders: ending soonest/last, newest, price, bids, buy-it-now price, total price incl. shipping, watchers, relevance, featured |\n| `minPrice` | integer | – | Minimum price in yen |\n| `maxPrice` | integer | – | Maximum price in yen |\n| `priceType` | string | `currentPrice` | Apply `minPrice`/`maxPrice` to `currentPrice` or `buyNowPrice` |\n| `prefecture` | string | Any prefecture | Two-digit Japanese prefecture code; use the dropdown for names |\n| `freeShippingOnly` | boolean | `false` | Keep only free-shipping listings |\n| `buyItNowOnly` | boolean | `false` | Keep only listings with a buy-it-now price |\n| `maxItems` | integer | `20` | 1 to 5,000 records per run |\n| `includeDetails` | boolean | `false` | Open each item page for description, photos, bidder count, seller rating/location and shipping methods |\n\n### Example: live keyword search\n\n```json\n{\n \"mode\": \"keywordSearch\",\n \"searchQueries\": [\"PlayStation 5\", \"Nintendo Switch\"],\n \"condition\": \"used\",\n \"minPrice\": 5000,\n \"maxPrice\": 40000,\n \"sortBy\": \"endingSoon\",\n \"maxItems\": 100\n}\n```\n\n### Example: sold-price comparison\n\n```json\n{\n \"mode\": \"soldSearch\",\n \"searchQueries\": [\"Leica M6\"],\n \"sortBy\": \"endingLast\",\n \"maxItems\": 50,\n \"includeDetails\": true\n}\n```\n\n### Example: browse a category\n\n```json\n{\n \"mode\": \"browseCategory\",\n \"categoryIds\": [\"23336\"],\n \"listingType\": \"fixedPrice\",\n \"sortBy\": \"priceAsc\",\n \"maxItems\": 200\n}\n```\n\n### Example: item pages from a list of URLs\n\n```json\n{\n \"mode\": \"itemDetails\",\n \"itemIds\": [\n \"w1250838886\",\n \"https://page.auctions.yahoo.co.jp/jp/auction/e1251357399\"\n ]\n}\n```\n\n## Pagination and limits\n\nThe actor follows result pages until `maxItems` is reached or Yahoo stops returning new records. Yahoo serves roughly 100 records per page and makes about 15,000 results browsable per search; very broad queries can hit that window. Split a broad search by category, price band or condition to reach deeper stock. Closed-auction history covers roughly the last 180 days.\n\n## FAQ\n\n**Do I need a Yahoo Japan login or API key?**\nNo. The actor reads publicly visible Yahoo Auctions Japan pages and the site's own public JSON endpoints.\n\n**Are sold prices real winning prices?**\nYes — `soldSearch` reads closed auctions and reports the final price Yahoo records, not an estimate.\n\n**Why do some rows have no buy-it-now price?**\nOnly fixed-price listings and auctions that offer instant purchase have one; the field is omitted otherwise.\n\n**Can I search in Japanese?**\nYes. Pass Japanese keywords directly, exactly as you would type them into Yahoo's search box.\n\n**How do I find a category or seller ID?**\nOpen the category or seller page on auctions.yahoo.co.jp and copy the numeric category ID or the seller ID from the URL. Seller and item URLs are accepted too.\n\n**Why are some prices 0 or 1 yen?**\nThose are live auctions with a low starting bid and no bids yet. Check `bids` and `startPrice` to tell them apart.\n\n**Does this actor cover PayPay Flea Market?**\nClosed searches can include flea-market rows from Yahoo's network; they are marked with `marketplace: \"paypayFleaMarket\"` and link to the flea-market item page. `itemDetails` covers Yahoo auction pages only.\n\n**Is this affiliated with Yahoo Japan?**\nNo. This is an independent tool that reads publicly available pages and is not endorsed by LY Corporation.\n\n## Data source\n\nPublic listing, category, seller, closed-auction and item pages on `auctions.yahoo.co.jp` (plus the site's own JSON endpoints). No login, cookies, credentials or user proxy configuration are required.\n", "input": { "title": "Yahoo Auctions Japan Live & Sold Auction Scraper Input", "description": "Search live or sold Yahoo Auctions Japan listings by keyword, category, seller or item ID. Filter by price, condition, listing type and prefecture, then enrich rows with full item details.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "What to scrape on Yahoo Auctions Japan.", "editor": "select", "enum": [ "keywordSearch", "browseCategory", "soldSearch", "sellerListings", "itemDetails", "searchItems", "soldItems", "sellerItems" ], "enumTitles": [ "Keyword search (live auctions)", "Browse category (live auctions)", "Sold search (closed auctions, final prices)", "Seller listings (live auctions by seller)", "Item details (by item ID or URL)", "Search items (legacy alias)", "Sold items (legacy alias)", "Seller items (legacy alias)" ], "default": "keywordSearch", "prefill": "keywordSearch", "sectionCaption": "What to scrape" }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "One or more keywords, Japanese or English (mode=keywordSearch, soldSearch). Each keyword is searched separately until maxItems is reached.", "editor": "stringList", "prefill": [ "PlayStation 5" ] }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Listings containing any of these words are removed (all search modes).", "editor": "stringList" }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Yahoo Auctions category IDs, e.g. 23336 for Computers. Used by browseCategory and as an optional filter for keywordSearch/soldSearch.", "editor": "stringList" }, "sellerIds": { "title": "Seller IDs", "type": "array", "description": "Seller IDs or seller page URLs (mode=sellerListings), e.g. FCm8JEeKSC4qTg4Ww3SAS54XL2aKF.", "editor": "stringList" }, "itemIds": { "title": "Item IDs or URLs", "type": "array", "description": "Auction IDs or item page URLs (mode=itemDetails), e.g. w1250838886 or https://page.auctions.yahoo.co.jp/jp/auction/w1250838886.", "editor": "stringList" }, "condition": { "title": "Item condition", "type": "string", "description": "Only return listings in this condition grade.", "editor": "select", "enum": [ "any", "new", "used", "likeNew", "excellent", "good", "acceptable", "poor" ], "enumTitles": [ "Any condition", "New", "Used (any grade)", "Used - Like New", "Used - Excellent", "Used - Good", "Used - Acceptable", "Used - Poor" ], "default": "any", "prefill": "any", "sectionCaption": "Filters" }, "listingType": { "title": "Listing type", "type": "string", "description": "Auctions, fixed-price listings, or both.", "editor": "select", "enum": [ "all", "auction", "fixedPrice" ], "enumTitles": [ "Auctions and fixed-price", "Auctions only", "Fixed-price only" ], "default": "all", "prefill": "all" }, "sortBy": { "title": "Sort by", "type": "string", "description": "Result order. When Yahoo's JSON endpoint is unavailable, fallback pages are sorted locally within each fetched page window.", "editor": "select", "enum": [ "endingSoon", "endingLast", "newest", "priceAsc", "priceDesc", "bidsDesc", "bidsAsc", "buyNowPriceAsc", "buyNowPriceDesc", "totalPriceAsc", "totalPriceDesc", "watchCountDesc", "relevance", "featured", "endTime", "price_asc", "price_desc", "bids", "new", "popular" ], "enumTitles": [ "Ending soonest", "Ending last", "Newest listed", "Price: low to high", "Price: high to low", "Most bids", "Fewest bids", "Buy-it-now price: low to high", "Buy-it-now price: high to low", "Total price incl. shipping: low to high", "Total price incl. shipping: high to low", "Most watched", "Best match", "Featured first", "Ending soonest (legacy alias)", "Price: low to high (legacy alias)", "Price: high to low (legacy alias)", "Most bids (legacy alias)", "Newest listed (legacy alias)", "Best match (legacy alias)" ], "default": "relevance", "prefill": "relevance" }, "minPrice": { "title": "Minimum price (JPY)", "type": "integer", "description": "Only include listings at or above this price in yen.", "minimum": 0, "maximum": 1000000000 }, "maxPrice": { "title": "Maximum price (JPY)", "type": "integer", "description": "Only include listings at or below this price in yen.", "minimum": 0, "maximum": 1000000000 }, "priceType": { "title": "Price filter applies to", "type": "string", "description": "Use the current bid price or the buy-it-now price for minPrice/maxPrice.", "editor": "select", "enum": [ "currentPrice", "buyNowPrice" ], "enumTitles": [ "Current bid price", "Buy-it-now price" ], "default": "currentPrice", "prefill": "currentPrice" }, "prefecture": { "title": "Item location", "type": "string", "description": "Only include listings located in this prefecture.", "editor": "select", "enum": [ "", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47" ], "enumTitles": [ "Any prefecture", "Hokkaido", "Aomori", "Iwate", "Miyagi", "Akita", "Yamagata", "Fukushima", "Ibaraki", "Tochigi", "Gunma", "Saitama", "Chiba", "Tokyo", "Kanagawa", "Niigata", "Toyama", "Ishikawa", "Fukui", "Yamanashi", "Nagano", "Gifu", "Shizuoka", "Aichi", "Mie", "Shiga", "Kyoto", "Osaka", "Hyogo", "Nara", "Wakayama", "Tottori", "Shimane", "Okayama", "Hiroshima", "Yamaguchi", "Tokushima", "Kagawa", "Ehime", "Kochi", "Fukuoka", "Saga", "Nagasaki", "Kumamoto", "Oita", "Miyazaki", "Kagoshima", "Okinawa" ], "default": "" }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only return listings whose seller offers free shipping.", "default": false, "prefill": false }, "buyItNowOnly": { "title": "Has buy-it-now price", "type": "boolean", "description": "Only return listings that offer a buy-it-now price.", "default": false, "prefill": false }, "maxItems": { "title": "Max records", "type": "integer", "description": "Maximum number of auction records to return across all keywords and pages.", "minimum": 1, "maximum": 5000, "default": 20, "prefill": 3, "sectionCaption": "Output" }, "includeDetails": { "title": "Fetch full item details", "type": "boolean", "description": "Open each item page to add description, all photos, bidder count, seller rating/location and shipping methods. Adds one request per record.", "default": false, "prefill": false } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Yahoo Auctions Japan Live & Sold Auction Scraper Output", "description": "Yahoo Auctions Japan listings and sold auctions with prices, bids, condition, shipping, seller and item details.", "properties": { "auctions": { "type": "string", "title": "Yahoo Auctions Japan records", "description": "Dataset containing all scraped Yahoo Auctions Japan listing records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Auction listings", "transformation": { "fields": [ "itemId", "title", "currentPrice", "currency", "buyItNowPrice", "bids", "watchCount", "condition", "endDate", "seller", "prefecture", "itemUrl" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.1.1", "imageDigest": "a7d73f4a004ef959529a28b35e09fcb17645cf2b263315d7e69b185e38f0af22", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.1" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.005657777777777778 } } }