# Yahoo! Auctions 雅虎拍卖 Japan Sold Comps — Cross-Border (`jpmarketdata/yahoo-auction-comps-cn`) Actor

日本代购与跨境卖家必备：输入日文关键词，一次调用即可拿到雅虎拍卖（雅虎日拍 / Yahoo! Auctions Japan）已结束拍卖的真实成交价行情——中位数、平均值、四分位价格区间与出价竞争度，并附美元换算。适合日淘捡漏、代购报价与转卖定价。Sold-price stats from closed Japanese auctions, from $0.02 per keyword, no subscription.

- **URL**: https://apify.com/jpmarketdata/yahoo-auction-comps-cn.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 keyword sold-price analyses

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Japan Auction Sold Comps for Cross-Border Buyers

**中文 · English · 日本語** — 雅虎拍卖（雅虎日拍 / Yahoo! Auctions Japan）已结束拍卖的成交价行情，一次调用一条结论。

***

### 中文说明

#### 这是给谁用的（Who this is for）

给**日本代购、日淘买手、跨境转卖卖家**用的。你在日本市场（雅虎拍卖、煤炉等）拿货，再卖到中国大陆、香港、台湾、新加坡的闲鱼 / 淘宝 / 微店 / 蝦皮 / eBay。定价和报价的关键从来不是日站上挂着的要价，而是**日本人实际拍到多少钱**——也就是成交价行情。这个 Actor 就是把雅虎拍卖「已结束拍卖」的成交价，直接算成一条可以拿去报价的统计结论：中位数、平均值、四分位价格区间，外加出价竞争度（有多少人在抢）。不用你翻十几页日文页面，也不用自己做表。

一句话：**收货前先查行情，报价时有底气，转卖时不亏。**

#### 概览 Overview

- 输入若干**日文关键词**，Actor 会抓取雅虎拍卖公开的「已结束拍卖」搜索页（closedsearch），按关键词取样，输出：
  - 每个关键词一条 **成交价行情汇总**（`price_summary`）：最低价、25 分位、**中位数**、75 分位、最高价、平均值；
  - **出价次数统计**（`bidCountStats`）：判断这件东西抢手不抢手；
  - 可选的**单件明细**：每一件取样拍卖的标题、成交价、出价次数、成色、结束时间、图片和直达链接。
- 统计**只用真正成交的拍卖**（出价 ≥ 1 次）计算，流拍不计入。
- 支持**美元换算**（实时汇率），方便和 eBay / 闲鱼 / 蝦皮行情直接对比。
- 只读公开页面，不登录、不碰卖家个人信息，请求已节流。

#### 输入 Input

| 字段 | 示例 | 说明 |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10", "ロレックス デイトナ"]` | **关键词请用日文**：雅虎拍卖是日本站点，日文词覆盖率最高。中文词几乎搜不到东西。国际品牌用英文（`Leica M6`）也可以。每个关键词计费 $0.02 |
| `maxItemsPerKeyword` | `100` | 每个关键词取样多少件已结束拍卖（30–500，50 = 一页） |
| `soldOnly` | `true` | 单件明细只输出真正成交的拍卖（默认开启） |
| `includeIndividualItems` | `true` | **默认开启**：同时输出单件明细，+$0.002/件。只要一条行情汇总就关掉它 |
| `convertToUsd` | `true` | 附上美元价格 |

```json
{
    "keywords": ["ポケモンカード リザードン psa10", "ロレックス デイトナ"],
    "maxItemsPerKeyword": 100,
    "includeIndividualItems": true,
    "convertToUsd": true
}
```

常用日文关键词对照：宝可梦卡 = `ポケモンカード`／喷火龙 = `リザードン`／高达模型 = `ガンダム プラモデル`／劳力士 迪通拿 = `ロレックス デイトナ`／吉伊卡哇 = `ちいかわ`／古董相机 = `フィルムカメラ`。

#### 输出 Output

每个关键词一条 `price_summary`：

```json
{
    "type": "price_summary",
    "keyword": "ポケモンカード リザードン psa10",
    "status": "closed_auctions",
    "totalListingsFound": 4879,
    "sampledListings": 100,
    "soldListings": 84,
    "priceJpy": { "min": 1200, "p25": 9250, "median": 24800, "p75": 46500, "max": 158000, "average": 31420 },
    "priceUsd": { "min": 7.4, "p25": 57.4, "median": 153.8, "p75": 288.4, "max": 980.1, "average": 194.9 },
    "bidCountStats": { "min": 1, "p25": 1, "median": 3, "p75": 12, "max": 47, "average": 8 },
    "checkedAt": "2026-07-03T12:00:00+00:00"
}
```

