Mercari Japan Scraper — Products, Prices, Brands & Sellers

Mercari Japan Scraper — Prices, Conditions, Brands, Sizes & Sellers (メルカリ)

Extract live product listings, historical sold-out price comparables, official item condition grades, brand identifiers, apparel sizes, and seller metrics from Mercari Japan (メルカリ), Japan's undisputed #1 C2C secondhand marketplace. Whether you are conducting resale arbitrage, tracking Pokémon trading cards, evaluating luxury watches, or analyzing Japanese retail price trends, Mercari Japan Scraper delivers high-throughput structured market intelligence.

---

⚡ At a Glance

Feature	Specification
Target Website	Mercari Japan (jp.mercari.com)
Input Options	Keywords (searchTerms), listing status (status), sort orders, price boundaries
Listing Status Filters	onSale (available inventory), soldOut (historical comps), or all
Data Fields	Title, price in JPY, condition grade (1-6), brand, apparel sizes, seller ID, shop name, images, timestamps
Output Formats	Dataset (JSON, CSV, Excel, XML, NDJSON), Key-Value Store run summary
Pagination	Deep pagination unlocked (1,000+ items across single or multiple keywords)
Proxy Requirement	Apify Proxy datacenter proxies (automatic IP rotation, no residential proxy required)
Execution Speed	Ultra-fast HTTP-only extraction (~120 listings per page in milliseconds)
Authentication	No Mercari account or manual API token needed

---

🚀 Why Scrape Mercari Japan?

Mercari (メルカリ) is the epicenter of Japan's secondhand economy and consumer-to-consumer commerce, hosting tens of millions of active listings spanning fashion, luxury goods, retro gaming, anime merchandise, trading cards, and consumer electronics:

• 💹 Resale Arbitrage & Market Comps: Pull thousands of recently soldOut items to discover the exact market-clearing price across international resale platforms (eBay, StockX, Chrono24).
• 🃏 Trading Cards & Collectibles Tracking: Track pricing trends for Pokémon cards (ポケモンカード), Yu-Gi-Oh!, One Piece TCG, and exclusive Japanese anime figurines.
• ⌚ Luxury & Streetwear Valuation: Monitor condition grades, price spreads, and authentic seller stock for brands like Rolex, Omega, Louis Vuitton, Supreme, and BAPE.
• 📦 Automated Stock Sourcing: Detect underpriced vintage cameras, retro consoles (Nintendo, PlayStation), and rare apparel before competitors buy them.
• 📊 Macro Secondary Market Intelligence: Analyze volume distributions, brand market share, and depreciation curves across Japanese consumer verticals.

---

🥊 Feature Comparison: Mercari Japan Scraper vs Alternatives

Feature	Mercari Japan Scraper (This Actor)	Web Scraping / HTML Parsing	Official Web UI	Generic Scrapers
Authentication / Tokens	⚡ Automatic cryptographic token minting	🔴 Blocked by client-side render	⚠️ Manual browsing only	🔴 401 Unauthorized errors
Historical Sold Comps	🟢 Direct soldOut filter support	🔴 Hard to isolate	🟡 Manual click per item	🔴 Fails on lazy-loaded pages
Listing Throughput	⚡ 120 listings per API page	🐌 20-30 DOM elements	🐌 Human reading speed	🔴 Frequent rate limits
Official Condition Grades	🟢 Normalized (6 standardized tiers)	🟡 Unparsed Japanese text	🟡 Visual check	🔴 Missing or raw IDs
Brand & Size Normalization	🟢 Structured brandId, size, sizes	🔴 Messy text extraction	🟡 Visual reading	🔴 Missing
Deep 1,000+ Pagination	🟢 Automatic cursor traversal	🔴 Fails after page 2	🐌 Manual next button	🔴 Blocked

---

📊 Extracted Data Fields

Every scraped listing is parsed into standardized, strongly-typed JSON records:

🏷️ Item Identification & Metadata

Field	Type	Description	Coverage
id	String	Unique Mercari listing identifier (e.g. m42971856910)	🟢 High (100%)
name	String	Complete listing title in Japanese or English	🟢 High (100%)
url	String	Direct canonical URL to the item page on jp.mercari.com	🟢 High (100%)
searchTerm	String	The query term that produced this listing record	🟢 High (100%)
itemType	String	Marketplace origin (mercari standard or beyond for Mercari Shops)	🟢 High (100%)
isAuction	Boolean	true if the item is listed in an auction format	🟢 High (100%)

💰 Pricing, Status & Condition

Field	Type	Description	Coverage
price	Integer	Final listing price in Japanese Yen (¥)	🟢 High (100%)
currency	String	Currency denomination (always JPY)	🟢 High (100%)
status	String	Current listing status (on_sale or sold_out)	🟢 High (100%)
condition	String	Normalized condition grade (New / unused, Almost unused, No noticeable damage, etc.)	🟢 High (100%)
conditionId	String	Raw Mercari condition code (1 through 6)	🟢 High (100%)
shippingPayer	String	Shipping burden (Free (seller pays) or Buyer pays)	🟢 High (96%)

🏷️ Categorization & Attributes

Field	Type	Description	Coverage
brand	String	Clean brand name (e.g., NIKE, Rolex, BANDAI)	🟡 Conditional (~55%)
brandId	String	Official Mercari brand database identifier	🟡 Conditional (~55%)
size	String	Primary size descriptor (e.g., L, 27.5cm, FREE SIZE)	🟡 Conditional (~40%)
sizes	Array	Full array of associated size tags	🟡 Conditional (~40%)
categoryId	String	Mercari numerical category hierarchy ID	🟢 High (100%)

🏢 Seller Information & Media

Field	Type	Description	Coverage
sellerId	String	Numerical account ID of the individual merchant	🟢 High (98%)
shopName	String	Registered store name (for Mercari Shops / beyond items)	🟡 Conditional (~15%)
imageUrl	String	Direct link to high-resolution primary photo	🟢 High (100%)
thumbnails	Array	Full collection of photo thumbnail URLs	🟢 High (100%)
createdAt	String	ISO 8601 creation timestamp	🟢 High (100%)
updatedAt	String	ISO 8601 last modification timestamp	🟢 High (100%)
scrapedAt	String	ISO 8601 timestamp when scraped	🟢 High (100%)

---

🏷️ Official Mercari Item Condition Reference

Mercari uses an official 6-tier condition grading system. The scraper automatically maps the raw integer code (conditionId) to human-readable descriptors:

conditionId	Japanese Label	English Standard	Typical Condition Characteristics
1	新品、未使用	New / unused	Brand new with tags, unopened packaging, pristine
2	未使用に近い	Almost unused	Like new, tried on once, flawless exterior
3	目立った傷や汚れなし	No noticeable damage	Excellent pre-owned condition, minor gentle wear
4	やや傷や汚れあり	Slightly damaged	Normal used condition, minor scuffs or subtle marks
5	傷や汚れあり	Damaged	Visible wear, scratches, or cosmetic discoloration
6	全体的に状態が悪い	Poor condition	Heavy wear, junk items, or parts-only condition

---

🗂️ Major Japanese Mercari Categories & ID Hierarchy

Understanding Mercari's category IDs enables precise downstream catalog sorting:

Category Name	Japanese Equivalent	Common Category IDs
Trading Cards & TCG	トレーディングカード	107, 108, 1289
Video Games & Consoles	テレビゲーム	72, 1056, 1152
Men's Apparel & Streetwear	メンズ ファッション	2, 1077, 1080
Women's Luxury & Bags	レディース バッグ	1, 645, 652
Anime Figures & Toys	おもちゃ・ホビー・グッズ	5, 81, 82
Cameras & Optics	カメラ・光学機器	97, 852, 853

---

⚙️ Input Configuration

Mercari Japan Scraper provides comprehensive parameter control for both quick target lookups and high-volume data harvesting:

Parameter	Type	Default	Description
searchTerms	Array of Strings	["nintendo switch"]	Keywords to search (Japanese kanji/katakana or English brand names).
status	String (Select)	"onSale"	Availability filter: onSale, soldOut (for price comps), or all.
sort	String (Select)	"newest"	Sorting option: relevance, newest, priceAsc, priceDesc, or likes.
priceMin	Integer	0 (none)	Minimum listing price in Japanese Yen (e.g., 5000).
priceMax	Integer	0 (none)	Maximum listing price in Japanese Yen (e.g., 50000).
maxItems	Integer	0 (unlimited)	Total listings to collect across searches. Prefill is 100 for rapid testing.
maxPages	Integer	0 (unlimited)	Max pages per keyword (120 listings/page). Set to 0 for unconstrained crawling.
maxConcurrency	Integer	2	Parallel search workers (1–5) for high-speed multi-term harvesting.
proxyConfiguration	Object	Datacenter	Apify Proxy configuration. Datacenter proxies work reliably and keep runs cheap.

Example Input: Sold-Out Resale Comps (Pokémon Cards)

