# Yahoo Auctions Japan Scraper (`crawloop/yahoo-auctions-japan-scraper`) Actor

Scrape Yahoo Auctions Japan open bids and sold prices by keyword. Export JPY price, bid count, end time, seller, and photos as JSON.

- **URL**: https://apify.com/crawloop/yahoo-auctions-japan-scraper.md
- **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yahoo Auctions Japan Scraper

> **Disclaimer:** Unofficial tool — not affiliated with, sponsored by, or endorsed by LY Corporation or Yahoo Japan. Data is read from publicly accessible listing pages only. No login. You are responsible for complying with applicable law and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

Scrape **Yahoo Auctions Japan** open bids and **sold prices** by keyword. Export **JPY price**, **bid count**, **buy-now price**, **end time**, **seller**, and **photos** as JSON. This is a **Yahoo Auctions Japan scraper** and an unofficial **Yahoo Auctions API alternative** for resale comps.

**Best for:** resellers who price Japan auction inventory before listing it elsewhere.

| Yahoo Auctions Japan | Mercari Japan | eBay sold | eBay live |
| :--- | :--- | :--- | :--- |
| Yahoo Auctions Japan Scraper ◄── you are here | [Mercari Japan Scraper](https://apify.com/crawloop/mercari-japan-scraper) | [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper) | [eBay Active Listings Scraper](https://apify.com/crawloop/ebay-active-listings-scraper) |

| Vinted | Depop | Poshmark sold |
| :--- | :--- | :--- |
| [Vinted Monitor](https://apify.com/crawloop/vinted-monitor) | [Depop Monitor](https://apify.com/crawloop/depop-monitor) | [Poshmark Sold Listings Scraper](https://apify.com/crawloop/poshmark-sold-listings-scraper) |

### When to use this Actor

- **Open bids** — current price, bid count, buy-now, and time left for a keyword
- **Sold comps** — closed auctions with the final price in yen
- **Both in one run** — set status to open and sold
- **Python, Node.js, or MCP** — one dataset, no browser

### When not to use this Actor

- **Yahoo Finance, Yahoo News, or Yahoo Mail** — this Actor reads auctions only
- **Buyer messages or account data** — not collected
- **A flea-market-only catalog** — flea rows can appear inside auction search, but this is not a separate flea Actor
- **Runs from an EEA or UK IP with proxy off** — Yahoo Japan does not serve those regions

### Key features

- **Keyword or search URL** — closed-search URLs are read as sold
- **Open, sold, or both** — sold rows are the comp; open rows are the live auction
- **Bids and buy-now** — current price, optional buy-now, bid count, end time
- **Seller on the card** — seller id, and on sold rows the rating and seller type
- **HTTP only** — Japan residential proxy is the default because Yahoo Japan blocks EEA and UK IPs

### Input

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `searchTerms` | Array | — | Keywords. Up to 10 per run |
| `startUrls` | Array | — | Yahoo Auctions Japan search URLs |
| `status` | String | `open` | `open`, `sold`, or `both` |
| `sort` | String | `newest` | `newest`, `ending`, `price_asc`, `price_desc`, or `recommended` |
| `maxItems` | Integer | `40` | Cap per keyword and status (1–300) |
| `proxyConfiguration` | Object | Japan residential | Required outside Japan. Leave the default on |

#### Input example

```json
{
    "searchTerms": ["nintendo switch"],
    "status": "sold",
    "sort": "newest",
    "maxItems": 40,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "JP"
    }
}
```

### Output

Each dataset row is one auction. Prices are integers in JPY. Open `endTime` is UTC. Sold `endTime` is the site timestamp.

| Field | Description |
| :--- | :--- |
| `auctionId` | Auction id |
| `url` | Public auction URL |
| `title` | Listing title |
| `price` / `currency` | Current bid or sold price, and `JPY` |
| `buyNowPrice` | Buy-it-now price when the card has one |
| `bidCount` | Number of bids |
| `endTime` | Auction end time |
| `status` | `open` or `sold` |
| `condition` | Condition code on sold listings |
| `category` | Category name or id |
| `sellerId` / `sellerRating` / `sellerType` | Seller fields present on the card |
| `shippingFee` / `freeShipping` | Shipping when the card shows it |
| `isFleaMarket` | Flea-market flag |
| `imageUrl` | Primary image |
| `source` | Keyword or URL |
| `scrapedAt` | When the row was parsed |

#### Output example

```json
{
    "auctionId": "w1245431595",
    "url": "https://auctions.yahoo.co.jp/jp/auction/w1245431595",
    "title": "Nintendo Switch",
    "price": 16500,
    "buyNowPrice": 28900,
    "currency": "JPY",
    "bidCount": 45,
    "endTime": "2026-09-25T14:21:16Z",
    "status": "open",
    "sellerId": "B2ieD61CS6417r5Ke9u5G993MbZfj",
    "shippingFee": 1230,
    "freeShipping": false,
    "isFleaMarket": false,
    "source": "nintendo switch",
    "scrapedAt": "2026-09-25T09:00:00Z"
}
```

### Use cases

- **Japan auction comps** before buying inventory to resell
- **Live bid watch** — newest open auctions for a keyword
- **Sold price check** — closed auctions for the same keyword
- **Cross-market compare** — take the title into Mercari Japan or eBay sold

### Integration examples

#### Node.js

```javascript
import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("crawloop/yahoo-auctions-japan-scraper").call({
    searchTerms: ["nintendo switch"],
    status: "sold",
    maxItems: 40,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("crawloop/yahoo-auctions-japan-scraper").call(run_input={
    "searchTerms": ["nintendo switch"],
    "status": "sold",
    "maxItems": 40,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/crawloop~yahoo-auctions-japan-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["nintendo switch"],"status":"sold","maxItems":40}'
```

### MCP and AI assistants

Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp). Connect your Apify account, then call this Actor by its Store name `crawloop/yahoo-auctions-japan-scraper`.

Example prompts:

- "Run Yahoo Auctions Japan Scraper for sold Nintendo Switch listings and return price, bid count, and URL as JSON"
- "Scrape open Yahoo Auctions Japan listings for the keyword 'rolex' and list the lowest current bids"
- "Take the Yahoo Auctions Japan sold prices, then run Mercari Japan Scraper for the same keyword and compare the comps"

### Suite next step

After a Yahoo Auctions Japan sold sample, run [Mercari Japan Scraper](https://apify.com/crawloop/mercari-japan-scraper) on the same keyword for fixed-price Japan comps. For completed sales outside Japan, run [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper).

### FAQ

#### Does this Yahoo Auctions Japan scraper include sold prices?

Yes. Set `status` to `sold` or `both`. Sold rows use the closed-auction price in JPY.

#### Do I need a proxy?

Yes, unless the run already starts in Japan. Yahoo Japan does not serve the EEA or the UK. The default is Apify residential proxy in Japan.

#### Is this the official Yahoo Auctions API?

No. It is an unofficial scraper for public auction cards. It does not log in and it does not read private account data.

#### Can I scrape Yahoo Finance with this Actor?

No. Keywords are auction searches only.

### Related Actors

- [Mercari Japan Scraper](https://apify.com/crawloop/mercari-japan-scraper) — Mercari Japan on-sale and sold listings
- [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper) — completed eBay sales
- [eBay Active Listings Scraper](https://apify.com/crawloop/ebay-active-listings-scraper) — live eBay asking prices
- [Vinted Monitor](https://apify.com/crawloop/vinted-monitor) — new Vinted listings

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords on Yahoo Auctions Japan. Each keyword is one search. With status both, open and sold are separate searches.

## `startUrls` (type: `array`):

Yahoo Auctions Japan search URLs. A closed-search URL is treated as sold. Other filters on the URL are kept.

## `status` (type: `string`):

Open auctions, sold (closed) auctions, or both. Both runs two searches and applies max items to each.

## `sort` (type: `string`):

Sort for keyword searches of open auctions. Search URLs keep their own sort. Sold results use the site default.

## `maxItems` (type: `integer`):

Cap per keyword and status. A both-status keyword can return up to twice this number.

## `proxyConfiguration` (type: `object`):

Yahoo Japan blocks EEA and UK IPs. Keep Japan residential proxy on.

## Actor input object example

```json
{
  "searchTerms": [
    "nintendo switch"
  ],
  "status": "open",
  "sort": "newest",
  "maxItems": 40,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "JP"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Default dataset listings.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "nintendo switch"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawloop/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchTerms": ["nintendo switch"] }

# Run the Actor and wait for it to finish
run = client.actor("crawloop/yahoo-auctions-japan-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "nintendo switch"
  ]
}' |
apify call crawloop/yahoo-auctions-japan-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawloop/yahoo-auctions-japan-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ccJalry0zkReekWfi/builds/gHEefjegpM21IOp9B/openapi.json