Mercari Japan Scraper

Scrape product listings, prices, and sold items from Mercari Japan -- Japan's largest consumer-to-consumer marketplace.

Key Features

• Search by keywords -- Find products matching any query on Mercari Japan
• Sold item tracking -- View actual selling prices for resale research (物販リサーチ)
• Price range filtering -- Narrow results by minimum/maximum price in JPY
• Item condition filtering -- Filter by new, like-new, good, fair, or poor condition
• Flexible sorting -- Sort by relevance, price, or newest listings
• Direct URL scraping -- Scrape individual product pages for full details
• Automatic pagination -- Collect up to 1,000 items per run

Why Track Sold Items?

For resellers and market researchers, knowing the actual selling price is more valuable than the listing price. Set status to sold_out to see completed transactions and understand real market value.

Input Parameters

Parameter	Type	Required	Default	Description
searchKeywords	string[]	Yes*	--	Keywords to search for
productUrls	string[]	Yes*	--	Direct Mercari product URLs
status	string	No	all	all, on_sale, or sold_out
sortBy	string	No	relevance	relevance, price_asc, price_desc, created_desc
priceMin	integer	No	--	Minimum price in JPY
priceMax	integer	No	--	Maximum price in JPY
itemCondition	string	No	all	all, new, like_new, good, fair, poor
maxResults	integer	No	50	Max items to scrape (1-1000)

*At least one of searchKeywords or productUrls is required.

Output Fields

Each scraped item includes:

Field	Type	Description
productId	string	Mercari item ID
title	string	Product title
price	number	Price in JPY
url	string	Full product URL
imageUrl	string	Primary image URL
thumbnails	string[]	All thumbnail URLs
status	string	Item status (on_sale / sold_out)
isSold	boolean	Whether the item has been sold
condition	string	Item condition
description	string	Full description (product pages only)
sellerName	string	Seller display name
sellerRating	number	Seller rating score
categoryName	string	Product category
brandName	string	Brand name
shippingPayer	string	Who pays shipping
shippingMethod	string	Shipping method (product pages only)
likeCount	number	Number of likes
commentCount	number	Number of comments
updatedAt	string	Last update timestamp
scrapedAt	string	When the data was scraped

Example Usage

Search for Nintendo Switch listings

{
  "searchKeywords": ["Nintendo Switch"],
  "status": "on_sale",
  "sortBy": "price_asc",
  "priceMax": 30000,
  "maxResults": 100
}

Research sold prices for iPhone 15

{
  "searchKeywords": ["iPhone 15"],
  "status": "sold_out",
  "sortBy": "created_desc",
  "maxResults": 200
}

Scrape specific product pages

{
  "productUrls": [
    "https://jp.mercari.com/item/m12345678",
    "https://jp.mercari.com/item/m87654321"
  ]
}

Proxy Requirements

This actor uses datacenter proxies (BUYPROXIES94952) with Japan IP addresses by default. If datacenter proxies are unavailable, it falls back to residential proxies. Mercari Japan may block non-Japanese IP addresses.

Pricing

$4 per 1,000 items scraped.

Limitations

• Mercari may limit search results to approximately 600 items per query
• Heavy scraping may trigger rate limiting or CAPTCHA challenges
• Some fields (description, shippingMethod) are only available on individual product pages
• Results depend on Mercari's page structure; changes to the site may temporarily affect data extraction