{
  "searchTerms": ["ポケモンカード 151 BOX", "ナンジャモ SAR"],
  "status": "soldOut",
  "sort": "newest",
  "priceMin": 3000,
  "maxItems": 500,
  "maxPages": 0,
  "maxConcurrency": 2,
  "proxyConfiguration": { "useApifyProxy": true }
}

Example Input: Luxury Watch Market Discovery

{
  "searchTerms": ["rolex submariner", "omega speedmaster"],
  "status": "onSale",
  "sort": "priceDesc",
  "priceMin": 300000,
  "maxItems": 250,
  "maxPages": 0,
  "maxConcurrency": 2,
  "proxyConfiguration": { "useApifyProxy": true }
}

---

📦 Sample Output

{
  "id": "m42971856910",
  "name": "海外新品、タグ付き NIKE スポーツハーフタイツ Sサイズ 青",
  "price": 3750,
  "currency": "JPY",
  "status": "on_sale",
  "condition": "New / unused",
  "conditionId": "1",
  "shippingPayer": "Free (seller pays)",
  "brand": "NIKE",
  "brandId": "857",
  "size": "S",
  "sizes": ["S"],
  "categoryId": "10770",
  "itemType": "mercari",
  "shopName": null,
  "isAuction": false,
  "sellerId": "973114032",
  "imageUrl": "https://static.mercdn.net/thumb/item/webp/m42971856910_1.jpg?1775092778",
  "thumbnails": [
    "https://static.mercdn.net/thumb/item/webp/m42971856910_1.jpg?1775092778",
    "https://static.mercdn.net/thumb/item/webp/m42971856910_2.jpg?1775092778"
  ],
  "createdAt": "2026-04-02T01:19:38.000Z",
  "updatedAt": "2026-11-02T01:52:34.000Z",
  "url": "https://jp.mercari.com/item/m42971856910",
  "searchTerm": "nike",
  "scrapedAt": "2026-11-10T14:41:22.586Z"
}

---

💼 Step-by-Step Practical Workflow

Step 1: Select Search Keywords and Language

Determine whether your search terms are broad brand names ("supreme", "sony") or targeted Japanese phrases ("ポケモンカード 未開封", "ニンテンドースイッチ 有機EL"). Entering authentic Japanese keywords often returns 3x to 5x higher listing volumes.

Step 2: Choose Listing Availability Mode

• If your goal is purchasing available inventory or real-time alert monitoring, select status: "onSale".
• If your objective is pricing historical comps, calculating fair market value, or measuring sales velocity, select status: "soldOut".

Step 3: Run the Actor and Monitor Live Streaming

Hit Start. Mercari Japan Scraper immediately begins parallel workers, minting proof tokens on the fly and pulling 120 items per API page. Watch the live console logs as items are pushed into your dataset.

Step 4: Export to Business Intelligence or Sheets

Once complete, download your data in Excel (.xlsx), CSV, or JSON format. You can also integrate webhooks to sync directly with Google Sheets, PostgreSQL, or your proprietary arbitrage dashboard.

---

💼 High-Impact Business Applications

1. Cross-Border Resale & eBay Arbitrage

Source items in Japan at domestic C2C prices and resell them globally at higher margins. By monitoring both onSale prices and historical soldOut market clearing rates, you can accurately estimate net margins after shipping and export taxes.

2. Trading Card Game (TCG) & Collectibles Market Indices

Build real-time pricing indices for rare collectible cards and figures. Calculate moving average prices, detect sudden spikes in market demand, and identify newly listed mint-condition cards (conditionId: "1").

3. Luxury Goods & High-End Watch Valuation

Extract authentic pre-owned luxury listings. Compare current Japanese asking prices against European and North American auction houses to spot price discrepancies.

4. Brand Protection & Intellectual Property Monitoring

Track unauthorized resellers, counterfeit goods, or parallel-imported merchandise. Scrape brand-specific listings across high-risk categories to identify prolific unauthorized merchant accounts (sellerId).

---

💡 Practical Keyword Reference for Japanese Sourcing

Using authentic Japanese search terms frequently yields significantly more listings than English translations:

Category	English Keyword	Japanese Search Term (High Volume)
Trading Cards	Pokémon Card Box	ポケモンカード 未開封 BOX
Retro Gaming	Game Boy Advance SP	ゲームボーイアドバンスSP 本体
Anime Figures	One Piece Figure	ワンピース フィギュア 一番くじ
Camera & Lenses	Contax T2 / T3	CONTAX T2 完動品
Streetwear	Supreme Box Logo Hoodie	Supreme ボックスロゴ パーカー
Luxury Bags	Louis Vuitton Monogram	ルイヴィトン モノグラム バッグ

