# Mercari 煤炉 Japan Sold Price Checker — Cross-Border (`jpmarketdata/mercari-japan-price-cn`) Actor

日本代购与跨境卖家必备：输入日文关键词，一次调用即可拿到煤炉（美卡多 / Mercari 日本）已售商品的真实成交价行情——中位数、平均值、价格区间与售出天数中位数，并附美元换算。适合日淘捡漏、代购报价与二手转卖定价。Sold-price stats from Mercari Japan, from $0.02 per keyword, no subscription.

- **URL**: https://apify.com/jpmarketdata/mercari-japan-price-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 market 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

## Mercari Japan Sold Price Checker for Cross-Border Buyers

**中文 · English · 日本語** — 煤炉（美卡多 / Mercari 日本）已售商品的成交价行情，一次调用一条结论。

***

### 中文说明

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

给**日本代购、日淘买手、跨境转卖卖家**用的。你在日本二手市场（煤炉、雅虎拍卖等）收货，再卖到中国大陆、香港、台湾、新加坡的闲鱼 / 淘宝 / 微店 / 蝦皮 / eBay。定价的依据从来不是日站上挂着的要价——挂高价的人多的是，**关键是日本人实际卖出了多少钱**。这个 Actor 把煤炉「已售出（SOLD）」商品的成交价直接算成一条可以拿去报价的统计结论：中位数、平均值、价格区间，还有「卖出天数中位数」告诉你这个品类走不走货。

一句话：**收货前先查成交价行情，报价有底、压价有据、囤货不压手。**

#### 概览 Overview

- 输入若干**日文关键词**，Actor 搜索煤炉公开的商品数据，输出：
  - 每个关键词一条 **成交价行情汇总**（`price_summary`）：最低价、25 分位、**中位数**、75 分位、最高价、平均值；
  - **`medianDaysToSell`**：卖出天数的中位数，衡量流动性（数字小 = 好出手）；
  - 可选的**单件明细**：每一件取样商品的标题、价格、成色、图片、上架/更新时间和直达链接。
- 默认统计 **已售出（`sold_out`）** 商品，也可以切换成在售（当前要价）或两者都取。
- 可用 `priceMinJpy` / `priceMaxJpy` 过滤掉仿品、配件、空盒等干扰项。
- 支持**美元换算**（实时汇率），方便和 eBay / 闲鱼 / 蝦皮行情直接对比。
- 只读公开数据，不登录、不采集卖家个人信息，请求已节流。

#### 输入 Input

| 字段 | 示例 | 说明 |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10", "ちいかわ ぬいぐるみ"]` | **关键词请用日文**：煤炉是日本站点，日文词覆盖率最高，中文词几乎搜不到。国际品牌用英文（`Leica M6`）也可以。每个关键词计费 $0.02 |
| `itemStatus` | `"sold_out"` | 已售出（成交价，默认）／在售（当前要价）／两者都要 |
| `maxItemsPerKeyword` | `120` | 每个关键词（每种状态）取样多少件（30–600，120 = 一页） |
| `priceMinJpy` / `priceMaxJpy` | `3000` / `200000` | 可选价格区间，剔除仿品与异常价 |
| `includeIndividualItems` | `false` | **默认关闭**：只要行情汇总，每个关键词固定 $0.02。开启后 +$0.002/件 |
| `convertToUsd` | `true` | 附上美元价格 |

```json
{
    "keywords": ["ポケモンカード リザードン psa10", "ちいかわ ぬいぐるみ"],
    "itemStatus": "sold_out",
    "maxItemsPerKeyword": 120,
    "convertToUsd": true
}
```

常用日文关键词对照：宝可梦卡 = `ポケモンカード`／喷火龙 = `リザードン`／吉伊卡哇 玩偶 = `ちいかわ ぬいぐるみ`／劳力士 迪通拿 = `ロレックス デイトナ`／优衣库 羽绒服 = `ユニクロ ダウン`／手办 = `フィギュア`。

#### 输出 Output

每个关键词一条 `price_summary`：

```json
{
    "type": "price_summary",
    "keyword": "ポケモンカード リザードン psa10",
    "status": "sold_out",
    "totalListingsFound": 7767,
    "sampledListings": 120,
    "priceJpy": { "min": 2030, "p25": 12800, "median": 22750, "p75": 39800, "max": 450000, "average": 31420 },
    "priceUsd": { "min": 13.4, "p25": 84.5, "median": 150.2, "p75": 262.7, "max": 2971.0, "average": 207.4 },
    "medianDaysToSell": 3,
    "checkedAt": "2026-07-02T12:00:00+00:00"
}
```

怎么读：`priceJpy.median` 是**日本市场的真实成交中位价**，收货报价以它为锚；`p25`–`p75` 是正常价格区间，低于 `p25` 才叫捡漏；`medianDaysToSell` 越小说明这个品类越好出手（囤货风险低）。开启单件明细后，另有每件商品的 `type: "item"` 记录（标题、日元/美元价格、成色、图片、时间、`jp.mercari.com` 直达链接）。

#### 价格 Pricing

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

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

- **本 Actor 的「输出单件明细」默认关闭**（与源 Actor 的默认值一致），所以**默认运行每个关键词就是固定 $0.02**，10 个关键词 = $0.20。
- 需要逐件核价时开启 `includeIndividualItems`，例如取样 120 件 = +$0.24。
- **0 结果的关键词不计费。**
- Apify 免费额度每月 **$5**，约等于 **250 次**行情查询，日常查价基本免费。

#### 注意事项 Notes

- 关键词请用**日文**。这是日本站点，中文关键词基本无结果。
- 只读取**公开的商品信息**，不登录，不采集超出普通访客可见范围的个人信息。
- 请求已节流（1.5 秒/页），对煤炉的负载可忽略。
- 与 Mercari, Inc.（株式会社メルカリ）无隶属关系。数据仅供市场研究，大额交易前请自行复核。
- `medianDaysToSell` 用「更新时间 − 上架时间」估算，改价和编辑也会更新时间，因此偏保守——作为流动性信号够用，但不是精确成交时间。
- 全部搜索都失败时，运行会**明确报错**而不是返回一份空数据。
- 想同时查雅虎拍卖（雅虎日拍）行情，请用姊妹 Actor **Japan Auction Sold Comps for Cross-Border Buyers**。

***

### English

#### Overview

Sold-price statistics from **completed (sold) listings** on Japan's largest consumer marketplace. One call per keyword returns a ready-to-use comps summary — median, average, quartiles, price range — plus `medianDaysToSell` as a liquidity signal, and optionally every sampled listing.

