# Buyee Scraper: Yahoo Auctions & Mercari Japan Data (`getascraper/buyee-scraper`) Actor Scrape Buyee.jp product listings from Yahoo Auctions Japan and Mercari Japan by item URL, item ID, or search query - price, bids, seller rating, shipping estimate, condition, category, images, and description. - **URL**: https://apify.com/getascraper/buyee-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.37 / 1,000 item listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🎌 Buyee Scraper: Yahoo Auctions & Mercari Japan Data
Never miss a Yahoo Auctions Japan bid again.
Turn any Buyee.jp listing, Yahoo Auctions item, or Mercari Japan item into structured price, bid, and shipping data, built to actually finish the run.
πŸ”¨ Real bid data
Buy-it-now price, bid count, time remaining, and auction end time 		πŸ’΄ Price in JPY and USD
Buyee's own conversion estimate, no manual math needed 		πŸ“¦ Shipping details up front
Who pays and how many days to the Buyee warehouse 		βœ… Runs that actually finish
Waits for the page to fully load, so you get real rows, not blanks
Give this Actor a **Buyee.jp** (buyee.jp) item link, a raw Yahoo Auctions Japan URL or ID, a Mercari Japan item ID, or a plain search term, and it returns one clean row per listing: title, price in yen with a US dollar estimate, auction bid state or buy-it-now price, seller name and rating, shipping payer and estimated days, item condition, category, images, and description. Built for resellers, collectors, and import/export buyers who source from Japan through Buyee's proxy-buying service. Runs on the Apify platform with scheduling, integrations (Make, Zapier, Google Sheets), and run monitoring built in. ### πŸ” What does Buyee Scraper do? This Actor reads listing pages on buyee.jp, the proxy-buying service that lets international buyers purchase from Yahoo Auctions Japan and Mercari Japan without a Japanese address or payment method. Give it an item link, a raw Yahoo Auctions URL or item ID, a Mercari item ID, or a search term, and it returns the listing title, price in yen with Buyee's own US dollar estimate, item condition, category, seller name and rating breakdown, shipping payer and estimated shipping days, and images. For Yahoo Auctions items it also returns the full item description, buy-it-now availability, starting price, bid count, watcher count, and the auction's start and end time. Set the deep-scan option to follow every search result to its own item page for the complete field set instead of just the summary shown on the results list. ### πŸ’‘ Why use Buyee Scraper? - **I resell Japanese collectibles, streetwear, or watches** and need to track bid counts and auction end times across dozens of listings without refreshing Buyee all day. - **I run an import/export business sourcing from Japan** and want seller ratings and condition notes in a spreadsheet before I commit to a purchase. - **I'm a collector hunting a specific card, figure, or watch** and want to monitor a search term for new listings as they appear. - **I build price-tracking or sourcing tools for Japanese marketplaces** and need clean structured data instead of reading Buyee's pages by hand. ### πŸš€ How to use Buyee Scraper
STEP 1
Add listings or a search term
Paste Buyee, Yahoo Auctions, or Mercari item links and IDs, or just type what you're looking for. 		STEP 2
Run the Actor
It waits for each page to fully load before reading it, so results are never blank. 		STEP 3
Export your results
Download price, bids, seller rating, shipping, and description as a spreadsheet or JSON.
### βš™οΈ Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `startUrls` | array of strings | No | Buyee item URLs (`buyee.jp/item/jdirectitems/auction/...` or `buyee.jp/mercari/item/...`), a raw Yahoo Auctions Japan item URL, a bare Yahoo Auction ID (like `r1236578744`), a bare Mercari item ID (like `m10844932381`), or a Buyee search or category URL. | | `searchQueries` | array of strings | No | Free-text search terms run against Buyee's own search, such as `"pokemon card"`. Returns matching Yahoo Auctions and Mercari listings. | | `scrapeItemDetails` | boolean | No | When a search term or category URL is given, visit every result's own item page for the full field set (price, bids, seller rating, shipping, description). Off by default, which returns only the title, price, and thumbnail shown on the results list. | | `maxItems` | integer | No | Maximum number of items to return across all inputs. Defaults to `50`. | | `proxyConfiguration` | object | No | Proxy routing settings. Defaults to a residential Japanese connection, which this Actor needs for reliable results. | ### πŸ“¦ Output Download the results as a spreadsheet, a table, or structured data ready for your own systems. Each row is one listing: ```` { "itemId": "r1236578744", "itemUrl": "https://buyee.jp/item/jdirectitems/auction/r1236578744", "sourcePlatform": "yahoo\_auction", "title": "ポケヒンカード　パガγƒͺアードンX ex SR γ‚€γƒ³γƒ•γ‚§γƒ«γƒŽX", "priceJpy": 4800, "priceUsdEstimate": 31.06, "currency": "JPY", "buyoutAvailable": true, "numberOfBids": 0, "watchCount": 5, "auctionEndTimeJst": "17 Jul 2026 21:51:13", "condition": "No obvious damages/dirt", "categoryBreadcrumb": \["Toys & Games", "Games", "Trading Card Games", "Pokemon Trading Card Game", "Single cards"], "sellerName": "a\_donyunn", "sellerRatingGood": 590, "sellerFeedbackPercentGood": 100, "estimatedShippingDays": "2nd-3rd", "images": \["https://cdnyauction.buyee.jp/images.auctions.yahoo.co.jp/image/..."], "scrapedAt": "2026-07-17T00:00:00.000Z" } ```` ### πŸ“Š Output data fields | Field | Type | Description | | --- | --- | --- | | `itemId` | string | The listing's own ID on Buyee. | | `itemUrl` | string | The Buyee item page this row was scraped from. | | `sourcePlatform` | string | `yahoo_auction` or `mercari`. | | `title` | string | Listing title, in Japanese as written by the seller. | | `priceJpy` | number | Current price or bid, in yen. | | `priceUsdEstimate` | number | Buyee's own US dollar estimate for the yen price. | | `buyoutAvailable` | boolean | Yahoo Auctions only: whether a buy-it-now price is set. | | `startingPriceJpy` | number | Yahoo Auctions only: the auction's starting price. | | `numberOfBids` | number | Yahoo Auctions only: bids placed so far. | | `watchCount` | number | Yahoo Auctions only: how many buyers are watching the listing. | | `auctionStartTimeJst` | string | Yahoo Auctions only: when the auction opened, Japan time. | | `auctionEndTimeJst` | string | Yahoo Auctions only: when the auction closes, Japan time. | | `timeRemainingText` | string | Yahoo Auctions only: time left, as shown on the page. | | `brand` | string | Mercari only: the brand Buyee lists for the item, when disclosed. | | `condition` | string | Item condition as described by the seller. | | `categoryBreadcrumb` | array | Full category path, from top level down to the listing's own category. | | `sellerName` | string | Seller's display name. | | `sellerRatingGood` / `sellerRatingNormal` / `sellerRatingBad` | number | Seller's feedback counts, when Buyee shows them. | | `sellerFeedbackPercentGood` | number | Yahoo Auctions only: seller's positive feedback percentage. | | `shippingPaidBy` | string | Who covers shipping to the Buyee warehouse. | | `estimatedShippingDays` | string | How long the seller typically takes to ship to Buyee's warehouse. | | `exportRestrictionNote` | string | Present only when Buyee flags the item as restricted from international shipping. | | `description` | string | Full item description. Yahoo Auctions only, see the FAQ below for why. | | `images` | array | Listing photo URLs. | | `scrapedAt` | string | Timestamp when this row was collected. | ### πŸ’° Pricing This Actor uses pay-per-result pricing: you pay for the listings you actually get back, and nothing for an empty run. There is no subscription and no minimum spend. Use `maxItems` to control how many results a run returns. ### ⭐ Enjoying Buyee Scraper: Yahoo Auctions & Mercari Japan Data?
⭐ ⭐ ⭐ ⭐ ⭐
Tracking a Japan auction without refreshing the page all day?
A 5-star rating takes 10 seconds and helps other resellers, collectors, and import buyers sourcing from Japan find it. Your feedback also tells us what to build next.
β˜…  Rate this Actor on Apify
### ✨ Tips - Mix and match input types freely: a direct item link, a bare Yahoo Auction ID, and a search term can all go in the same run. - Turn on `scrapeItemDetails` when you need images from a Mercari search. The results-list thumbnails don't always finish loading in time, but the item page always has real photos. - Leaving `scrapeItemDetails` off returns a lighter record (title, price, thumbnail, link) with brand/condition/description/seller fields genuinely absent, not blank - switch to the dataset's **Search Results (lightweight)** view in the Output tab to see a clean table with no empty columns. Turn `scrapeItemDetails` on for the full field set. - `description` only appears for Yahoo Auctions items. Mercari's own description page is off-limits to automated access on their side, so this Actor never fetches it rather than guess at the content. - Re-run the same search term on a schedule to catch new listings as sellers post them. ### ❓ FAQ, disclaimers, and support **Why does this Actor include a description for Yahoo Auctions items but not Mercari items?** Mercari's description page is blocked from automated access on Buyee's own site. Rather than work around that, this Actor simply never requests it, so `description` is left out for Mercari listings instead of guessed or left blank with no explanation. **Does this need a Buyee account or login?** No. It reads publicly visible listing pages and does not require signing in. **Why did the existing Buyee scraper on Apify fail so often?** The listing pages this Actor reads run a background check before showing content, and a scraper that doesn't wait for that check to finish gets an empty page back. This Actor waits for the real page content before reading anything, so runs come back with actual data instead of blanks. **How fresh is the data?** Every run reads the live listing page at run time. There is no cached or stale data. **Is scraping Buyee data legal?** This Actor collects publicly available listing data. You are responsible for complying with Buyee's Terms of Service and applicable laws in your use of the data. **Found a bug or need a field added?** Open an issue on the Actor's **Issues** tab. Custom solutions are available on request. ### πŸ”— Other actors - [Mercari Japan Scraper: Price, Condition & Seller](https://apify.com/getascraper/mercari-japan-scraper) β†— - scrapes Mercari Japan listings directly, for when you don't need Buyee's proxy-buying layer. - [Mercari Seller Scraper: Shop Listings, Ratings & Item History](https://apify.com/getascraper/mercari-seller-scraper) β†— - profiles a Mercari Japan seller's shop, ratings, and item history. - [Rakuten Price Monitor: ζ₯½ε€©δΎ‘格ヒニター (Ichiba)](https://apify.com/getascraper/rakuten-jp-price-monitor) β†— - tracks price changes on Rakuten Ichiba listings over time. - [Japan Company Scraper: 4.5M+ gBizINFO Records](https://apify.com/getascraper/gbizinfo-japan-company-scraper) β†— - looks up Japanese company registration records for due diligence. # Actor input Schema ## `searchQueries` (type: `array`): Free-text search terms (e.g. "pokemon card"). This is the fastest path for most users - pair it with the Search filters section below to narrow results instead of scraping everything and filtering afterwards. ## `startUrls` (type: `array`): For one-off lookups: Buyee item URLs (buyee.jp/item/jdirectitems/auction/... or buyee.jp/mercari/item/...), raw Yahoo Auctions Japan item URLs (page.auctions.yahoo.co.jp/jp/auction/...), bare Yahoo Auction IDs (e.g. r1236578744), bare Mercari item IDs (e.g. m10844932381), or a raw Buyee search/category URL you built yourself. The Search filters section does not apply to entries here - they are fetched exactly as given. ## `platformScope` (type: `string`): Which marketplace(s) to search. "Both" issues a separate search against Yahoo Auctions/JDirectItems and against Mercari for every search query, so real Mercari results are always included (Buyee's own general search page never surfaces Mercari listings). ## `priceMin` (type: `integer`): Real server-side filter, verified live against buyee.jp: Yahoo Auction search uses aucminprice, Mercari search uses price_min. Leave blank for no minimum. ## `priceMax` (type: `integer`): Real server-side filter, verified live against buyee.jp: Yahoo Auction search uses aucmaxprice, Mercari search uses price_max. Leave blank for no maximum. ## `condition` (type: `array`): Real server-side filter, verified live against both platforms' own search filter UI (Yahoo Auction's item_status, Mercari's condition). You can select more than one for Yahoo Auction (comma-joined, confirmed multi-value); for Mercari only the first selection you pick is sent, since multi-value condition was never verified against Mercari's endpoint - see AGENTS.md. ## `sortOrder` (type: `string`): Real server-side filter (sort + order query params), verified live - but Yahoo Auction / JDirectItems results only. No verified sort param exists for Mercari search, so Mercari results always come back in Buyee's own default order regardless of this setting. ## `buyItNowOnly` (type: `boolean`): Real server-side filter (buynow=1), verified live. Yahoo Auction / JDirectItems only - Mercari listings are already fixed-price, so this has no effect on Mercari results. ## `hasBidsOnly` (type: `boolean`): Client-side post-filter (no verified "has bids" query param exists on buyee.jp). Only takes effect when "Scrape full item details" is on below - lightweight search-list results are never filtered by bid count, since bid count isn't part of the lightweight record. Yahoo Auction only; Mercari has no bidding concept. ## `scrapeItemDetails` (type: `boolean`): When a search query is given, follow every result to its own item page for the full field set (price, seller rating, shipping, description, real bid count). When off (the default), only the fields visible on the results list are returned - faster and cheaper, but the record will NOT include brand, condition, description, seller, or bid-count fields at all (they are omitted, not blank), and "Has bids only" above has no effect. This is a cost/richness tradeoff: turning it on means one extra page navigation per result. ## `maxItems` (type: `integer`): Maximum number of items to return across all start URLs and search queries. ## `categoryId` (type: `string`): Optional raw platform-native category id to scope a search query to one category, e.g. 25464 for Yahoo Auction's "Toys & Games" or 1328 for Mercari's "Games, Toys & Goods". Yahoo Auction and Mercari use two different, incompatible id spaces - see AGENTS.md for the full verified id tables for both. Left free-text rather than a dropdown because a single enum can't cleanly represent both platforms' category trees in one field. ## `proxyConfiguration` (type: `object`): Buyee's item and search pages sit behind AWS WAF Bot Control. Verified during feasibility recon: datacenter proxy gets repeatedly challenged (HTTP 403, several session rotations before a request clears), while residential Japanese IPs clear on the first try every time. Residential JP is the default for reliability - see AGENTS.md for the measured evidence. ## Actor input object example ```json { "searchQueries": [ "pokemon card" ], "startUrls": [], "platformScope": "both", "condition": [], "sortOrder": "relevance", "buyItNowOnly": false, "hasBidsOnly": false, "scrapeItemDetails": false, "maxItems": 50, "categoryId": "", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } ```` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "pokemon card" ], "platformScope": "both", "sortOrder": "relevance", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/buyee-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["pokemon card"], "platformScope": "both", "sortOrder": "relevance", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "JP", }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/buyee-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "pokemon card" ], "platformScope": "both", "sortOrder": "relevance", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } }' | apify call getascraper/buyee-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/buyee-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Buyee Scraper: Yahoo Auctions & Mercari Japan Data", "description": "Scrape Buyee.jp product listings from Yahoo Auctions Japan and Mercari Japan by item URL, item ID, or search query - price, bids, seller rating, shipping estimate, condition, category, images, and description.", "version": "0.3", "x-build-id": "3DdTAaLzRR6FNx57m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~buyee-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-buyee-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/getascraper~buyee-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-buyee-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/getascraper~buyee-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-buyee-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text search terms (e.g. \"pokemon card\"). This is the fastest path for most users - pair it with the Search filters section below to narrow results instead of scraping everything and filtering afterwards.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Item URLs, IDs, or search/category URLs (power users)", "type": "array", "description": "For one-off lookups: Buyee item URLs (buyee.jp/item/jdirectitems/auction/... or buyee.jp/mercari/item/...), raw Yahoo Auctions Japan item URLs (page.auctions.yahoo.co.jp/jp/auction/...), bare Yahoo Auction IDs (e.g. r1236578744), bare Mercari item IDs (e.g. m10844932381), or a raw Buyee search/category URL you built yourself. The Search filters section does not apply to entries here - they are fetched exactly as given.", "default": [], "items": { "type": "string" } }, "platformScope": { "title": "Platform scope", "enum": [ "both", "yahoo_auction", "mercari" ], "type": "string", "description": "Which marketplace(s) to search. \"Both\" issues a separate search against Yahoo Auctions/JDirectItems and against Mercari for every search query, so real Mercari results are always included (Buyee's own general search page never surfaces Mercari listings).", "default": "both" }, "priceMin": { "title": "Minimum price (YEN)", "minimum": 0, "type": "integer", "description": "Real server-side filter, verified live against buyee.jp: Yahoo Auction search uses aucminprice, Mercari search uses price_min. Leave blank for no minimum." }, "priceMax": { "title": "Maximum price (YEN)", "minimum": 0, "type": "integer", "description": "Real server-side filter, verified live against buyee.jp: Yahoo Auction search uses aucmaxprice, Mercari search uses price_max. Leave blank for no maximum." }, "condition": { "title": "Item condition", "type": "array", "description": "Real server-side filter, verified live against both platforms' own search filter UI (Yahoo Auction's item_status, Mercari's condition). You can select more than one for Yahoo Auction (comma-joined, confirmed multi-value); for Mercari only the first selection you pick is sent, since multi-value condition was never verified against Mercari's endpoint - see AGENTS.md.", "items": { "type": "string", "enum": [ "new_unused", "like_new", "good", "fair", "poor", "overall_poor" ], "enumTitles": [ "Unused / New", "Like new / Close to unused", "Good (no noticeable scratches or stains)", "Fair (slight scratches or stains)", "Poor (visible scratches or stains)", "Overall poor condition" ] }, "default": [] }, "sortOrder": { "title": "Sort order", "enum": [ "relevance", "price_low_to_high", "price_high_to_low", "ending_soonest" ], "type": "string", "description": "Real server-side filter (sort + order query params), verified live - but Yahoo Auction / JDirectItems results only. No verified sort param exists for Mercari search, so Mercari results always come back in Buyee's own default order regardless of this setting.", "default": "relevance" }, "buyItNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Real server-side filter (buynow=1), verified live. Yahoo Auction / JDirectItems only - Mercari listings are already fixed-price, so this has no effect on Mercari results.", "default": false }, "hasBidsOnly": { "title": "Has bids only", "type": "boolean", "description": "Client-side post-filter (no verified \"has bids\" query param exists on buyee.jp). Only takes effect when \"Scrape full item details\" is on below - lightweight search-list results are never filtered by bid count, since bid count isn't part of the lightweight record. Yahoo Auction only; Mercari has no bidding concept.", "default": false }, "scrapeItemDetails": { "title": "Scrape full item details", "type": "boolean", "description": "When a search query is given, follow every result to its own item page for the full field set (price, seller rating, shipping, description, real bid count). When off (the default), only the fields visible on the results list are returned - faster and cheaper, but the record will NOT include brand, condition, description, seller, or bid-count fields at all (they are omitted, not blank), and \"Has bids only\" above has no effect. This is a cost/richness tradeoff: turning it on means one extra page navigation per result.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of items to return across all start URLs and search queries.", "default": 50 }, "categoryId": { "title": "Category ID (advanced)", "type": "string", "description": "Optional raw platform-native category id to scope a search query to one category, e.g. 25464 for Yahoo Auction's \"Toys & Games\" or 1328 for Mercari's \"Games, Toys & Goods\". Yahoo Auction and Mercari use two different, incompatible id spaces - see AGENTS.md for the full verified id tables for both. Left free-text rather than a dropdown because a single enum can't cleanly represent both platforms' category trees in one field.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Buyee's item and search pages sit behind AWS WAF Bot Control. Verified during feasibility recon: datacenter proxy gets repeatedly challenged (HTTP 403, several session rotations before a request clears), while residential Japanese IPs clear on the first try every time. Residential JP is the default for reliability - see AGENTS.md for the measured evidence.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } } }, "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 } } } } } } } } } } ```