# 메르카리 Mercari 일본 중고 거래가 — 중앙값·가격대·판매 소요일 (`jpmarketdata/mercari-japan-price-kr`) Actor

일본어 키워드 하나 또는 전체 목록을 입력하면 메르카리(Mercari 일본)에서 그 상품이 실제로 팔린 가격을 알려 줍니다. 거래가 중앙값, 최저–최고 가격대, 평균, 판매 소요일 중앙값, 찾은 판매완료 건수를 엔화와 달러로 돌려줍니다(앞쪽 120건 표본). 키워드당 $0.02, 결과 없으면 무료. Sold prices from Mercari Japan. Unofficial.

- **URL**: https://apify.com/jpmarketdata/mercari-japan-price-kr.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **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/actors/running/actors-in-store.md#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 일본 중고 거래가 — 중앙값·가격대·판매 소요일

**하는 일:** 메르카리(Mercari 일본)에서 키워드의 판매완료 상품을 찾아 거래가 요약 한 줄을 돌려줍니다.

**입력:** 키워드 하나 또는 전체 목록, 예: `ポケモンカード リザードン psa10` (일본어 권장, `Leica M6` 같은 브랜드명도 가능)

**결과:** 거래가 중앙값, 중간 50% 가격대, 최저–최고, 평균, 판매 소요일 중앙값(대략치), 찾은 판매완료 건수 — 엔화와 달러. 앞쪽 120건을 표본으로 계산합니다. 선택: 표본이 된 상품 각각 한 줄씩.

**가격:** 키워드·상태당 $0.02(기본은 판매 완료만, 「둘 다」= 요약 2건 = $0.04, 키워드 50개 = $1.00). 개별 상품 목록도 원하면 1건당 $0.002 추가. 결과 없으면 무료.

**예시:** `ポケモンカード リザードン psa10` 입력 → 중앙값 ¥29,100 · 범위 ¥1,600–470,900 · 약 5일 만에 판매 · 찾은 7,247건 중 120건을 표본으로 측정(2026-08-17 실측). 일괄 실측: 카메라 키워드 50개 → 요약 50건, 약 110초, $1.00 (2026-08-21 실측)

**In English:** Type a Japanese keyword and get what that item actually sold for on Mercari Japan. You get the median sold price, lowest–highest range, average, median days to sell and how many sold listings were found, in yen and US dollars, from the first 120 listings.

> 비공식 도구 / Unofficial — 메르카리와 무관, 공개 페이지만 읽음 / not affiliated with Mercari. Reads public pages only.

### 한국어 안내

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

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

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

#### 개요 Overview

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

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10", "ちいかわ ぬいぐるみ"]` | **키워드는 일본어로**: 메르카리는 일본 사이트라 일본어 커버리지가 압도적입니다. 한국어 키워드는 **결과가 아예 없는 것이 아니라, 관련 없는 상품이 섞여 나오고 그대로 과금됩니다**: 2026-08-18 실측 `카메라` → 13건(카메라 본체와 한국어 책이 섞임)으로 요약이 나오고 $0.02가 청구됩니다. 해외 브랜드는 영어(`Leica M6`)도 됩니다. 키워드 1개당 $0.02 |
| `itemStatus` | `"sold_out"` | 판매 완료(거래가, 기본값) / 판매 중(현재 호가) / 둘 다. 「둘 다」를 고르면 상태별로 요약 한 건씩, 각각 $0.02가 과금됩니다 |
| `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` 한 건:

2026-08-17 실측(실제 실행, 기본 입력)

