← Marketplace reference

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.

https://api.compsapi.com

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

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 fieldMeaning
list_price, discount_pct, days_on_market, listed_dateOriginal list price, markdown, time to sell and listing date.
seller_kyc_verified, seller_email_verified, seller_phone_verified, seller_facebook_verifiedThe seller's verification standing.
seller_rating, seller_rating_count, seller_items_sold, seller_listings, seller_followers, seller_member_since, seller_cancel_rateThe seller's track record.
ship_from_zipWhere it shipped from.
cartsHow many carts it sat in.
statusThe listing's final state.
extrasbrand, 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.

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