---

🔗 Exporting & Microservice Integration

Automate your Mercari data pipelines using Apify's API and client SDKs:

• Apify API (cURL):

  $curl -X GET "https://api.apify.com/v2/datasets/{DATASET_ID}/items?format=json&clean=true"
  

• Python Data Science Pipeline:

  from apify_client import ApifyClient
  import pandas as pd
  
  client = ApifyClient("YOUR_APIFY_TOKEN")
  run = client.actor("haketa/mercari-scraper").call(run_input={
      "searchTerms": ["ポケモンカード 151"],
      "status": "soldOut",
      "maxItems": 300
  })
  
  items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
  df = pd.DataFrame(items)
  print(f"Average Sold Price: ¥{df['price'].mean():,.0f} JPY across {len(df)} comps")
  

• Node.js Automated Webhook:

  import { ApifyClient } from 'apify-client';
  
  const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
  const run = await client.actor('haketa/mercari-scraper').call({
      searchTerms: ['sony a7iv'],
      status: 'onSale',
      maxItems: 120,
  });
  const { items } = await client.dataset(run.defaultDatasetId).listItems();
  console.log(`Retrieved ${items.length} active listings`);
  

• Automated Webhooks (Discord / Slack / Zapier / Make): Pipe newly extracted deals directly into your Discord channel or Slack workspace with immediate image previews and direct buy links.

---

❓ Frequently Asked Questions

Do I need a Japanese IP address or residential proxy?

No. Mercari Japan's API does not enforce strict residential IP restrictions on these search endpoints. The actor works seamlessly and cost-effectively with standard Apify datacenter proxies.

How do I scrape historical sold prices for price comps?

Simply change the status dropdown in the input from onSale to soldOut. The scraper will exclusively return items that have already been purchased, providing accurate historical market comps.

How does deep pagination work?

Mercari returns 120 listings per API page with a cursor token (nextPageToken). When maxPages is set to 0, the actor crawls subsequent pages continuously until your maxItems target is fulfilled or all search results are exhausted.

Why are some brand or size values null?

These attributes are strictly data-dependent. A listing for a video game or trading card does not have an apparel size or fashion brand; in those cases, the fields are cleanly returned as null.

Can I run multiple keyword queries at once?

Yes! Enter multiple terms in searchTerms (e.g. ["ps5", "switch", "xbox"]). The actor processes them concurrently based on your maxConcurrency setting and consolidates all records into a single deduplicated dataset.

What currency are prices reported in?

All prices are returned in Japanese Yen (JPY, ¥) as integers matching the exact domestic checkout amount.

How frequently can I schedule this actor?

You can run this actor on any recurring schedule—from hourly deal-monitoring alerts to daily historical market archiving—using the Apify platform's built-in scheduler.

Can I export directly to Google Sheets or Airtable?

Yes. You can use Apify's native Google Sheets integration or connect via Make.com / Zapier to append new listings automatically.

Are shipping costs included in the price?

In Japan, most sellers offer free shipping (shippingPayer: "Free (seller pays)"). When the buyer pays shipping, shippingPayer indicates "Buyer pays".

How does deduplication work across multiple terms?

Every Mercari listing has a unique alphanumeric ID (e.g., m1234567890). The actor deduplicates listings in memory during the run so your dataset contains zero duplicate items.

Is there a rate limit on the number of searches?

The actor handles request pacing and proxy rotation internally to prevent throttle responses. For large enterprise jobs scraping thousands of queries, keep maxConcurrency at 2 or 3 for maximum operational stability.

---

📋 Changelog

v1.2 — 2026-11

• Deep Pagination Unlocked: Removed restrictive 100-page limit; unlocked maxPages: 0 for unconstrained pagination up to 1,000+ items.
• Fast Prefill Optimization: Configured rapid prefill defaults for sub-minute test runs.
• Input & Output Schema Refinements: Added standardized descriptions, output viewer URLs, and streamlined validation rules.
• Enhanced Token & Rotation Resilience: Improved automatic cryptographic token generation and connection retry handlers.

v1.1 — 2026-11

• Added support for multiple sizes extraction (sizes array) and Mercari Shops indicators (shopName).
• Added filtering by price range (priceMin and priceMax).
• Added sorting presets for relevance, price, and likes.

v1.0 — 2026-11

• Initial production release for Mercari Japan (メルカリ) scraping.
• Support for onSale and soldOut listing status filters.
• Native ES256 cryptographic token implementation without browser overhead.