ScavioScavio
Pricing
Tools
Sign InsGet Startedg
11 live endpoints, Mercari US and Mercari Japan

Mercari API

Mercari data as structured JSON: sold listings with the prices they sold at next to the asking prices for the same query, one item in full with its sold time, price drop, shipping and seller, plus categories, brands, deals and trending on Mercari US, and seller ratings, reviews and Mercari Shops on Mercari Japan.

Try Mercari APIRead the docs

50 free credits on signup. No card.

POST /api/v1/mercari/search
sample
query:
try
{  "data": {    "country": "us",    "currency": "USD",    "language": "en",    "query": "nintendo switch",    "status": "sold",    "sort": "recently_sold",    "page": 1,    "page_size": 50,    "max_page": 20,    "total": 10000,    "has_more": true,    "filters": {},    "count": 50,    "items": [      {        "item_id": "m21161095301",        "title": "Mortal Kombat 1 Nintendo Switch Game",        "url": "https://www.mercari.com/us/item/m21161095301/",        "price": 16,        "original_price": null,        "discount_percent": null,        "currency": "USD",        "status": "trading",        "condition": "like_new",        "condition_name": "Like new",        "brand": {          "brand_id": "4591",          "name": "Nintendo"        },        "category_id": "796",        "category": "Games",        "size": null,        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m21161095301_1.jpg?1794670088&width=200&height=200",        "seller_id": "175258609",        "free_shipping": null,        "created_at": "2026-11-14T15:28:08.000Z"      },      "… 49 more (trimmed for preview)"    ],    "notes": [      "status sold returns sold items and items sold but still in transit (status trading). On us, Mercari orders sold results most recently sold first whatever relevance asks, and matches the keyword more loosely than on-sale results (set names, descriptions): price sorts apply; check titles before comparing prices.",      "… 3 more (trimmed for preview)"    ]  },  "response_time": 2401}
captured example · 1 credits3 / 3 free

Live calls against the real endpoints on the Mercari US tabs; the Japan tabs show captured responses (Japan calls typically take 10 to 20 seconds, up to about a minute). 3 free runs across every tab, then it's your own key.

What is the Scavio Mercari API?

The Scavio Mercari API is a REST API that returns Mercari US and Mercari Japan listings, sold prices, item detail, categories, brands and Japan seller ratings and reviews as JSON. Search with status sold returns sold listings with the prices they sold at, and the same query with status on_sale returns the asking prices, so asking and sold prices come from one surface. Every call costs 1 credit.

11
endpoints, all live in production
2
markets: Mercari US (USD, English) and Mercari Japan (JPY, Japanese)
1
credit per call, on every endpoint and market

The Mercari data resellers and price researchers need

What things sell for, what they are listed at, when they sold, whether the price was dropped, and who is selling.

Sold prices next to asking prices

POST /api/v1/mercari/search

status sold returns sold listings with the price they sold at; the same query with status on_sale returns the asking prices. On Mercari US sold results come most recently sold first and match the keyword more loosely, so check titles before comparing prices.

Price drops and when it sold

POST /api/v1/mercari/item

original_price and discount_percent when the seller dropped the price (Mercari US), and sold_at on a sold listing when Mercari shows it; a sold listing keeps its full data. A Coach bag sold for $3,200 after a drop from $5,000 (36%).

Seller ratings and reviews (Japan)

POST /api/v1/mercari/seller

Good, normal and bad rating counts, review count, listings, followers and badges, plus the 100 most recent reviews with text, date and role. One seller read 7,250 good, 1 normal and 1 bad out of 7,252.

Item comments (Japan)

POST /api/v1/mercari/item

The full public comment list of a Mercari Japan item, with text, date and whether the seller wrote it; commenter names are never returned. One trading card lot carried 221 comments and 757 likes.

Mercari Shops

POST /api/v1/mercari/shop

Business sellers inside Mercari Japan search: shops_only on search, is_shop and shop_id on every item, and the shop's profile with rating, reviews and followers.

Deals

POST /api/v1/mercari/deals

Mercari US listings whose price the seller dropped, each with original_price and discount_percent, narrowed by keyword, category or brand.

Trending keywords and brands

POST /api/v1/mercari/trending

What Mercari US lists as trending: 20 keywords with search rank and search volume change, 20 brands with Mercari's demand level and 7-day sold rate.

Categories and brands

POST /api/v1/mercari/categories

Ids for filters: 28,853 US brands and 52,600 in Japan, the US tree one level at a time and Japan's full tree of 8,784 categories in one call.

All 11 Mercari API endpoints

Every route is a POST, returns JSON and takes the same API key. Each call costs 1 credit, in the US and in Japan. A 400 and failed upstream calls are not charged; a not-found is.

EndpointReturnsCredits
Search/api/v1/mercari/searchListings by keyword, on sale or sold (sold includes items in transit; us sold results come most recently sold first), with price, the seller's earlier price and discount (us), condition, brand and seller id; us 50 a page to page 20, jp 120 a page to page 91; us and jp1
Item/api/v1/mercari/itemOne listing, on sale or sold: price, original price, sold_at, condition, shipping, likes, photos and the seller summary; jp adds the full public comment list and Mercari Shops products; us and jp1
Category/api/v1/mercari/categoryThe listings of one category, on sale or sold, sorted and filtered like search; us and jp1
Categories/api/v1/mercari/categoriesThe category tree with ids: us one level at a time, jp the full tree (8,784 categories) or one parent's children; us and jp1
Brands/api/v1/mercari/brandsThe brand list with ids, filtered by name, 1,000 a page: 28,853 brands on us, 52,600 on jp1
Brand/api/v1/mercari/brandThe listings of one brand, on sale or sold, optionally within a category; us and jp1
Deals/api/v1/mercari/dealsListings whose price the seller dropped, with original price and discount percent, by keyword, category or brand; us only1
Trending/api/v1/mercari/trendingMercari's trending keywords (search rank, rank change, search volume change) and brands (demand, 7-day sold rate); us only1
Seller/api/v1/mercari/sellerA seller's public profile: good, normal and bad rating counts, review count, listing count, followers, badges and the first 30 listings; jp only1
Seller reviews/api/v1/mercari/seller-reviewsA user's 100 most recent reviews: rating, text, date and role as seller or buyer, no reviewer names; jp only1
Shop/api/v1/mercari/shopA Mercari Shops shop profile: name, description, rating, review count, followers, open state and badges; jp only1

50 free credits on signup covers 25 asking-vs-sold comparisons (two searches each). See plans

Mercari US and Mercari Japan

One country parameter: us (the default) or jp. Each market has its own listings, ids, currency and language; every answer echoes country, currency and language.

countryMarketPricesLanguageSearch depthEndpointsTypical call
usMercari US (mercari.com)USDEnglish50 a page, up to page 20 (dedupe by item_id)8: search, item, category, categories, brands, brand, deals, trending3 to 20 s
jpMercari Japan (jp.mercari.com)JPY, whole yenJapanese, as sellers wrote it (not translated)120 a page, up to page 919: search, item, category, categories, brands, brand, seller, seller-reviews, shopslower than US: typically 10 to 20 s, up to about a minute

Ids are per market: an item, category, brand or seller id from us is not valid on jp. original_price is never set on jp results, so price drops are a US reading. jp sort newest follows Mercari Japan's own order, in which relisted items move up. Not available: US seller profiles and reviews, search suggestions, trending on jp. Mercari UK closed: gb and uk answer 400, not charged.

What a sold search returns vs an on-sale search

The same search body with status on_sale or status sold, on Mercari US. The two sides answer different questions, so compare prices only between listings of the same item.

Field or behaviorstatus on_sale (the default)status sold
statuson_salesold, or trading (sold, still in transit)
priceThe asking price, in US dollarsThe price it sold at, in US dollars
Order with sort relevanceMercari's best matchMost recently sold first, whatever relevance asks
Price sorts (price_asc, price_desc)ApplyApply
Keyword matchMercari's best match on the keywordLooser: can match set names and descriptions, so check titles
original_price, discount_percentThe seller's earlier price and the drop, when the price was droppedThe same, on the listing as it sold
Sold time and likesNot on result rows: open the itemNot on result rows: open the item for sold_at, when Mercari shows it
free_shippingSet only when the request filters by shippingSet only when the request filters by shipping
totalMercari's own count; 10,000 means 10,000 or moreMercari's own count; 10,000 means 10,000 or more

Narrow both sides with category_id, brand_id, condition or a price range and keep only titles that match the item before comparing prices. Later pages can repeat items from earlier pages (promoted placements): dedupe by item_id.

What a sold listing returns

One sold Mercari US listing read with item on 2026-11-16: a Coach shoulder bag, item m38943035688. A sold listing keeps its full data.

FieldMeaningValue in the capture
priceThe price it sold at, in US dollars3200
original_price, discount_percentThe seller's earlier price and the drop against it5000, 36
status, sold_atsold (trading while in transit) and when it sold, if Mercari shows itsold, 2025-12-13T15:45:53.000Z
price_with_buyer_feeprice plus buyer fees, plus shipping when the buyer pays it3644.24
created_atWhen it was listed2025-12-11T16:55:39.000Z
condition_nameMercari's condition labelLike new
shipping.payer, fee, ships_fromWho pays shipping, the shipping label cost and the US state it shipped frombuyer, 7.97, Texas
likesLikes on the listing21
seller.rating, review_count, sold_countThe seller summary5, 157, 112

Some sold items carry no sold_at, so handle null. Search, category, brand and deals items carry no sold time or likes, and on us no shipping payer (free_shipping is set only when you filter by shipping): open the item for all three. Prices are what Mercari shows on the day; Mercari shows no price history beyond original_price, so poll and store your own readings.

Asking vs sold for the same query

A reseller tool reads the same query with status on_sale and status sold, keeps the titles that match the item, and compares, then opens items for the sold time. The response on the right is a real sold-search capture from Mercari US.

from statistics import median
from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=180)

def matching(items, q):
    # Sold results come most recently sold first and match the keyword loosely
    # (set names, descriptions): keep titles that carry every query word.
    return [i["price"] for i in items if all(w in i["title"].lower() for w in q.split())]

# Asking vs sold for the same query on Mercari US: 2 calls, 1 credit each.
for q in ["coach tabby", "pokemon elite trainer box"]:
    asking = matching(client.mercari.search(query=q, country="us")["data"]["items"], q)
    sold = matching(client.mercari.search(query=q, country="us", status="sold")["data"]["items"], q)
    if asking and sold:
        a, s = median(asking), median(sold)
        print(q, len(asking), "asking", a, len(sold), "sold", s, f"{(s - a) / a:.0%}")
200 response.jsoncaptured
{
  "data": {
    "country": "us",
    "currency": "USD",
    "language": "en",
    "query": "nintendo switch",
    "status": "sold",
    "sort": "recently_sold",
    "page": 1,
    "page_size": 50,
    "max_page": 20,
    "total": 10000,
    "has_more": true,
    "filters": {},
    "count": 50,
    "items": [
      {
        "item_id": "m21161095301",
        "title": "Mortal Kombat 1 Nintendo Switch Game",
        "url": "https://www.mercari.com/us/item/m21161095301/",
        "price": 16,
        "original_price": null,
        "discount_percent": null,
        "currency": "USD",
        "status": "trading",
        "condition": "like_new",
        "condition_name": "Like new",
        "brand": {
          "brand_id": "4591",
          "name": "Nintendo"
        },
        "category_id": "796",
        "category": "Games",
        "size": null,
        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m21161095301_1.jpg?1794670088&width=200&height=200",
        "seller_id": "175258609",
        "free_shipping": null,
        "created_at": "2026-11-14T15:28:08.000Z"
      },
      {
        "item_id": "m31816235781",
        "title": "The Legend of Zelda Breath of the Wild Nintendo Switch Game",
        "url": "https://www.mercari.com/us/item/m31816235781/",
        "price": 30,
        "original_price": 40,
        "discount_percent": 25,
        "currency": "USD",
        "status": "trading",
        "condition": "like_new",
        "condition_name": "Like new",
        "brand": {
          "brand_id": "4591",
          "name": "Nintendo"
        },
        "category_id": "796",
        "category": "Games",
        "size": null,
        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m31816235781_1.jpg?1794369175&width=200&height=200",
        "seller_id": "548956637",
        "free_shipping": null,
        "created_at": "2026-11-11T03:14:17.000Z"
      }
    ],
    "notes": [
      "status sold returns sold items and items sold but still in transit (status trading). On us, Mercari orders sold results most recently sold first whatever relevance asks, and matches the keyword more loosely than on-sale results (set names, descriptions): price sorts apply; check titles before comparing prices.",
      "total is Mercari's own count and stops at 10,000 (10,000 means 10,000 or more); 50 items per page, up to page 20. Later pages can repeat items from earlier pages (promoted placements): dedupe by item_id. Results carry no likes, sold time or shipping payer (free_shipping is set only when you filter by shipping): the item endpoint has all three.",
      "Prices are US dollars. original_price is the seller's earlier listed price when it is above price; discount_percent is computed against it.",
      "Item, category, brand and seller ids are per market: an id from us is not valid on jp."
    ]
  },
  "response_time": 2401
}

Why not an official Mercari API?

Mercari publishes no developer API for listings, sold prices or sellers. Here is where the Scavio API fits.

Mercari

  • No public listing, sold-price or seller API, in the US or Japan
  • The Mercari Shops API is for shop owners managing their own shop
  • Partner integrations by agreement
  • Sold prices shown in its own app and site search

Scavio Mercari API

  • One Scavio key issued at signup, 1 credit per call
  • Sold and on-sale listings for the same query
  • Item detail with sold time, price drop, shipping and seller
  • Mercari US and Mercari Japan through one country parameter
  • Japan seller ratings, reviews, item comments and Mercari Shops
  • The same JSON envelope and key as every other Scavio platform

Mercari's Japan Marketplace GMV was ¥332.0 billion and Mercari US GMV US$194 million in the three months to September 30, 2026, with 4.20 million monthly active users in the US (Mercari, Inc., Q1 FY2027.6 results). Not legal advice.

What developers build with it

Sold comps for resellers

Read the sold listings for what you are about to list, keep the ones whose titles match it, and price from what sold, not from other sellers' asking prices.

search (status sold) + item

Asking vs sold gap

Run the same query on sale and sold and track how far asking prices sit above what sells.

search

Price-drop alerts

Watch deals or a saved search and alert when original_price appears or discount_percent deepens.

deals + search

Black Friday tracking

Read the same searches daily through November 27 and store every reading to see what moved.

search + deals

Japan to US price research

Read the same collectible on Mercari Japan in yen and on Mercari US in dollars, each from its own market.

search on us and jp

Seller checks (Japan)

Read a seller's good, normal and bad ratings and recent reviews before buying or partnering.

seller + seller-reviews

Trend and brand research

Store Mercari's trending keywords and brands daily, then read each brand's sold listings.

trending + brand

Reseller agents and tools

Give an AI agent Mercari as tools: find comps, open an item, check a seller, in one key.

MCP + REST

How to get Mercari sold prices

  1. 1

    Get an API key

    Sign up for a Scavio account and copy your key from the dashboard. You get 50 free credits on signup, with no card.

  2. 2

    Search the sold listings

    Send {"query": "coach tabby", "country": "us", "status": "sold"} to https://api.scavio.dev/api/v1/mercari/search with an Authorization: Bearer header. Each item carries the price it sold at; status sold includes items still in transit and comes most recently sold first.

  3. 3

    Read the asking prices

    Send the same body with "status": "on_sale" (the default). Sold results match the keyword more loosely, so keep the titles that match the item on both sides before comparing, and narrow both with category_id, brand_id, condition or a price range.

  4. 4

    Open an item and store each reading

    Send an item_id to /api/v1/mercari/item for sold_at (when Mercari shows it), the earlier price, shipping and the seller. Poll on a schedule and store price, status, sold_at and fetched_at: your readings are the history.

One key, 55 platformsMCP server for agentsPython & JS SDKsn8n community node

Mercari API FAQ

Does Mercari have a public API?

+

No. Mercari publishes no public listing, sold-price or seller API for Mercari US or Mercari Japan. Mercari Shops has an API for shop owners to manage their own products and orders; it is not a marketplace data API. The Scavio Mercari API is a separate option: 11 POST endpoints on one API key. Other vendors also sell Mercari data.

How do I get Mercari sold prices?

+

Send search with status sold. It returns sold listings, including items sold and still in transit (status trading), each with the price it sold at, 50 a page on Mercari US. On Mercari US, sold results come most recently sold first whatever relevance asks (price_asc and price_desc apply) and match the keyword more loosely than on-sale results, so check titles before comparing prices. Mercari Search API docs

What is the gap between asking and sold prices on Mercari?

+

Read the same query with status on_sale and with status sold, then compare only listings of the same item. On Mercari US the sold side comes most recently sold first and matches the keyword more loosely (set names, descriptions), while the on-sale side is Mercari's best match, so narrow both with category_id, brand_id, condition or a price range and keep the titles that match before you compare. Measure your own queries.

Does it return when a Mercari item sold?

+

Yes, on the item endpoint: sold_at on a sold listing when Mercari shows it (some sold items carry none), and the listing keeps its full data (price, condition, shipping, photos, seller). Search, category, brand and deals items carry no sold time or likes, so open the item for those. Mercari Item API docs

How do I see Mercari price drops?

+

original_price is the seller's earlier price when it is above the current price, and discount_percent is computed against it, on every Mercari US grid item and on item; Mercari Japan results never carry it. deals lists Mercari US listings whose price the seller dropped. It is the one earlier price Mercari shows, not a price history: poll and store your own readings for a series. Mercari Deals API docs

Does it cover Mercari Japan?

+

Yes. country jp reads Mercari Japan: search, item, category, categories, brands and brand, plus seller profiles, seller reviews and Mercari Shops shops. Titles, descriptions, comments and reviews come in Japanese as sellers wrote them, not translated, and prices in whole yen. Japan calls are slower than US: typically 10 to 20 seconds, up to about a minute.

Are Mercari ids the same in the US and Japan?

+

No. Item, category, brand and seller ids are per market: an id read on us is not valid on jp and answers a not-found (charged). Read ids from an answer of the same market, for example brands on jp before brand on jp.

Can I read a Mercari seller's ratings and reviews?

+

On Mercari Japan, yes: seller returns the good, normal and bad rating counts, review count, listings count, followers, badges and the first 30 listings, and seller-reviews the 100 most recent reviews with rating, text, date and whether the user was the seller or the buyer. Reviewer names are never returned. US seller profiles and US seller reviews are not available; every US item still carries the seller's rating, review count and sold count. Mercari Seller Reviews API docs

Does it return Mercari item comments?

+

On Mercari Japan, item returns the full public comment list with text, date and whether the seller wrote it; who wrote each comment is not returned. One trading card lot read on 2026-11-16 carried 221 comments. US items return no comments.

What about Mercari Shops?

+

Mercari Shops are business sellers inside Mercari Japan. search takes shops_only, every Japan item carries is_shop and shop_id, item reads a Shops product by its 22-character id (with some of the shop's other products), and shop returns the shop's profile with rating, reviews and followers. shop has no product list. Mercari Shop API docs

How many results can a Mercari search return?

+

Mercari US: 50 a page up to page 20; later pages can repeat items from earlier pages (promoted placements), so dedupe by item_id. Mercari Japan: 120 a page up to page 91. total is Mercari's own count and stops at 10,000 on us and 15,000 on jp, where the cap means that many or more. Split a large query by category, brand, condition or price range to reach more.

What does Mercari trending return?

+

What Mercari US lists as trending, on the day you call: 20 keywords with their search rank, rank change, search volume change in percent and trend, and 20 brands with Mercari's demand level, demand change, 7-day sold rate and a few recent listings. trending is Mercari US only. Mercari Trending API docs

What do Mercari's terms say?

+

Mercari US's Prohibited Conduct policy says you may not use any robot, spider, crawler, scraper or other automated means not provided by Mercari to access the service or to extract data, and Mercari's global platform terms prohibit gathering the platform with a bot or scraper. We do not interpret them for you: read the current terms for your market and use case. You are responsible for your own compliance. This is not legal advice.

How much does a Mercari request cost?

+

1 credit per call on every endpoint, in the US and in Japan. New accounts get 50 free credits on signup, one time and with no card. Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth credits cost $1 per 1,000. A 400 and a failed upstream call are not charged; a not-found is charged.

How fresh is the data, and what does it not return?

+

Every request reads Mercari when you call it and carries fetched_at; nothing is cached. US calls usually take 3 to 20 seconds; set a client timeout of 180 seconds. Not returned: US seller profiles and reviews, search suggestions, trending on Japan, price history beyond original_price, buying, offers or messaging, and Mercari UK, which closed.

Explore more of Scavio

Best Mercari sold listings APIs

Seven options priced, plus 27 searches read both ways: sold prices ran a median 19% below asking.

How to get Mercari sold prices

Sold and on-sale search, sold_at per item, trending, Mercari Japan seller ratings and a daily Black Friday poll, step by step.

Why isn't anything selling on Mercari?

32 searches sold and unsold: 73% of sold listings had cut their price, 49% of unsold ones had.

Vinted API

Second-hand listings, the Vinted fee, sold state and seller ratings on 27 sites.

eBay API

Live eBay prices, listings and sellers.

TCGplayer API

Trading card prices, listings and sales.

OLX API

Classified listings in their own currency across OLX markets.

ASOS API

One product's price in every ASOS country and currency.

Amazon API

Search, product and offers across 22 marketplaces.

Mercari API docs

All 11 endpoints with params and real responses.

Start reading Mercari sold prices

50 free credits on signup, no card. One key for Mercari and every other Scavio platform.

Get your API keySee pricing
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy