Mercari Japan Scraper: listings, sold prices and full item pages

Scrape Mercari Japan (メルカリ) without an account, cookies or a browser: search by keyword or by a Mercari search link, keep on-sale or sold listings, filter by price, condition, category, brand and shipping, or read full item pages with the description, category path and shipping details. Prices come in JPY straight from Mercari.

Built for resale and sourcing research, sold-price comps, price tracking, proxy-shopping catalogs and market datasets for Japanese second-hand goods (games, trading cards, fashion, electronics).

At a glance

• Price per 1,000 listings, Free plan: US$ 1.99
• Fee per run start: None
• Search by keyword or Mercari link: Yes
• On sale and sold listings: Yes
• Price, condition, category, brand, shipping filters: Yes, plus exclude keyword
• Full item page (description, category path, shipping): Yes, same price
• Seller data: Never (see below)
• Error rows (bad link, deleted item, no results): Free, with an errorCode

One real row

From a test run on 2026-09-28 (search "nintendo switch"):

{
  "type": "item",
  "id": "m95905940143",
  "url": "https://jp.mercari.com/item/m95905940143",
  "title": "Nintendo Switch 本体",
  "priceJpy": 17000,
  "status": "on_sale",
  "conditionId": 3,
  "condition": "No noticeable scratches or stains",
  "categoryId": 701,
  "brand": "Nintendo",
  "brandJa": "任天堂",
  "size": null,
  "shippingPaidBy": "seller",
  "photos": ["https://static.mercdn.net/item/detail/webp/photos/m95905940143_1.jpg?1790505599"],
  "thumbnail": "https://static.mercdn.net/thumb/item/webp/m95905940143_1.jpg?1790505599",
  "createdAt": "2026-09-27T10:39:59Z",
  "updatedAt": "2026-09-28T07:08:34Z",
  "isShopItem": false,
  "searchTerm": "nintendo switch",
  "scrapedAt": "2026-09-28T11:26:13Z",
  "errorCode": null,
  "error": null
}

With Full item pages on (or in item mode) the same row also gets description, category ("本体(Nintendo Switch)"), categoryPath (ゲーム・おもちゃ・グッズ > テレビゲーム > Nintendo Switch > 本体(Nintendo Switch)), conditionJa, shippingMethod (ゆうゆうメルカリ便), shipsWithinDays ([1, 2]), likes (84), commentCount, colors, hashtags and every photo in full size.

Input

Field	Type	What it does
mode	search or item	search runs searches; item reads the full page of each item link.
searchTerms (also keyword, keywords, queries)	list	Keywords in Japanese or English, one search each.
startUrls	list	Mercari search or category links (their filters are kept), item links (jp.mercari.com/item/m...) or plain item ids.
maxItemsPerSearch (also maxItems, limit)	integer, default 120	Listings per search. 0 = as many as Mercari shows (about 12,000).
status	onSale, sold, all	sold returns sold and in-transaction listings, for price research.
sortBy	bestMatch, newest, priceLowToHigh, priceHighToLow, mostLiked	Mercari's own orders.
minPrice, maxPrice	yen	Price range.
itemCondition	list	new, likeNew, noNoticeableWear, someWear, visibleWear, poor.
categoryIds, brandIds	list of numbers	Ids as they appear in Mercari links (category_id=701, brand_id=15487).
excludeKeyword	text	Mercari drops listings that match it.
shippingPaidBy	any, seller, buyer	Shipping included or paid on delivery.
includeDetails	boolean, default false	Full item page for each search result, same price.
includeShopItems	boolean, default true	Keep Mercari Shops listings that appear in the search.
proxyConfiguration	proxy	Apify datacenter proxy by default.

Price

US$ 1.99 per 1,000 listings on the Free plan, no start fee, with or without full item pages. Rows with an errorCode are free, and a listing is never charged twice in a run (the same item found by two searches is delivered once).

Errors you may see

errorCode	Meaning	Charged
INVALID_URL	not a Mercari Japan item, search or category link, nor an item id	no
UNSUPPORTED_URL	a Mercari Shops product page in item mode; shop listings come through search	no
ITEM_NOT_FOUND	the item was deleted or the id is wrong	no
NO_RESULTS	Mercari found nothing for this search and filters	no
BLOCKED	Mercari did not answer after five attempts on new IPs; run again	no
NOT_REACHED	the run timeout arrived before this search or item	no
INVALID_INPUT	a filter value is not valid (for example a minimum price above the maximum)	no
ITEM_UNREADABLE, UNEXPECTED	a listing came in a shape we did not expect; the rest of the run goes on	no

Good to know

• Sold listings are the real price data. status: "sold" with sortBy: "newest" gives the latest sale prices for a keyword; updatedAt is the last change Mercari recorded on the listing.
• Mercari shows about 12,000 listings per search (101 pages of 120). Split a broad search by price range or category to go further.
• No seller data, by design. Mercari sellers are mostly private people, so the Actor never returns seller ids, names, avatars, ratings, profile links, the prefecture they ship from, or the comments under a listing. You get the item only. The description is the seller's own text, as published.
• Mercari Shops (business sellers) listings appear in search with isShopItem: true and a /shops/product/ link; their full page is not read yet.
• Condition labels come in English (condition) with Mercari's Japanese label in conditionJa on full item pages. brand is the brand's Latin name when Mercari has one.
• Something broke? Open an issue on the Actor page.

FAQ

Do I need a Mercari account or a Japanese IP? No. Nothing to log in to, no cookies to paste, and the default datacenter proxy works from outside Japan.

How fast is it? One request returns 120 listings; a test read 836 listings in 8 seconds. Full item pages take one request each, six at a time.

Can I paste a search link from my browser? Yes. Keyword, status, price range, category, brand, condition, shipping and sort in the link are all kept.

Can I use it from n8n, Make, Zapier or an AI agent? Yes, through the Apify app or the Apify MCP server. Error rows are free, so an agent can explore cheaply.

What if a run is cut by its timeout? The Actor stops 45 seconds before the limit and ends successfully with what it delivered, telling you in the status message how to get the rest.

Changelog

• 0.1 (2026-09-28): first version. Keyword and link search, on-sale and sold listings, price, condition, category, brand, shipping and exclude filters, full item pages, free error rows.