ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Blog
Mercari12 min readNov 16, 2026

How to Get Mercari Sold Prices With an API: Sold and On-Sale Listings, Item Detail and Seller Ratings From Mercari US and Mercari Japan

Get Mercari sold prices with Scavio's Mercari API: search sold and on-sale listings for one query, read sold_at and price drops per item, then poll it daily.

Scavio Team

Nov 16, 2026

Try the Mercari API free
scavio
Resale / Sold prices
Mercari

To get Mercari sold prices, call Scavio's Mercari API: POST /api/v1/mercari/search with a query and "status": "sold" returns sold listings with the price they sold at, and the same query with "status": "on_sale" returns what sellers are asking. Then POST /api/v1/mercari/item on a sold listing adds sold_at, the seller's earlier price, shipping and likes. Every endpoint costs 1 credit and works on Mercari US in dollars; search, item, category and brand also work on Mercari Japan in yen.

A Mercari sold price is the price a sold listing still shows. Mercari keeps sold listings searchable, but its search answers one status at a time and has no history view, so the work is: search sold, search on sale, read the items you care about, and store what you read each day. Every response below is a trimmed capture from Scavio's Mercari API on November 16, 2026, between 17:57 and 18:31 UTC. US prices are numbers in dollars, Japanese prices whole yen. Long fields, photos and seller names are cut from every sample.

Step 1: Search sold listings

Bash
curl -s https://api.scavio.dev/api/v1/mercari/search \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "airpods pro 2", "country": "us", "status": "sold"}'
JSON
{
  "country": "us",
  "currency": "USD",
  "language": "en",
  "query": "airpods pro 2",
  "status": "sold",
  "sort": "relevance",
  "page": 1,
  "page_size": 50,
  "max_page": 20,
  "total": 3173,
  "has_more": true,
  "count": 50,
  "items": [
    {
      "item_id": "m33208155815",
      "title": "White AirPods Pro 2 Charging Case and Left Bud - Used",
      "url": "https://www.mercari.com/us/item/m33208155815/",
      "price": 30.01,
      "original_price": 35,
      "discount_percent": 14,
      "currency": "USD",
      "status": "trading",
      "condition": "fair",
      "condition_name": "Fair",
      "brand": { "brand_id": "319", "name": "Apple" },
      "category_id": "1594",
      "category": "Bluetooth Headphones",
      "seller_id": "318635603",
      "created_at": "2026-09-27T01:12:05.000Z"
    },
    {
      "item_id": "m16515369365",
      "title": "AirPods Pro 2",
      "url": "https://www.mercari.com/us/item/m16515369365/",
      "price": 72,
      "original_price": 80,
      "discount_percent": 10,
      "currency": "USD",
      "status": "trading",
      "condition": "new",
      "condition_name": "New",
      "brand": { "brand_id": "319", "name": "Apple" },
      "category_id": "1594",
      "category": "Bluetooth Headphones",
      "seller_id": "383557495",
      "created_at": "2026-11-15T19:18:46.000Z"
    }
  ]
}

status is trading for a listing that sold and is still in transit, sold once the sale completed; a sold search returns both. original_price and discount_percent appear when the seller had dropped the price; price is the price it sold at. total is Mercari's own count, capped at 10,000 on the US site, so 10,000 means "10,000 or more". Pages hold 50 listings up to page 20 on US; has_more says whether to ask for the next page.

Two things to know before you take a median. On Mercari US, sold results come most recently sold first whatever the sort, and the keyword matches more loosely than on the on-sale side: the first sold result above is a charging case and one earbud. And results carry no likes or sold time; step 2 has both. Filters work on both sides: price_min and price_max in dollars, condition (new, like_new, good, fair, poor), category_id, brand_id, shipping and deals_only. It answered in 2.6 seconds. 1 credit.

Step 2: Read one sold item for sold_at and the price history Mercari shows