This listing is the **Chinese-language package** of our English Actor [Mercari Japan Price Checker](https://apify.com/jpmarketdata/mercari-japan-price-checker). 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 results; English brand names also work. $0.02 per keyword |
| `itemStatus` | `"sold_out"` | Sold comps (default), current asking prices, or both |
| `maxItemsPerKeyword` | `120` | Listings sampled per keyword per status (30–600) |
| `priceMinJpy` / `priceMaxJpy` | `3000` / `200000` | Optional price bounds to exclude junk/fake listings |
| `includeIndividualItems` | `false` | Off by default — enable to also get every sampled listing (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD prices at the current rate |

#### Output

One `price_summary` record per keyword (`priceJpy` / `priceUsd`, `medianDaysToSell`, `totalListingsFound`, `sampledListings`, `checkedAt`) — see the JSON example in the Chinese section — plus, optionally, one `item` record per sampled listing with title, JPY/USD price, condition, photo, timestamps and a direct `jp.mercari.com` URL.

#### Pricing

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

**Individual records are OFF by default here** (matching the source Actor's default), so a default run costs a flat **$0.02 per keyword** — 10 keywords = $0.20. Enable `includeIndividualItems` for the raw comps (120 listings ≈ +$0.24). Keywords with zero results are never charged. Apify's free plan includes $5 of monthly credit, about 250 price checks. No subscription.

#### Notes

- Reads only publicly visible listing data — no login, no personal data beyond what any visitor sees.
- Requests are throttled (1.5 s). Works with the [Apify MCP server](https://mcp.apify.com) for AI agents.
- Not affiliated with Mercari, Inc. Data is for market research; verify before large transactions.
- `medianDaysToSell` uses `updated − created`, which also moves on edits and price drops, so it skews low-side — a liquidity signal, not an exact sale timestamp.
- If every search fails, the run **fails loudly** instead of returning an empty SUCCEEDED run.

***

### 日本語

#### 概要 Overview

メルカリの**売り切れ（SOLD）商品**から、キーワードごとの実売価格統計（中央値・平均・四分位・価格帯）と「売れるまでの日数」の中央値を1コールで返します。中国語圏の**代購・輸出転売業者**向けに、中国語で書き直したパッケージです（英語版は [Mercari Japan Price Checker](https://apify.com/jpmarketdata/mercari-japan-price-checker)、取得・統計処理は同一）。

#### 入力 Input

`keywords`（日本語キーワード推奨）／`itemStatus`（既定 `sold_out`）／`maxItemsPerKeyword`（既定 120、30〜600）／`priceMinJpy`・`priceMaxJpy`（任意）／`includeIndividualItems`（**既定 OFF**）／`convertToUsd`（既定 ON）。

#### 出力 Output

キーワードごとに `price_summary` を1件（`priceJpy` の最小・p25・中央値・p75・最大・平均、`medianDaysToSell`、`totalListingsFound`、`sampledListings`、USD換算）。`includeIndividualItems` が ON のときは、各商品の明細（タイトル・価格・状態・画像・日時・URL）も出力します。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別レコード（`item-scraped`）**$0.002 / 件**。個別明細は**既定 OFF**（ソース Actor の既定値と同じ）なので、既定実行はキーワードあたり **$0.02 固定**です。**0件のキーワードは課金されません。** Apify の無料枠は毎月 $5 分（約250回の相場チェック）。サブスクリプション不要。

#### 注意 Notes

公開されている商品情報のみを読み取り、ログインは行いません。リクエストは1.5秒間隔に制限しています。株式会社メルカリとは無関係です。データは市場調査用であり、高額取引の前にご自身で確認してください。`medianDaysToSell` は `updated − created` による推定で、価格変更や編集でも更新されるため低めに出ます（流動性の目安であり、正確な販売日時ではありません）。全検索が失敗した場合は空データを返さず**明示的にエラー**にします。

# Actor input Schema

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

要查询行情的关键词，可一次填多个（每个关键词计费 $0.02）。请尽量使用日文关键词：煤炉（Mercari）是日本站点，日文词覆盖率最高，例如「ポケモンカード リザードン psa10」（宝可梦卡 喷火龙 PSA10）、「ロレックス デイトナ」（劳力士 迪通拿）、「ちいかわ ぬいぐるみ」（吉伊卡哇 玩偶）。国际品牌用英文也可以（如 'Leica M6'）。One or more search queries; Japanese keywords give the best results, English brand names also work.

## `itemStatus` (type: `string`):

要分析哪一类商品：'sold\_out' = 已售出（真实成交价，做行情和报价请用这个，默认）；'on\_sale' = 在售（当前要价，只反映卖家期望）；'both' = 两者都取并分别输出。'sold\_out' analyzes completed sales, 'on\_sale' current asking prices, 'both' reports the two sets separately.

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

每个关键词（每种状态）抽取多少件商品来计算行情。120 = 一页搜索结果；件数越多统计越稳。只有在开启「输出单件明细」时才影响费用（+$0.002/件）。How many listings to sample per keyword per status.

## `priceMinJpy` (type: `integer`):

可选：日元价格下限。代购常用来剔除仿品、配件、空盒等低价干扰项，让行情更干净。Optional lower price bound in Japanese yen.

## `priceMaxJpy` (type: `integer`):

可选：日元价格上限，用来剔除整套、批发等异常高价。Optional upper price bound in Japanese yen.

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

默认关闭：一次运行每个关键词固定 $0.02，只返回行情汇总。开启后还会输出每一件取样商品（标题、价格、链接、图片、成色、时间），便于逐件核价，费用 +$0.002/件。Off by default: a run costs a flat $0.02 per keyword.

## `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"
  ],
  "itemStatus": "sold_out",
  "maxItemsPerKeyword": 120,
  "includeIndividualItems": false,
  "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/mercari-japan-price-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/mercari-japan-price-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/mercari-japan-price-cn --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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