Mercari sold data: API reference
Mercari here means the US marketplace, mercari.com: broad resale covering trading cards, electronics, collectibles, clothing and more. source=mercari returns real per sale Mercari sold prices through /v1/sold and /v1/comps, and live Mercari listings through /v1/active.
This page is the technical reference. For coverage, examples and pricing see Mercari on CompsAPI. Parameters, stats, the AI junk filter and errors shared by every source are in the common reference.
GET /v1/sold?source=mercari&q=nintendo+switch+oled&days=30&stats=1&exclude=ai_junk
GET /v1/comps?source=mercari&q=nintendo+switch+oled&exclude=junk,ai_junk
Coverage
- Sold history from November 2025, growing. A
startdate ordaysvalue reaches all of it.
What a Mercari row carries
price is the amount paid, including an accepted offer, and last_sold is the real sale time. Beside the list price and days on market, a row carries the seller's standing where known: whether their identity, email and phone are verified, their rating and rating count, how many items they have sold and how long they have been a member.
Fields in raw
raw field | Meaning |
|---|---|
list_price, discount_pct, days_on_market, listed_date | Original list price, markdown, time to sell and listing date. |
seller_kyc_verified, seller_email_verified, seller_phone_verified, seller_facebook_verified | The seller's verification standing. |
seller_rating, seller_rating_count, seller_items_sold, seller_listings, seller_followers, seller_member_since, seller_cancel_rate | The seller's track record. |
ship_from_zip | Where it shipped from. |
carts | How many carts it sat in. |
status | The listing's final state. |
extras | brand, category and size as names next to their ids (brand_id, category_id, size_id), the condition id and engagement. |
signals carries days_on_market, discount_pct, listed_date and seller with rating, rating_count, items_sold and verified (identity verified).
Every sold row also carries brand, category (the full path, for example Electronics / Video games & consoles / Consoles) and size at the top level, as names, when Mercari gives them.
Parts and accessories
On /v1/comps, and on /v1/sold with stats=1, sales that are parts or accessories of the searched item are flagged accessory and, under the default exclude=junk on /v1/comps, left out. meta.accessory_filter reports the check with the main_category of the search, and exclude=none switches it off. On 21 November 2026 nintendo switch oled had 90 of 390 matches flagged, and the lower quartile moved from about $77 to $155.
Condition labels
condition is one of new, like_new, good, fair or poor, on sold rows and on live listings alike. stats.by_condition shows the labels present for your search.
A sold row
Trimmed for length: null fields and the common fields from the shared reference are left out.
{
"source": "mercari",
"title": "Nintendo Switch OLED",
"price": 241.0,
"last_sold": "2026-11-17T19:14:17Z",
"condition": "new",
"format": "FIXED_PRICE",
"url": "https://www.mercari.com/us/item/m74781942015/",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"signals": {
"days_on_market": 129.8,
"discount_pct": 40.6,
"listed_date": "2026-07-11T00:57:47Z",
"seller": {
"rating": 5.0,
"rating_count": 109,
"items_sold": 103
}
},
"raw": {
"list_price": 406.0,
"status": "trading",
"seller_rating": 5.0,
"seller_rating_count": 109,
"seller_items_sold": 103,
"extras": {
"updated": "2026-11-17T19:14:17+00:00",
"category_id": 797,
"brand_id": 4591,
"condition_id": 1
},
"seller_email_verified": true,
"seller_phone_verified": true,
"seller_facebook_verified": true,
"seller_listings": 109,
"seller_member_since": "2017-09-07T22:32:46+00:00",
"seller_cancel_rate": 0.011235955,
"ship_from_zip": "75024"
}
}
Live listings
GET /v1/active?source=mercari&q= returns what is for sale on Mercari right now for your search, read at the moment you call. Each row is a fixed-price listing; price is the asking price. raw adds the listing date, the original price and discount, brand, category and size as names next to their ids, and likes. seller is Mercari's numeric seller id.
- Sort: best_match, newly_listed, price_asc, price_desc.
source=allincludes this marketplace;live_status.mercaritells you whether its search answered.- Paging: 60 listings by default,
per_pageup to 240, thencursororpage.pagereaches about the first 600 listings, andcursorgoes further.best_matchreturns Mercari's top 300 to 430 matches.newly_listed,price_ascandprice_descgo on through every match. See paging deep. total_activecounts the listings read for this answer.marketplace_totalis Mercari's own count for the search, which stops at 10,000.
A live row from 17 November 2026 (search nintendo switch oled):
{
"item_id": "mercari-m34776430562",
"title": "Nintendo Switch OLED Console - White - As is. For Parts or Repair",
"url": "https://www.mercari.com/us/item/m34776430562/",
"price": 150.0,
"price_max": null,
"currency": "USD",
"shipping": null,
"shipping_text": null,
"format": "BIN",
"bids": null,
"ends_at": null,
"buy_it_now_available": true,
"best_offer_enabled": true,
"quantity_available": null,
"condition": "poor",
"seller": "123456789",
"seller_feedback": null,
"seller_positive_pct": null,
"location": null,
"source": "mercari",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"raw": {
"listed_date": "2026-10-25T03:02:07+00:00",
"updated": "2026-10-25T17:38:43+00:00",
"original_list_price": 170.0,
"discount_pct": 11.8,
"category_id": 797,
"brand_id": 4591,
"size_id": null,
"condition_id": 5,
"likes": null
}
}
The shared parameters and fields are under live listings.
Limits
- Seller fields on some rows. Seller fields are present on the rows where the seller's record is held, and
nullelsewhere. - Broad keywords match lots and accessories.
/v1/compsleaves flagged parts and accessories out by default. Addexclude=junk,ai_junkwhen pricing one item. authenticity.basisisseller_declared. Mercari does not grade or authenticate items, so on a graded card the grade is in the title only.us_saleis an eBay field and isnullhere.