# Yahoo! Auctions Japan Scraper — Prices, Bids & Listings (`youfuxu/yahoo-auctions-japan-scraper`) Actor
Scrape live listings from Yahoo! Auctions Japan (Yahoo Auction / ヤフオク) by keyword. Get title, current price, buy-now price, bid count, time remaining, seller and images as clean JSON.
- **URL**: https://apify.com/youfuxu/yahoo-auctions-japan-scraper.md
- **Developed by:** [Youfu Xu](https://apify.com/youfuxu) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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
## Yahoo! Auctions Japan Scraper — prices, bids & listings
Extract live listings from **[Yahoo! Auctions Japan](https://auctions.yahoo.co.jp/)** (ヤフオク), Japan's largest auction and resale marketplace. Get title, current price, buy-now price, bid count, time remaining, seller and images as clean JSON by simply typing a keyword — no login, no browser, no proxies to configure.
### What you get
Run it with the default input and you'll receive listings like this in seconds:
```json
{
"auctionId": "m1232507482",
"title": "【新品】【未開封】Nintendo Switch ニンテンドースイッチ（有機ELモデル） Joy-Con(L)/(R) ホワイト",
"currentPriceYen": 60000,
"buyNowPriceYen": 61000,
"startPriceYen": 60000,
"bidCount": 0,
"timeRemainingText": "14時間",
"endTimeUnix": 1784891117,
"postageText": "＋送料980円",
"conditionLabels": ["未使用"],
"sellerId": "DDNNEzVRdCEcxV3QgLCyU3sSPqMA",
"imageUrl": "https://auc-pctr.c.yimg.jp/...",
"itemUrl": "https://auctions.yahoo.co.jp/jp/auction/m1232507482"
}
````
Prices are already parsed into **numeric yen values** (`currentPriceYen`, `buyNowPriceYen`, `startPriceYen`) so you can sort and filter directly — no wrestling with `万円` strings or full-width characters.
Enable **full listing details** to also get category breadcrumb, brand, condition, quantity, shipping lead time, shipping origin prefecture, auction start/end datetime, early-end and auto-extend flags, seller display name, and up to 10 photo URLs.
### Who uses this
- **Resale & arbitrage sellers** — track price trends for a product line, spot underpriced listings, source inventory from Japan
- **Import/export businesses** — monitor Japan-only items (retro electronics, collectibles, watches, trading cards) for cross-border resale
- **Price researchers & data teams** — build historical price indexes for brands or product categories
- **Collectors** — watch a niche category (vintage cameras, figures, watches) across many keywords at once
### How to use
1. Type a **search keyword** — Japanese or English (brand names often work either way).
2. Set **Max listings** (default 50).
3. Optionally choose a **sort order** (newest, ending soonest, price low-to-high, etc.) or restrict to **buy-it-now only** listings.
4. Optionally enable **full listing details**.
5. Run, then download from the **Dataset** tab as JSON / CSV / Excel, or fetch via API.
The default input (`Nintendo Switch`) runs successfully with one click so you can try it immediately.
### Pricing model
You pay per result — a small fee for each listing returned. A 500-listing export costs less than a coffee. No subscription to this Actor beyond your Apify plan.
### FAQ
**Does it work with English keywords?**
Yes for romanized brand/product names (e.g. `Rolex`, `Pokemon card`). For best coverage on Japan-specific terms, search in Japanese.
**What's the difference between current price and buy-now price?**
`currentPriceYen` is the live/starting bid price. `buyNowPriceYen` (即決価格) is the immediate purchase price, if the seller offers one — many listings are bid-only and this field will be empty.
**How fresh is the data?**
Live. Every run queries Yahoo! Auctions in real time.
**Does it handle multiple pages?**
Yes — it pages automatically (100 listings per request) until it reaches your Max listings limit.
**Is this legal?**
The Actor collects only publicly visible listing data, the same information any visitor sees. It does not log in, bid, or access private data. You are responsible for complying with Yahoo! Auctions' terms and applicable laws when using the data.
**Something broke?**
Yahoo! Auctions occasionally changes its markup. Open an issue on this Actor's page and it will typically be fixed within 24 hours.
### Related
Need other Japan / East-Asia data? Check my profile — Taiwan job boards and Japan real estate are already live.
# Actor input Schema
## `keyword` (type: `string`):
What to search for on Yahoo! Auctions Japan, e.g. Nintendo Switch, ロレックス, vintage camera. Works in Japanese or English (romanized brand names usually work).
## `maxItems` (type: `integer`):
Maximum number of listings to return. Keep small for a quick test, raise for full exports.
## `sortBy` (type: `string`):
How Yahoo! Auctions should order results.
## `buyNowOnly` (type: `boolean`):
If enabled, only return listings with an immediate buy-now price (定額/即決), skipping pure bidding-only auctions.
## `includeDetails` (type: `boolean`):
If enabled, the scraper visits every listing's detail page to add category breadcrumb, condition, shipping origin, seller info, auction start/end datetime, and up to 10 photo URLs. Slower (one extra request per listing) but much richer data.
## Actor input object example
```json
{
"keyword": "Nintendo Switch",
"maxItems": 50,
"sortBy": "relevance",
"buyNowOnly": false,
"includeDetails": false
}
```
# 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 = {
"keyword": "Nintendo Switch",
"maxItems": 50
};
// Run the Actor and wait for it to finish
const run = await client.actor("youfuxu/yahoo-auctions-japan-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 = {
"keyword": "Nintendo Switch",
"maxItems": 50,
}
# Run the Actor and wait for it to finish
run = client.actor("youfuxu/yahoo-auctions-japan-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 '{
"keyword": "Nintendo Switch",
"maxItems": 50
}' |
apify call youfuxu/yahoo-auctions-japan-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=youfuxu/yahoo-auctions-japan-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Yahoo! Auctions Japan Scraper — Prices, Bids & Listings",
"description": "Scrape live listings from Yahoo! Auctions Japan (Yahoo Auction / ヤフオク) by keyword. Get title, current price, buy-now price, bid count, time remaining, seller and images as clean JSON.",
"version": "1.0",
"x-build-id": "GGS9ijGgOIcKpbwWD"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/youfuxu~yahoo-auctions-japan-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-youfuxu-yahoo-auctions-japan-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/youfuxu~yahoo-auctions-japan-scraper/runs": {
"post": {
"operationId": "runs-sync-youfuxu-yahoo-auctions-japan-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/youfuxu~yahoo-auctions-japan-scraper/run-sync": {
"post": {
"operationId": "run-sync-youfuxu-yahoo-auctions-japan-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": [
"keyword"
],
"properties": {
"keyword": {
"title": "Search keyword",
"type": "string",
"description": "What to search for on Yahoo! Auctions Japan, e.g. Nintendo Switch, ロレックス, vintage camera. Works in Japanese or English (romanized brand names usually work).",
"default": "Nintendo Switch"
},
"maxItems": {
"title": "Max listings",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of listings to return. Keep small for a quick test, raise for full exports.",
"default": 50
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"new",
"end",
"tbids",
"tbidorbuy",
"bids"
],
"type": "string",
"description": "How Yahoo! Auctions should order results.",
"default": "relevance"
},
"buyNowOnly": {
"title": "Buy-it-now (fixed price) listings only",
"type": "boolean",
"description": "If enabled, only return listings with an immediate buy-now price (定額/即決), skipping pure bidding-only auctions.",
"default": false
},
"includeDetails": {
"title": "Include full listing details",
"type": "boolean",
"description": "If enabled, the scraper visits every listing's detail page to add category breadcrumb, condition, shipping origin, seller info, auction start/end datetime, and up to 10 photo URLs. Slower (one extra request per listing) but much richer data.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```