Mercari Japan Item Detail Scraper

Get the full detail for one Mercari Japan (jp.mercari.com) listing — title, price in yen (¥), condition, category, description, seller, availability and every photo — from an item id or URL. Pair it with the Mercari Japan Search Scraper to enrich search results.

• Marketplace: Mercari Japan (jp.mercari.com). Prices are Japanese yen (JPY).
• Pricing: Pay per result — $4.00 / 1,000 items (charged only when an item is returned).

Input

Provide one of item_id / url, or leave both blank and give a seed_search keyword (the actor then details the top live result for that keyword — handy for testing).

Field	Type	Required	Description
item_id	string		Mercari Japan item id, e.g. m28656360094.
url	string		Full item URL, e.g. https://jp.mercari.com/item/m28656360094.
seed_search	string		Used only when item_id/url are blank: details the TOP live result for this keyword. Default ポケモンカード.

{ "item_id": "m28656360094" }

Output

One dataset row:

Field	Type	Description
item_id	string	Mercari item id.
title	string	Full listing title.
price	integer	Price in yen (no decimals).
currency	string	Always JPY.
condition	string	Japanese condition grade (e.g. 新品、未使用, 目立った傷や汚れなし).
availability	string	InStock or SoldOut.
is_sold	boolean	True when sold.
category	string	Category path (e.g. ゲーム・おもちゃ・グッズ > トレーディングカード > ポケモンカードゲーム).
description	string	Full item description.
seller_id / seller_name / seller_url	string	Seller profile.
num_images	integer	Number of photos.
images	array	Full-resolution photo URLs (up to 20).
url	string	Canonical item URL.

{
  "item_id": "m28656360094",
  "title": "ピカチュウex sar スタートデッキ100 NO.25",
  "price": 480000,
  "currency": "JPY",
  "condition": "新品、未使用",
  "availability": "InStock",
  "is_sold": false,
  "category": "ゲーム・おもちゃ・グッズ > トレーディングカード > ポケモンカードゲーム",
  "seller_id": "874742996",
  "seller_name": "即購入⭕",
  "num_images": 12,
  "url": "https://jp.mercari.com/item/m28656360094"
}

Use it from code

Python

from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("good-apis/mercari-product-scraper").call(
    run_input={"item_id": "m28656360094"})
item = next(client.dataset(run["defaultDatasetId"]).iterate_items())
print(item["title"], item["price"], "JPY", item["condition"])

Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<APIFY_TOKEN>' });
const run = await client.actor('good-apis/mercari-product-scraper')
    .call({ item_id: 'm28656360094' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

FAQ

Where do I get an item_id? From the Mercari Japan Search Scraper, or the code in any jp.mercari.com/item/<id> URL.

What if the item was already sold or removed? The actor returns a clear error rather than a partial row; sold-but-still-listed items return normally with is_sold: true.

Why is condition in Japanese? It is Mercari Japan's own condition grade, kept verbatim so it matches the site exactly.