```json
{
    "type": "price_summary",
    "keyword": "ポケモンカード リザードン psa10",
    "status": "sold_out",
    "keywordStatus": "ok",
    "totalListingsFound": 7247,
    "sampledListings": 120,
    "priceJpy": {
        "min": 1600,
        "p25": 15725,
        "median": 29100,
        "p75": 70700,
        "max": 470900,
        "average": 48955
    },
    "compSpread": 4.5,
    "mixedKeywordLikely": true,
    "medianDaysToSell": 5,
    "checkedAt": "2026-08-17T17:38:37.488155+00:00",
    "priceUsd": {
        "min": 10.05,
        "p25": 98.77,
        "median": 182.78,
        "p75": 444.07,
        "max": 2957.72,
        "average": 307.49
    },
    "exchangeRateJpyUsd": 0.006281
}
```

읽는 법: `priceJpy.median`이 **일본 시장의 실제 거래 중앙값**이고, 매입 견적은 여기에 앵커를 두면 됩니다. `p25`–`p75`(중간 50% 구간)가 정상 가격대이며 `p25` 아래로 잡아야 마진이 남습니다. `medianDaysToSell`이 작을수록 회전이 빠른 품목이라 재고 리스크가 낮습니다. 개별 명세를 켜면 상품 한 건당 `type: "item"` 레코드(제목, 엔/달러 가격, 상태, 사진, 시각, `jp.mercari.com` 직링크)가 추가로 나옵니다.

`totalListingsFound`는 메르카리가 알려주는 검색 건수이고 **15000에서 멈춥니다**: 15000은 "15000건 이상"이라는 뜻이지 정확히 15000건이 아닙니다(2026-08-18 실측: `camera`·`カメラ`·`Nikon`·`guitar`·`ギター` 모두 15000). 통계는 언제나 실제로 표본으로 뽑은 건수로만 계산하므로, 건수가 상한에 걸려도 가격 숫자는 달라지지 않습니다.

`compSpread`는 중간 50% 구간의 배수(`p75 ÷ p25`)이고, `mixedKeywordLikely`는 4배를 넘으면 `true`가 됩니다. 하나의 상품이면 보통 1.5–3배이며, 배수가 크다는 것은 그 키워드가 여러 종류를 한꺼번에 잡았다는 뜻이라 중앙값 하나로는 설명이 되지 않습니다. 2026-08-18 실측: 판매완료 `Nikon Z6`는 13.9배였는데, 마운트 어댑터·가이드북·케이스가 카메라 바디와 같은 키워드를 쓰기 때문입니다. `true`가 보이면 가격 범위(예: `priceMinJpy: 50000`)를 넣거나 더 정확한 키워드로 다시 실행하세요.

#### 키워드에 결과가 없을 때

`keywordStatus`가 어떤 종류의 "없음"인지 알려주며, **결과가 없으면 과금되지 않습니다**:

| `keywordStatus` | 뜻 | 다음에 할 일 |
|---|---|---|
| `ok` | 가격이 있는 상품을 표본으로 뽑았습니다 | — |
| `not_found` | 그 표기로는 메르카리에 상품이 없습니다 | 일본어 이름(`camera` → `カメラ`)이나 다른 모델명 표기(`α7 IV` / `ILCE-7M4`)로 바꿔 보세요 |
| `unknown` | 상품은 있지만 표본에 가격이 있는 것이 없었습니다 | 키워드를 좁히거나 다른 `itemStatus`로 실행하세요 |

상태가 `ok`가 아닐 때는 `hint` 필드가 다음 한 걸음을 한 문장(영어)으로 알려줍니다.

#### 가격 Pricing

건당 과금입니다.

| 과금 이벤트 | 가격 | 시점 |
|---|---|---|
| 키워드 시세 요약(`keyword-analyzed`) | **$0.02** | 키워드 1개의 상태 하나를 분석할 때마다(「둘 다」= 2건, $0.04) |
| 개별 상품 레코드(`item-scraped`) | **$0.002** | 「개별 상품 출력」을 켰을 때만 |

- **이 Actor의 「개별 상품 출력」은 기본값 OFF**입니다(원본 Actor의 기본값과 동일). 따라서 **기본 실행은 키워드당 $0.02 고정**이며, 키워드 10개면 $0.20입니다.
- 건별로 검증해야 할 때만 `includeIndividualItems`를 켜세요. 예를 들어 120건 표본이면 +$0.24입니다.
- **결과가 0건인 키워드는 과금되지 않습니다.**

