Mercari Japan Scraper — Listings, Prices & Sold Data

---

📌 Overview

The Mercari Japan Scraper searches mercari.jp — Japan's largest consumer-to-consumer marketplace — for any list of keywords and returns every matching listing as a clean record: title, price in JPY, item condition, brand, sale status, seller, category, timestamps and photo URLs. It paginates each search to pull thousands of listings per keyword.

It needs no login, no cookies and no API key — it reads only public search data over residential proxies, so there's zero account risk. With no headless browser, it's a fast and low-cost way to assemble large marketplace datasets.

✅ Add many keywords, set filters (price / condition / brand) and raise maxItemsPerTerm to build an analysis-ready Mercari dataset in one run.

---

✨ Features

	Feature	Description
📦	Thousands per search	Token pagination walks the full public search result set.
💴	Full pricing data	Price in JPY, sale status (on sale / sold out) and timestamps.
🏷️	Condition & brand	Item condition, brand id + name, category and item type.
🖼️	Photos	Thumbnail plus full photo URL array for every listing.
👤	Seller enrichment	Optional fetchDetails adds description + seller ratings, score & items sold.
🎚️	Smart filters	Filter by status, price range, category, brand and condition.
⚡	No browser	Lightweight signed-API access — fast and cheap at scale.
🛡️	Login-free & safe	No account, no cookies, no ban risk — public data only.
📤	Any format	Export to JSON, CSV, Excel, HTML or pull via API & webhooks.

---

🎯 Who it's for

• Resellers & arbitrage — track prices, sold-out velocity and brands across Japan's biggest marketplace.
• Market & pricing research — benchmark resale prices for any product or brand.
• Brand protection — monitor counterfeit and grey-market listings.
• Data science & ML — build labelled product datasets for pricing, trend and demand models.

---

🧾 Input

Field	Type	Description
searchTerms	array	Required. Keywords to search (nintendo, pokemon card, supreme). One search per term.
status	enum	on_sale (default), sold_out, or all.
sort	enum	SORT_SCORE (best match), SORT_CREATED_TIME, SORT_PRICE, SORT_NUM_LIKES.
priceMin / priceMax	integer	Price range filter in JPY. 0 = no bound.
categoryId / brandId / itemConditionId	array	Optional Mercari id filters.
fetchDetails	boolean	Also fetch full description + seller stats per item. Default false.
maxItemsPerTerm	integer	Cap per keyword. 0 = unlimited.
maxResults	integer	Global cap across all keywords. 0 = unlimited.
proxyConfiguration	object	Residential proxy (recommended). Pre-configured for you.

Example input

{
  "searchTerms": ["nintendo", "pokemon card"],
  "status": "on_sale",
  "sort": "SORT_CREATED_TIME",
  "priceMin": 1000,
  "priceMax": 50000,
  "fetchDetails": false,
  "maxItemsPerTerm": 1000
}

---

📦 Output

Each listing is saved as one structured record:

{
  "id": "m12345678901",
  "url": "https://jp.mercari.com/item/m12345678901",
  "name": "Nintendo Switch 本体 有機ELモデル ホワイト",
  "price": 32000,
  "currency": "JPY",
  "status": "STATUS_ON_SALE",
  "itemConditionId": "2",
  "categoryId": "1234",
  "brandId": "5678",
  "brandName": "Nintendo",
  "sellerId": "987654321",
  "itemType": "ITEM_TYPE_MERCARI",
  "thumbnail": "https://static.mercdn.net/c!/w=240/thumb/photos/m12345678901_1.jpg",
  "photos": ["https://static.mercdn.net/item/detail/orig/photos/m12345678901_1.jpg"],
  "created": 1717400000,
  "updated": 1717500000,
  "searchTerm": "nintendo",
  "scrapedAt": "2026-06-04T10:00:00.000Z"
}

With fetchDetails: true, each record also includes description, sellerName, sellerNumSellItems, sellerNumRatings and sellerScore.

📖 Output field reference

Field	Description
id / url	Mercari item id and direct listing link
name	Listing title (Japanese)
price / currency	Price in JPY
status	STATUS_ON_SALE or STATUS_SOLD_OUT
itemConditionId	Mercari condition id (1 = new … 6 = poor)
brandId / brandName	Brand id and name (when present)
categoryId / itemType	Mercari category and listing type
sellerId	Seller id
thumbnail / thumbnails / photos	Image URLs
created / updated	Listing timestamps
description / seller*	Added when fetchDetails is on

---

⚙️ How it works

1. You provide one or more search keywords and optional filters.
2. For each term the actor queries Mercari's public search API, signing every request with a freshly generated DPoP (ES256) token — no account, no cookies.
3. It paginates with the result page token until the term is exhausted or your cap is hit.
4. Each item is parsed into a clean record; with fetchDetails it also pulls the full description and seller stats, then streams results to the dataset.

No login, no cookies, no API keys — and no Mercari account is ever used or risked.

---

❓ FAQ

---

🔗 Works great with

• 🛒 E-commerce price trackers — feed Mercari prices into your pricing pipeline.
• 🖼️ Bulk image downloader — pull the listing photos for cataloguing or ML.

---

📝 Changelog

2026-06-05

• 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results).
• ⚡ Stability & performance hardening; fresh rebuild.

2026-06-04

• Verified live & refreshed build — reliability/maintenance pass.