Bash
curl -s https://api.scavio.dev/api/v1/mercari/item \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id": "m24125705898", "country": "us"}'
JSON
{
  "country": "us",
  "currency": "USD",
  "item_id": "m24125705898",
  "title": "AirPods Pro 2 with USB-C",
  "url": "https://www.mercari.com/us/item/m24125705898/",
  "price": 78,
  "original_price": null,
  "discount_percent": null,
  "price_with_buyer_fee": 88.6,
  "status": "trading",
  "sold_at": "2026-11-12T21:42:21.000Z",
  "condition": "new",
  "condition_name": "New",
  "brand": { "brand_id": "319", "name": "Apple" },
  "category": {
    "category_id": "1594",
    "name": "Bluetooth Headphones",
    "path": [
      { "category_id": "7", "name": "Electronics" },
      { "category_id": "1593", "name": "Headphones & MP3 Players" },
      { "category_id": "1594", "name": "Bluetooth Headphones" }
    ]
  },
  "shipping": {
    "payer": "seller",
    "service": "USPS Ground Advantage",
    "fee": 7.99,
    "days_to_ship": "1 - 7 days",
    "ships_from": "Texas"
  },
  "likes": 3,
  "in_carts": 1,
  "offers_allowed": false,
  "created_at": "2026-11-12T09:36:21.000Z",
  "updated_at": "2026-11-12T21:42:21.000Z",
  "seller": {
    "seller_id": "972887224",
    "rating": 0,
    "review_count": 0,
    "listings_count": 4,
    "sold_count": 0,
    "joined": "2025-11-14T03:32:16.000Z",
    "badges": ["id_verified", "phone_verified", "email_verified"]
  }
}

This pair of new AirPods Pro 2 was listed at 09:36 UTC on November 12 and sold at 21:42 the same day for $78. A sold listing keeps its full data: description, photos, condition, category path, likes and the seller summary. sold_at is there when Mercari shows it: 14 of the 16 sold items we read had it. Of those 14, the time from created_at to sold_at ran from 0.3 to 175.8 days, a median of 17.9 days; that is 14 items, not a rate. price_with_buyer_fee is the price plus the buyer's fees, and plus shipping when the buyer pays it; shipping.fee is the label cost, paid by shipping.payer. An unknown or deleted id answers 404 and is charged. It answered in 2.9 seconds. 1 credit.

Step 3: Search the same query on sale

Bash
curl -s https://api.scavio.dev/api/v1/mercari/search \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "airpods pro 2", "country": "us", "status": "on_sale"}'
JSON
{
  "country": "us",
  "currency": "USD",
  "query": "airpods pro 2",
  "status": "on_sale",
  "sort": "relevance",
  "page": 1,
  "page_size": 50,
  "total": 8992,
  "has_more": true,
  "count": 50,
  "items": [
    {
      "item_id": "m80617070671",
      "title": "Apple AirPods Pro 2 ( 2nd Generation)",
      "url": "https://www.mercari.com/us/item/m80617070671/",
      "price": 52.25,
      "original_price": 55,
      "discount_percent": 5,
      "currency": "USD",
      "status": "on_sale",
      "condition": "good",
      "condition_name": "Good",
      "brand": { "brand_id": "319", "name": "Apple" },
      "category_id": "1594",
      "category": "Bluetooth Headphones",
      "seller_id": "933246025",
      "created_at": "2026-11-15T03:14:04.000Z"
    },
    {
      "item_id": "m93531179562",
      "title": "AirPods Pro 2",
      "url": "https://www.mercari.com/us/item/m93531179562/",
      "price": 60,
      "original_price": null,
      "discount_percent": null,
      "currency": "USD",
      "status": "on_sale",
      "condition": "new",
      "condition_name": "New",
      "brand": { "brand_id": "319", "name": "Apple" },
      "category_id": "1594",
      "category": "Bluetooth Headphones",
      "seller_id": "602252358",
      "created_at": "2026-10-21T03:22:58.000Z"
    }
  ]
}

8,992 on sale against 3,173 sold for this query, by Mercari's counts. On-sale results sort by relevance unless you ask for newest, price_asc or price_desc. Page 2 of an on-sale search repeated 2 to 16 page-1 listings in each of the 32 searches we ran, so dedupe by item_id before you count. It answered in 4.9 seconds. 1 credit.

Step 4: Compare asking and sold prices

Python
import re, statistics, requests

API = "https://api.scavio.dev/api/v1/mercari"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
SKIP = re.compile(r"\b(lot|bundle|case|cover|skin|charger|replacement|empty box|box only|parts|read|sticker|stand|grip|dock only|controller only|for parts|broken|cracked|holder|strap|band|pouch|keychain|tips)\b", re.I)