#### 주의사항 Notes

- 키워드는 **일본어**로 넣으세요. 한국어 키워드는 결과가 없는 것이 아니라 **관련 없는 상품이 섞인 요약이 나오고 그대로 과금됩니다**(2026-08-18 실측 `카메라` → 13건, 카메라와 한국어 책이 섞임, $0.02 청구).
- **공개된 상품 정보만** 읽으며, 로그인하지 않고 일반 방문자가 볼 수 있는 범위를 넘는 개인정보는 수집하지 않습니다.
- 요청은 스로틀링(1.5초/페이지)되어 있어 메르카리에 주는 부하는 무시할 수준입니다.
- Mercari, Inc.(주식회사 메루카리)와 아무 관계가 없습니다. 데이터는 시장 조사용이며 고액 거래 전에는 직접 확인하세요.
- `medianDaysToSell`은 「갱신 시각 − 등록 시각」으로 추정합니다. 가격 수정이나 편집으로도 갱신 시각이 움직이므로 값이 짧게 나오는 경향이 있습니다. 유동성 신호로는 충분하지만 정확한 판매 시각은 아닙니다.
- 모든 검색이 실패하면 빈 데이터를 돌려주는 대신 **명시적으로 실패**합니다.
- 야후 옥션 시세도 함께 보려면 자매 Actor **야후옥션 Yahoo! Auctions 일본 낙찰가 — 중앙값·가격대·입찰수**를 쓰세요.

***

### English

#### Overview

Sold-price statistics from **completed (sold) listings** on Japan's largest consumer marketplace. Each keyword returns a ready-to-use summary of what items really sold for — median, average, the middle 50% range and the lowest–highest range — plus `medianDaysToSell` as a rough liquidity signal, and optionally every sampled listing.

