# Mercari 메르카리 Japan Sold Price Checker — Cross-Border (`jpmarketdata/mercari-japan-price-kr`) Actor

일본 직구·구매대행·리셀러 필수: 일본어 키워드 하나로 메르카리 일본(Mercari Japan)에서 판매 완료된 상품의 실제 거래가 시세를 받습니다 — 중앙값, 평균, 가격대, 판매 소요일 중앙값, 달러 환산 포함. 일본 직구 견적과 중고 리셀 가격 책정의 기준이 됩니다. Sold-price stats from Mercari Japan, from $0.02 per keyword, no subscription.

- **URL**: https://apify.com/jpmarketdata/mercari-japan-price-kr.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 Korean Cross-Border Buyers

**한국어 · English · 日本語** — 메르카리 일본(Mercari Japan)에서 판매 완료된 상품의 실제 거래가 시세를, 한 번의 호출로 결론 한 줄까지.

***

### 한국어 안내

#### 누구를 위한 것인가 (Who this is for)

**일본 직구·구매대행·리셀러**를 위한 Actor입니다. 메르카리나 야후 옥션에서 물건을 잡아 국내 중고나라·번개장터·당근이나 eBay로 넘기는 분들이 대상입니다. 가격의 근거는 일본 사이트에 붙어 있는 **호가**가 아닙니다. 비싸게 걸어 두는 사람은 얼마든지 있습니다. **중요한 건 일본 사람이 실제로 얼마에 팔았는가**입니다. 이 Actor는 메르카리의 「판매 완료(SOLD)」 상품 거래가를 곧바로 견적에 쓸 수 있는 통계 한 줄로 바꿔 줍니다. 중앙값, 평균, 가격대, 그리고 「판매까지 걸린 일수 중앙값」으로 이 품목이 잘 나가는지까지 알려 줍니다.

한 줄로: **매입 전에 거래가 시세부터, 견적에는 근거를, 재고에는 회전율을.**

#### 개요 Overview

- 일본어 키워드를 넣으면 메르카리의 공개 상품 데이터를 검색해 다음을 출력합니다.
  - 키워드마다 **거래가 시세 요약**(`price_summary`) 한 건: 최저가, p25, **중앙값**, p75, 최고가, 평균
  - **`medianDaysToSell`**: 판매까지 걸린 일수의 중앙값으로 유동성 지표입니다(작을수록 잘 팔림)
  - 선택 사항인 **개별 상품 명세**: 표본 상품마다 제목, 가격, 상태, 사진, 등록/갱신 시각, 직링크
- 기본값은 **판매 완료(`sold_out`)** 통계이며, 판매 중(현재 호가)이나 둘 다로 바꿀 수 있습니다.
- `priceMinJpy` / `priceMaxJpy`로 모조품, 부속품, 빈 박스 같은 노이즈를 걸러낼 수 있습니다.
- **달러 환산**(실시간 환율)을 지원하므로 eBay·국내 시세와 바로 비교할 수 있습니다.
- 공개 데이터만 읽고, 로그인하지 않으며, 판매자 개인정보는 수집하지 않습니다. 요청은 스로틀링되어 있습니다.

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10", "ちいかわ ぬいぐるみ"]` | **키워드는 일본어로**: 메르카리는 일본 사이트라 일본어 커버리지가 압도적이며 한국어 키워드로는 거의 잡히지 않습니다. 해외 브랜드는 영어(`Leica M6`)도 됩니다. 키워드 1개당 $0.02 |
| `itemStatus` | `"sold_out"` | 판매 완료(거래가, 기본값) / 판매 중(현재 호가) / 둘 다 |
| `maxItemsPerKeyword` | `120` | 키워드당(상태당) 표본 수(30–600, 120 = 1페이지) |
| `priceMinJpy` / `priceMaxJpy` | `3000` / `200000` | 선택 사항인 가격대. 모조품과 이상치를 제외 |
| `includeIndividualItems` | `false` | **기본값 OFF**: 요약만이면 키워드당 $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** | 키워드 1개를 분석할 때마다 |
| 개별 상품 레코드(`item-scraped`) | **$0.002** | 「개별 상품 출력」을 켰을 때만 |

- **이 Actor의 「개별 상품 출력」은 기본값 OFF**입니다(원본 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 Korean 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 **Korean-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 Korean-speaking cross-border buyers (일본 직구 / 구매대행).

#### 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 Korean 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`):

시세를 조회할 키워드입니다. 여러 개를 한 번에 넣을 수 있습니다(키워드 1개당 $0.02). 되도록 일본어 키워드를 쓰세요. 메르카리는 일본 사이트라 일본어 키워드의 커버리지가 가장 높습니다. 예: 「ポケモンカード リザードン 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 = 검색 결과 1페이지. 건수가 많을수록 통계가 안정됩니다. 비용은 「개별 상품 출력」을 켰을 때만 늘어납니다(건당 +$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`):

기본값 OFF: 한 번 실행하면 키워드당 $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-kr").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-kr").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-kr --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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