def listings(query, status, pages=2):  # 1 credit per page
    seen = {}
    for page in range(1, pages + 1):
        d = requests.post(f"{API}/search", headers=HEADERS, timeout=120,
                          json={"query": query, "country": "us", "status": status, "page": page}).json()["data"]
        for item in d["items"]:
            seen.setdefault(item["item_id"], item)  # page 2 repeats some page-1 listings
        if not d["has_more"]:
            break
    words = query.lower().split()
    return [i for i in seen.values() if all(w in i["title"].lower() for w in words) and not SKIP.search(i["title"])]

query = "airpods pro 2"
asking, sold = listings(query, "on_sale"), listings(query, "sold")
a = statistics.median(i["price"] for i in asking)
s = statistics.median(i["price"] for i in sold)
print(f"{query}: asking {a} ({len(asking)}), sold {s} ({len(sold)}), {(s / a - 1) * 100:+.1f}%")

On November 16 this rule kept 30 on-sale and 21 sold listings for "airpods pro 2": a median asking price of $75.50, a median sold price of $58.48, 22.5% below. Over the 27 searches with at least 20 kept listings on each side, sold ran a median 18.8% below asking, and below on 23 of 27; the best Mercari sold listings APIs has the full table. The rule is crude on purpose: it is the same on both sides, and you can see what it drops. Tighten it per product (a model number, a size) when you price one thing. 4 credits for two pages a side.

Step 5: See what is trending, with 7-day sold rates

Bash
curl -s https://api.scavio.dev/api/v1/mercari/trending \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "us"}'
JSON
{
  "country": "us",
  "count": 40,
  "keywords": [
    { "position": 1, "keyword": "starbucks christmas tree cup", "search_rank": 75, "rank_change": 177995, "search_volume_change_percent": 16380, "trend": "trending_up" },
    { "position": 2, "keyword": "starbucks christmas tree", "search_rank": 466, "rank_change": 95616, "search_volume_change_percent": 3555.56, "trend": "trending_up" }
  ],
  "brands": [
    {
      "position": 1,
      "brand_id": "5292",
      "name": "Rainbow",
      "demand": "very_high",
      "demand_change": 1.3,
      "sold_rate_7d": 0.18874172185430463,
      "recent_listings": [
        { "item_id": "m93599479174", "title": "Women's Pride Rainbow Chevron Halter Bikini Swim Top Size L NWT", "url": "https://www.mercari.com/us/item/m93599479174/" }
      ]
    }
  ]
}

Trending returns Mercari's 20 trending keywords and 20 trending brands as its trending page lists them. sold_rate_7d is a fraction: Rainbow's 0.1887 is 18.9%, the highest of the 20 brands on November 16, ahead of ALOHA Collection (17.9%), Walmart (12.8%) and Target (12.0%). A brand id goes straight into brand_id on brand or search. Trending is US only. It answered in 6.6 seconds. 1 credit.

Step 6: Do the same on Mercari Japan, with seller ratings

Bash
curl -s https://api.scavio.dev/api/v1/mercari/search \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "SONY α7 III", "country": "jp", "status": "sold"}'
JSON
{
  "country": "jp",
  "currency": "JPY",
  "language": "ja",
  "query": "SONY α7 III",
  "status": "sold",
  "page": 1,
  "page_size": 120,
  "max_page": 91,
  "total": 1210,
  "has_more": true,
  "count": 120,
  "items": [
    {
      "item_id": "m94510700413",
      "title": "Sony α7Riii + FE 24-70mm F4 + 64GB SDカード",
      "url": "https://jp.mercari.com/item/m94510700413",
      "price": 214999,
      "original_price": null,
      "currency": "JPY",
      "status": "sold",
      "condition": "fair",
      "condition_name": "やや傷や汚れあり",
      "brand": { "brand_id": "3285", "name": "SONY" },
      "category_id": "8724",
      "seller_id": "600491336",
      "is_shop": false,
      "free_shipping": true,
      "is_auction": false,
      "created_at": "2025-01-20T04:31:11.000Z",
      "updated_at": "2025-01-27T10:45:01.000Z"
    },
    {
      "item_id": "m16588306471",
      "title": "【動作確認済】SONY α7III ボディ ミラーレス一眼",
      "url": "https://jp.mercari.com/item/m16588306471",
      "price": 98600,
      "original_price": null,
      "currency": "JPY",
      "status": "sold",
      "condition": "good",
      "condition_name": "目立った傷や汚れなし",
      "brand": { "brand_id": "3285", "name": "SONY" },
      "category_id": "4006",
      "seller_id": "374617692",
      "is_shop": false,
      "free_shipping": true,
      "is_auction": false,
      "created_at": "2026-11-10T09:06:36.000Z",
      "updated_at": "2026-11-16T00:04:17.000Z"
    }
  ]
}