怎么读：`priceJpy.median` 是**日本市场的真实成交中位价**，报价时以它为锚；`p25`–`p75` 是正常价格区间，低于 `p25` 的货源才有捡漏空间；`bidCountStats.median` 越高说明竞争越激烈，代拍时要预留加价空间。开启单件明细后，另有每件拍卖的 `type: "item"` 记录（标题、成交价日元/美元、出价次数、成色、结束时间、图片、`auctions.yahoo.co.jp` 直达链接）。

#### 价格 Pricing

按次计费，无订阅、无月租：

| 计费事件 | 价格 | 何时计费 |
|---|---|---|
| 关键词行情汇总（`keyword-analyzed`） | **$0.02** | 每分析一个关键词 |
| 单件拍卖记录（`item-scraped`） | **$0.002** | 仅在开启「输出单件明细」时 |

- **本 Actor 的「输出单件明细」默认开启**（与源 Actor 的默认值一致），所以默认运行的费用是 **$0.02 + $0.002 × 实际输出的成交件数**。例如取样 100 件、其中 84 件成交 = $0.02 + $0.168 ≈ $0.19。
- 只要行情汇总的话，把 `includeIndividualItems` 关掉，每个关键词就是固定 **$0.02**。
- **0 结果的关键词不计费。**
- Apify 免费额度每月 **$5**，足够跑很多次行情查询。

#### 注意事项 Notes

- 关键词请用**日文**。这是日本站点，中文关键词基本无结果。
- 只读取**公开的已结束拍卖**信息，不登录；**输出中不含卖家身份信息**。
- 请求已节流（每页 1.5 秒），对雅虎拍卖的负载可忽略。
- 与 LY Corporation（雅虎日本）无隶属关系。数据仅供市场研究，大额交易前请自行复核。
- 页面结构若变化，运行会**明确报错**而不是返回空结果——不会给你一份看起来正常的空数据。
- 想同时查煤炉（Mercari）行情，请用姊妹 Actor **Mercari Japan Sold Price Checker for Cross-Border Buyers**。

***

### English

#### Overview

Sold-price statistics from **closed (ended) auctions** on Japan's biggest auction marketplace. One call per keyword returns a ready-to-use comps summary — median, average, quartiles, price range — plus bid-competition statistics, and optionally every sampled auction.

