# Mercari Japan Price Checker — Sold Comps & Market Stats (`jpmarketdata/mercari-japan-price-checker`) Actor

Get instant price statistics (median, average, range) from sold listings on Mercari Japan. One call answers: what is this item actually worth in Japan?

- **URL**: https://apify.com/jpmarketdata/mercari-japan-price-checker.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce
- **Stats:** 3 total users, 0 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 Price Checker — Sold Comps & Market Stats

**One call answers the question every reseller, collector, and proxy buyer keeps asking: "What is this item actually worth on Mercari Japan?"**

Instead of dumping thousands of raw listings on you, this Actor samples **sold (completed) listings** for your keywords and returns a ready-to-use price summary — median, average, quartiles, price range, and how fast items sell — plus the individual comps if you want them.

**Try it free in 30 seconds:** hit *Start* with the prefilled example — one keyword costs a flat **$0.02**, covered many times over by the **$5 free usage credit** every Apify account gets each month.

### 日本語ガイド — メルカリの売り切れ相場を1コールで

**概要**: メルカリの**売り切れ(SOLD)商品**をキーワード検索し、実際に売れた価格の統計 — 中央値・平均・四分位・価格帯 — と「売れるまでの日数」の中央値を JSON で返します。出品前の相場チェック、仕入れ・せどりの判断、eBay など海外市場との価格差の確認に使えます。

**使い方**: 入力欄にキーワードを入れて *Start* を押すだけ。日本語キーワードが最も精度が高く、複数キーワードの一括チェックもできます。

```json
{
    "keywords": ["ポケモンカード リザードン psa10"],
    "itemStatus": "sold_out",
    "maxItemsPerKeyword": 120,
    "convertToUsd": true
}
```

**料金**: 1キーワードあたり **$0.02(約3円)** の従量課金で、サブスクリプションや月額固定費はありません。個別の売り切れ一覧(タイトル・価格・URL 付き)も欲しい場合は *Include individual listings* をオンにすると +$0.002/件。結果が0件のキーワードには課金されません。Apify の無料プランには**毎月 $5 分の無料クレジット**が付くので、月250回程度の相場チェックまで実質無料です。

### Why sold comps?

Asking prices lie. Sold prices don't. Mercari Japan is the world's largest source of Japanese collectibles — trading cards (Pokémon, One Piece, Yu-Gi-Oh!), anime figures, film cameras, watches, fashion, retro games — but its sold-item data is only browsable in Japanese, one page at a time. This Actor turns it into structured market intelligence:

- **Price a collection before you buy or sell** — median and quartiles from real completed sales
- **Spot arbitrage** — compare Japan sold prices against eBay/StockX/your local market
- **Track liquidity** — `medianDaysToSell` tells you how fast an item actually moves
- **Feed your AI agent or spreadsheet** — clean JSON, USD conversion included

### Pricing — know your cost before you run

No subscription, no monthly rental — you pay per call:

| Event | Price |
|---|---|
| Price summary (one per keyword) | **$0.02** |
| Individual listing record (optional, off by default) | $0.002 each |

- **A default run costs a flat $0.02 per keyword** — the summary is the product. 10 keywords = $0.20.
- Want the raw comps too? Turn on *Include individual listings*: e.g. 120 listings add $0.24.
- Keywords with zero results are never charged.
- Apify's free plan includes **$5 of usage credit every month** — about **250 price checks** at no cost. Most scrapers rent by the month; here an occasional price check costs cents.

### Input example

```json
{
    "keywords": ["ポケモンカード リザードン psa10", "Leica M6"],
    "itemStatus": "sold_out",
    "maxItemsPerKeyword": 120,
    "convertToUsd": true
}
```

Japanese keywords give the best coverage. English brand names (Leica, Rolex, Supreme) also work well.

### Output

One `price_summary` record per keyword:

```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"
}
```

Plus (optional) every sampled listing with title, JPY/USD price, condition, photo, timestamps, and a direct `jp.mercari.com` URL.

### Use with AI agents

This Actor works out of the box with the [Apify MCP server](https://mcp.apify.com), so Claude, ChatGPT, and other MCP-enabled agents can check Japanese market prices autonomously — for example inside an automated sourcing or repricing workflow.

### Fair use & data

- Reads only **publicly visible listing data** — no login, no personal data beyond what any visitor sees
- Requests are throttled to keep the load on Mercari negligible
- Not affiliated with Mercari, Inc. Data is provided for market research; verify before large transactions

### Roadmap

Multi-marketplace comps (Yahoo! Auctions / PayPay Flea Market), price history tracking, and category-level market reports. Feedback via issues is very welcome — tell me what your workflow needs.

# Actor input Schema

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

One or more search queries. Japanese keywords give the best results (e.g. 'ポケモンカード リザードン psa10'), but English brand names also work (e.g. 'Leica M6').

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

'sold\_out' analyzes completed sales (sold comps — best for price research). 'on\_sale' analyzes current asking prices. 'both' fetches the two sets and reports them separately.

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

How many listings to sample per keyword (per status). 120 = one result page. More items = better statistics. Affects cost only when 'Include individual listings' is enabled (+$0.002 per listing).

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

Optional lower price bound in Japanese yen. Useful to exclude junk/fake listings from the statistics.

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

Optional upper price bound in Japanese yen.

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

Off by default: a run costs a flat $0.02 per keyword (price summary only). Enable to also get every sampled listing (title, price, URL, photo, condition, timestamps) at +$0.002 per listing.

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

Adds USD prices next to JPY using the current exchange rate (open.er-api.com).

## 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-checker").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-checker").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-checker --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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