Mercari Japan pages hold 120 listings up to page 91, prices are whole yen, and titles are what sellers wrote. Matching is loose here too: the first result of this search was an α7R III with a lens, a different camera, sold in January 2025. Counting only titles that name the α7 III (not the α7R III) and dropping sets, batteries, cases and parts, 56 sold listings had a median of ¥111,500 and 43 on-sale listings ¥130,000; at the ECB reference rates of November 16, 2026 (USD 1.1014 and JPY 175.78 per euro, so about ¥159.60 to the dollar) the sold median is about $699, against $900 for 13 sold US listings. Japanese answers took 10 to 19 seconds in our runs. 1 credit.

The seller_id goes to seller and seller reviews, Japan only:

Bash
curl -s https://api.scavio.dev/api/v1/mercari/seller-reviews \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller_id": "374617692", "country": "jp"}'
JSON
{
  "country": "jp",
  "seller_id": "374617692",
  "summary": {
    "rating": 4.5,
    "ratings": { "good": 86, "normal": 0, "bad": 2 },
    "review_count": 88
  },
  "reviews": [
    { "rating": "good", "text": "この度はお取引ありがとうございました。また機会がありましたらよろしくお願いします。", "date": "2026-10-31T15:00:00.000Z", "role": "seller" },
    { "rating": "good", "text": "この度はお取引ありがとうございました!", "date": "2026-09-30T15:00:00.000Z", "role": "buyer" }
  ],
  "has_more": false
}

This seller had 86 good, 0 normal and 2 bad ratings over 88 reviews, all 88 returned in one call, dated to the month; role says whether the user was the seller or the buyer in that trade, and who wrote each review is never returned. Seller adds listing count, followers, badges such as 24-hour shipping, and the first 30 listings with status and likes. US seller profiles and US reviews are not available. 1 credit each.

Step 7: Poll daily through Black Friday and keep the rows

Nothing in a response gives yesterday's sold prices, so the series is what you store. This reads two pages a side for each search once a day and appends every row:

Python
import csv, datetime, requests

API = "https://api.scavio.dev/api/v1/mercari"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
SEARCHES = ["airpods pro 2", "stanley quencher 40 oz", "jordan 4", "coach tabby", "lego star wars"]
FIELDS = ["captured_at", "query", "status", "item_id", "title", "price", "original_price", "condition", "brand_id", "category_id", "seller_id", "created_at"]

today = datetime.date.today().isoformat()
with open("mercari_daily.csv", "a", newline="") as f:
    w = csv.DictWriter(f, fieldnames=FIELDS)
    for query in SEARCHES:
        for status in ("on_sale", "sold"):
            seen = set()
            for page in (1, 2):  # 1 credit per page
                d = requests.post(f"{API}/search", headers=HEADERS, timeout=120,
                                  json={"query": query, "country": "us", "status": status, "page": page}).json()["data"]
                for i in d["items"]:
                    if i["item_id"] in seen:
                        continue
                    seen.add(i["item_id"])
                    w.writerow({"captured_at": today, "query": query, "status": status, "item_id": i["item_id"],
                                "title": i["title"], "price": i["price"], "original_price": i["original_price"],
                                "condition": i["condition"], "brand_id": (i["brand"] or {}).get("brand_id"),
                                "category_id": i["category_id"], "seller_id": i["seller_id"], "created_at": i["created_at"]})

Each search is 4 credits a day, so 5 searches are 20 credits a day and 30 searches 120. Run it from November 26 to November 30, around Black Friday on November 27, and 30 searches cost 600 credits, $0.60 at the Growth rate of $1 per 1,000 credits; the Hobby plan, $15 a month for 3,000 credits, covers it with room for item calls. A listing seen on sale one day and sold the next is a sale you saw happen, at the price you saw.