This listing is the **Chinese-language package** of our English Actor [Yahoo! Auctions Japan Sold Comps](https://apify.com/jpmarketdata/yahoo-auction-sold-comps). The scraping and statistics are the same; the documentation, store copy and input labels are written for Chinese-speaking cross-border buyers (代购 / daigou).

#### Input

| Field | Example | Notes |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10"]` | Japanese keywords give the best coverage; English brand names also work. $0.02 per keyword |
| `maxItemsPerKeyword` | `100` | Closed auctions sampled per keyword (30–500) |
| `soldOnly` | `true` | Individual records: only auctions that actually sold |
| `includeIndividualItems` | `true` | On by default — also pushes every sampled auction (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD prices at the current rate |

#### Output

One `price_summary` record per keyword (`priceJpy` / `priceUsd` / `bidCountStats`, `totalListingsFound`, `sampledListings`, `soldListings`, `checkedAt`) — see the JSON example in the Chinese section — plus, optionally, one `item` record per sampled auction with title, final price, bids, condition, end time, photo and a direct `auctions.yahoo.co.jp` URL. Statistics are always computed from auctions that actually sold (≥1 bid).

#### Pricing

| Event | Price |
|---|---|
| Keyword sold-price summary (`keyword-analyzed`) | **$0.02** |
| Individual auction record (`item-scraped`) | **$0.002** each |

**Individual records are ON by default here** (matching the source Actor's default), so a default run costs $0.02 + $0.002 per sold auction returned — e.g. 84 sold auctions ≈ $0.19. Turn `includeIndividualItems` off for a flat $0.02 per keyword. Keywords with zero results are never charged. No subscription.

#### Notes

- Reads only publicly visible closed-auction data — no login; **seller identities are excluded** from the output.
- Requests are throttled (1.5 s per page). Works with the [Apify MCP server](https://mcp.apify.com) for AI agents.
- Not affiliated with LY Corporation. Data is for market research; verify before large transactions.
- If the page structure changes, the run **fails loudly** instead of returning a plausible-looking empty result.

***

### 日本語

#### 概要 Overview

ヤフオク!の**終了済みオークション**から、キーワードごとの落札価格統計（中央値・平均・四分位・価格帯）と入札競争度を1コールで返します。中国語圏の**代購・輸出転売業者**向けに、中国語で書き直したパッケージです（英語版は [Yahoo! Auctions Japan Sold Comps](https://apify.com/jpmarketdata/yahoo-auction-sold-comps)、取得・統計処理は同一）。

#### 入力 Input

`keywords`（日本語キーワード推奨）／`maxItemsPerKeyword`（既定 100、30〜500）／`soldOnly`（既定 ON）／`includeIndividualItems`（**既定 ON**）／`convertToUsd`（既定 ON）。

#### 出力 Output

キーワードごとに `price_summary` を1件（`priceJpy` の最小・p25・中央値・p75・最大・平均、`bidCountStats`、`totalListingsFound`、`soldListings`、USD換算）。`includeIndividualItems` が ON のときは、落札された各オークションの明細（タイトル・落札価格・入札数・状態・終了時刻・画像・URL）も出力します。統計は**落札されたもの（入札1件以上）のみ**から計算します。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別レコード（`item-scraped`）**$0.002 / 件**。本 Actor は個別明細が**既定 ON**（ソース Actor の既定値と同じ）のため、既定実行は $0.02 + $0.002 × 落札件数です。`includeIndividualItems` を OFF にすればキーワードあたり $0.02 固定。**0件のキーワードは課金されません。** サブスクリプション不要。

#### 注意 Notes

公開されている終了済みオークション情報のみを読み取り、ログインは行いません。**出品者情報は出力しません。** リクエストは1.5秒間隔に制限しています。LINEヤフー株式会社とは無関係です。データは市場調査用であり、高額取引の前にご自身で確認してください。ページ構造が変わった場合は空データを返さず**明示的にエラー**にします。

# Actor input Schema

## `keywords` (type: `array`):

要查询行情的关键词，可一次填多个（每个关键词计费 $0.02）。请尽量使用日文关键词：雅虎拍卖是日本站点，日文词覆盖率最高，例如「ポケモンカード リザードン psa10」（宝可梦卡 喷火龙 PSA10）、「ロレックス デイトナ」（劳力士 迪通拿）、「ガンダム プラモデル」（高达 模型）。国际品牌用英文也可以（如 'Leica M6'）。One or more search queries; Japanese keywords give the best coverage, English brand names also work.

## `maxItemsPerKeyword` (type: `integer`):

每个关键词抽取多少件已结束拍卖来计算行情。50 = 一页搜索结果；件数越多统计越稳，但若开启「输出单件明细」费用也越高。How many closed auctions to sample per keyword.

## `soldOnly` (type: `boolean`):

默认开启：只有真正成交（出价 ≥1 次）的拍卖才会作为单件记录输出。无论此项如何设置，统计始终只用成交拍卖计算。If enabled (default), only auctions that actually sold are pushed as individual records.

## `includeIndividualItems` (type: `boolean`):

默认开启：除行情汇总外，还输出每一件取样拍卖（标题、成交价、出价次数、成色、结束时间、图片、链接），便于代购逐件核价，费用 +$0.002/件。只想要一条行情汇总（每关键词固定 $0.02）时请关闭。If enabled, every sampled auction is also pushed to the dataset.

## `convertToUsd` (type: `boolean`):

在日元价格旁附上美元价格，使用实时汇率（open.er-api.com），方便和 eBay、闲鱼等海外行情对比。Adds USD prices next to JPY using the current exchange rate.

## Actor input object example

```json
{
  "keywords": [
    "ポケモンカード リザードン psa10"
  ],
  "maxItemsPerKeyword": 100,
  "soldOnly": true,
  "includeIndividualItems": true,
  "convertToUsd": true
}
```

# 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 = {
    "keywords": [
        "ポケモンカード リザードン psa10"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/yahoo-auction-comps-cn").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 = { "keywords": ["ポケモンカード リザードン psa10"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/yahoo-auction-comps-cn").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 '{
  "keywords": [
    "ポケモンカード リザードン psa10"
  ]
}' |
apify call jpmarketdata/yahoo-auction-comps-cn --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/yahoo-auction-comps-cn",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/KYBQ9Tbvnhstz1sX7/builds/nkfgl0LSdvYykEriP/openapi.json