This listing is the **Korean-language package** of our English Actor [Mercari Japan Sold Prices — What Items Really Sell For](https://apify.com/jpmarketdata/mercari-japan-price-checker). It reads the same pages and works out the same numbers; 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 prices (default), current asking prices, or both. "Both" returns two summaries and is charged twice |
| `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` — Mercari's hit count, capped at 15000 — `sampledListings`, `compSpread` and `mixedKeywordLikely` for how many kinds of thing the keyword caught, `keywordStatus` plus a `hint` when a keyword comes back empty, `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. With `itemStatus: "both"` a keyword is analyzed twice and charged twice. Enable `includeIndividualItems` to also get every sampled listing (120 listings = +$0.24). Keywords with zero results are never charged. You pay per keyword; there is no monthly fee.

#### Notes

- Reads only publicly visible listing data — no login, no personal data beyond what any visitor sees.
- Requests are throttled (1.5 s between pages).
- 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）商品**から、キーワードごとの実売価格統計（中央値・平均・中間50%の範囲・価格帯）と「売れるまでの日数」の中央値を1レコードで返します。韓国語圏の**日本直購・購買代行・転売業者**向けに、韓国語で書き直したパッケージです（英語版は [Mercari Japan Sold Prices — What Items Really Sell For](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`（メルカリの件数。上限 15000）、`sampledListings`、`compSpread`・`mixedKeywordLikely`（キーワードが何種類の物を拾ったか）、`keywordStatus`（0件のときは `hint` 付き）、USD換算）。`includeIndividualItems` が ON のときは、各商品の明細（タイトル・価格・状態・画像・日時・URL）も出力します。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別レコード（`item-scraped`）**$0.002 / 件**。個別明細は**既定 OFF**（ソース Actor の既定値と同じ）なので、既定実行はキーワードあたり **$0.02 固定**です（`itemStatus` が `both` のときは売り切れ・販売中で2回分析するため $0.04）。**0件のキーワードは課金されません。** キーワード単位の従量課金です。

#### 注意 Notes

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

### 문제가 생기면

- **숫자가 이상하거나 실행이 실패했나요?** **Issues** 탭에 남겨 주세요. 모두 읽고 2 영업일 안에 답합니다(일본 시간).
- **가짜 「빈 결과」는 돌려주지 않습니다.** 사이트를 읽을 수 없으면 실행이 실패하고 그렇게 알려줍니다.
- **결과가 없으면 요금이 없습니다.** 실제로 받은 결과에만 요금이 붙습니다.
- **매주 점검합니다.** 자동 테스트가 매주 돌아가고, 사이트가 바뀌면 고칩니다.
- **공개 페이지만 봅니다.** 로그인하지 않고 개인정보도 다루지 않으며, 사이트에 부담을 주지 않습니다.

### 같은 제작자의 다른 도구

- [Mercari Japan Listings — One Row per Item, $0.0015 Each](https://apify.com/jpmarketdata/mercari-japan-listings)
- [Mercari Japan Underpriced Deals — Under the Sold Price](https://apify.com/jpmarketdata/mercari-japan-underpriced-deals)
- [야후옥션 Yahoo! Auctions 일본 낙찰가 — 중앙값·가격대·입찰수](https://apify.com/jpmarketdata/yahoo-auction-comps-kr)
- [Yahoo! Auctions Japan Sold Prices — Median, Range, Bids](https://apify.com/jpmarketdata/yahoo-auction-sold-comps)
- [Japan Used Camera & Lens — Dealer Price vs Sold Price](https://apify.com/jpmarketdata/japan-camera-gear-sold-comps)
- [Japan Figure & Gunpla — New Price vs Used Sold Price](https://apify.com/jpmarketdata/japan-figure-gunpla-resale-value)
- [Used iPhone & Android Prices Japan — Dealer vs Sold](https://apify.com/jpmarketdata/japan-phone-resale-value)
- [Yahoo, Mercari & PayPay Japan — Same Item, 3 Prices](https://apify.com/jpmarketdata/japan-resale-cross-market-checker)

이 도구의 다른 언어판: [English](https://apify.com/jpmarketdata/mercari-japan-price-checker) · [中文](https://apify.com/jpmarketdata/mercari-japan-price-cn)

모든 도구(일본 마켓플레이스, 부동산, 채용, 경정·경륜·경마, 예측시장): <https://apify.com/jpmarketdata>

### 면책 조항

비공식 독립 도구입니다 — **Mercari와 제휴·보증·후원 관계가 없습니다**. 상품명과 로고는 각 소유자의 것이며 여기서는 데이터 출처를 나타낼 뿐입니다. 공개 페이지에서 읽은 데이터이며 시장 조사용입니다. 행동하기 전에 직접 확인하세요.

# Actor input Schema

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

시세를 조회할 키워드입니다. 여러 개를 한 번에 넣을 수 있습니다(키워드 1개당 $0.02). 되도록 일본어 키워드를 쓰세요. 메르카리는 일본 사이트라 일본어 키워드의 커버리지가 가장 높습니다. 예: 「ポケモンカード リザードン psa10」(포켓몬카드 리자몽 PSA10), 「ロレックス デイトナ」(롤렉스 데이토나), 「ちいかわ ぬいぐるみ」(치이카와 인형). 해외 브랜드는 영어(예: 'Leica M6')로도 검색됩니다. 한국어 키워드는 결과가 없는 것이 아니라 관련 없는 상품이 섞여 나오고 그대로 과금됩니다(2026-08-18 실측 `카메라` → 13건). Korean words do return (mixed, partly unrelated) items and are charged.

## `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(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 '{
  "keywords": [
    "ポケモンカード リザードン psa10"
  ]
}' |
apify call jpmarketdata/mercari-japan-price-kr --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/mercari-japan-price-kr"
        }
    }
}

```

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/CR8KJPzOS025LAhh7/builds/2Nkb67oPTgQZHvFVb/openapi.json