All 11 Mercari endpoints

EndpointWhat it returnsMarketsCredits
searchListings by keyword, on sale or sold, with price, earlier price, condition, brand and seller idUS, Japan1
itemOne listing with sold_at, price drop, shipping, likes, photos and seller; Japan adds comments and Mercari ShopsUS, Japan1
categoryListings of one category, on sale or soldUS, Japan1
categoriesCategory ids: US one level at a time, Japan the full treeUS, Japan1
brandsBrand ids filtered by name, 1,000 a pageUS, Japan1
brandListings of one brand, on sale or soldUS, Japan1
dealsListings on Mercari's deals filter with the earlier priceUS1
trendingTrending keywords and brands with 7-day sold ratesUS1
sellerRatings, listing count, badges and first 30 listingsJapan1
seller-reviewsThe 100 most recent reviews with rating, text, date and roleJapan1
shopA Mercari Shops shop profileJapan1

A not-found is charged; an upstream failure is not. Mercari UK closed, so gb and uk answer 400 before anything is charged.

Getting started

  1. Create a free Scavio account: 50 credits, no card, enough for 12 searches read both ways on two pages.
  2. Run a sold search in the playground, then the same query on sale.
  3. Filter titles, dedupe by item_id, and compare medians as in step 4.
  4. Call item on the sold listings you care about for sold_at and the earlier price.
  5. Schedule step 7 and keep the CSV; for agents, the same endpoints are tools in the Scavio MCP server.

Reference: Mercari API overview · search docs · item docs · the best Mercari sold listings APIs · why isn't anything selling on Mercari? · how to get Vinted listing data · eBay sold listings now require a login

Frequently asked questions

Can you see what something sold for on Mercari?

Yes. A sold Mercari listing keeps its price, and Mercari's search has a sold filter. With Scavio's Mercari API, POST /api/v1/mercari/search with a query and "status": "sold" returns sold listings with the price, condition, brand and the seller's earlier price where they dropped it, 50 a page on Mercari US and 120 on Mercari Japan, 1 credit a call.

Does Mercari show the sold date?

Search results carry no sold time. The item answer for a sold US listing has sold_at when Mercari shows it: 14 of the 16 sold US items we read on November 16, 2026, had it. On Mercari Japan, updated_at on a sold listing is close to the sale. Keep your own capture date as well.

Why does a Mercari sold search return items that don't match my search?

On Mercari US, sold results come most recently sold first and match the keyword more loosely than on-sale results: for 'pokemon scarlet' on November 16, 2026, 93% of on-sale titles had both words and 11% of sold titles did. Filter titles on your side, for example keep only titles with every word of the query and drop lots and accessories, before you take a median.

Is Mercari Japan's data in English?

No. Mercari Japan answers come in yen with titles and descriptions as sellers wrote them, mostly in Japanese; Scavio does not translate them. Japanese keywords match best. A few sellers write titles in Latin letters, such as 'SONY α7III ILCE-7M3'. Item, category, brand and seller ids are per market, so a US id is not valid on Japan.

Do Mercari's terms allow automated collection?

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. This is not legal advice; read the current terms for your market and use case.

Read Mercari sold prices with one call

  • Sold and on-sale search for the same query, 50 a page on US
  • sold_at, price drops, shipping and the seller on every item
  • Mercari Japan in yen, with seller ratings and reviews
Try the Mercari API free

50 free credits, no credit card

On this page

  1. Step 1: Search sold listings
  2. Step 2: Read one sold item for soldat and the price history Mercari shows
  3. Step 3: Search the same query on sale
  4. Step 4: Compare asking and sold prices

Related articles

View all
  • scavio
    Resale / Marketplace
    Mercari
    7 Best Mercari Sold Listings APIs in 2026: Scavio Priced 27 Mercari Searches Both Ways, and Sold Prices Ran a Median 19% Below Asking
  • scavio
    Resale / Sold prices
    Mercari
    Why Isn't Anything Selling on Mercari? We Read 32 Searches Sold and Unsold: 73% of Sold Listings Had Cut Their Price, 49% of Unsold Ones Had
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