Mercari US Scraper

Turn any Mercari US (mercari.com) search into clean, structured JSON — one row per listing, with price, condition, brand, likes, seller and shipping. Pull active listings for monitoring, or sold-price comps for resale research. No browser, no Cloudflare headaches — the actor passes the site's bot protection for you and returns export-ready data.

Who it's for

• Resellers & sourcers — see what actually sold and for how much (sold comps), plus the live competition for any item.
• Pricing & e-commerce analysts — price distribution, discounts, brand and category trends across a query.
• Data & SaaS developers — a reliable Mercari US feed without maintaining anti-bot infrastructure.
• Market researchers — brand demand (likes) and category velocity.

What you get (output fields)

Field	Description
id, url	Listing id and canonical Mercari URL
name	Listing title
price_usd, original_price_usd	Current and original price (USD)
price_dropped	Whether the price was reduced
status	on_sale, trading, or sold_out
num_likes	Number of likes (demand signal)
condition, condition_id	New / Like new / Good / Fair / Poor
brand, brand_id	Brand name and Mercari brand id
category, category_id, category_path	Leaf category and full category breadcrumb
item_size	Size (apparel), when present
seller_id	Seller account id
created, updated	Listing timestamps (Unix)
photos, thumbnail	Image URLs
shipping_fee_usd, shipping_payer	Shipping cost and who pays (needs item details)
description	Listing description (needs item details)
source, scraped_at	Query provenance and capture time (ISO 8601)

Mercari's search feed is lightweight: description, shipping_fee_usd and shipping_payer are only returned with includeDetails on. With Enrich with item details enabled, each row also gets shipping_from_area, shipping_carrier, shipping_eta, item_type and checksum. With Enrich with seller profile on, you also get seller_name, seller_num_sales, seller_num_ratings, seller_rating and seller_is_pro.

High-value use cases

• Sold-price comps (resellers): set Listing status = Sold out and Sort = Newest to pull recently-sold items with their final prices — know what to list and at what price before you buy.
• Active competition: status On sale, sort Price: low to high to see what you're up against for an item.
• Brand/category intelligence: filter by brandIds or categoryIds and read num_likes + price spread to gauge demand.
• Deal & price-drop tracking: schedule a daily run and watch price_dropped.

Input parameters

Param	Type	Default	Description
searchQueries	array	—	Keywords to search (required), e.g. ["nintendo switch"]
itemStatus	enum	on_sale	on_sale · sold_out (comps) · trading · all
sortBy	enum	relevance	relevance · newest · price_asc · price_desc
condition	enum	all	all · new · like_new · good · fair · poor
priceMin/priceMax	integer	—	Price bounds in whole USD
brandIds	array	—	Numeric Mercari brand IDs (e.g. 5074 = Pokemon)
categoryIds	array	—	Numeric Mercari category IDs
includeDetails	boolean	false	Add description + full shipping per listing
includeSeller	boolean	false	Add seller profile per unique seller
maxItems	integer	200	Global cap across all queries
proxyConfiguration	object	US Residential	Cloudflare needs a clean residential exit

Example input

{
  "searchQueries": ["pokemon card"],
  "itemStatus": "sold_out",
  "sortBy": "newest",
  "condition": "all",
  "maxItems": 200,
  "includeSeller": true,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }
}

Example output row

{
  "id": "m55314834703",
  "name": "Pikachu Galarian Gallery Crown Zenith Pokemon Card NM",
  "url": "https://www.mercari.com/us/item/m55314834703/",
  "price_usd": 46.0,
  "original_price_usd": 46.0,
  "price_dropped": false,
  "status": "sold_out",
  "num_likes": 28,
  "condition": "Like new",
  "brand": "Pokemon",
  "category_path": "Toys & Collectibles > Trading Cards > Single Cards",
  "seller_id": 154195300,
  "shipping_fee_usd": 4.91,
  "shipping_payer": "Buyer",
  "scraped_at": "2026-09-26T04:00:00Z"
}

Scheduling & webhooks

Use Apify Schedules to run daily/hourly and build a price-history or new-listings feed. Add a webhook on run success to push new rows straight into your database, Google Sheet, or Slack.

Use with AI assistants (MCP)

The dataset is plain JSON, so you can wire this actor into any LLM/agent workflow via the Apify Model Context Protocol (MCP) server — have your assistant pull Mercari sold comps or active listings on demand and reason over the results.

FAQ

Which Mercari does this cover? Mercari US (www.mercari.com). It does not cover Mercari Japan.

Can I get sold prices? Yes — set itemStatus to sold_out. Mercari exposes recently-sold listings with their final price; sort by newest for the freshest comps.

Why a residential proxy? Mercari sits behind a Cloudflare challenge that blocks most datacenter IPs. A US residential proxy (the default) passes it reliably. You can supply your own proxy too.

How fresh is the data? Every row is fetched live at run time (scraped_at records the moment). Schedule the actor for continuous freshness.

How many results per query? Mercari caps a single search at roughly 10,000 results. Narrow with price, condition, brand or category filters to go deeper into a niche.

Is scraping this legal? The actor collects only publicly available listing data. You are responsible for using the output in line with Mercari's terms and applicable law.

Do I get the item description? The title, price, condition, brand, category, likes and photos come from the search feed. Description and shipping cost are detail-only — turn on Enrich with item details to include them (one extra request per listing).