Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Mercari

1 credit per call3 endpoints15 datapoints

Mercari API

Mercari API for US and Japan listing search, sold items, item details and seller listings as JSON, with price and condition. 1 credit per successful call.

Get a free API keyRun it below
Mercari
GET/v1/mercari/search?market=us&query=nike&status=on_sale&sort=price_asc&page=1
{
  "success": true,
  "data": {
    "market": "us",
    "query": "nike",
    "page": 1,
    "per_page": 30,
    "total": 10000,
    "total_is_capped": true,
    "has_next": true,
    "items": [
      {
        "id": "m13838165776",
        "url": "https://www.mercari.com/us/item/m13838165776/",
        "market": "us",
        "title": "Nike SB Sticker Nike SB Decal Nike Skateboard Sticker Nike Skateboard Decal",
        "price": 1,
        "currency": "USD",
        "status": "on_sale",
        "condition": {
          "id": 1,
          "name": "New"
        },
        "category": {
          "id": 3509,
          "name": "Single Cards"
        },
        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m13838165776_1.jpg?1793207895",
        "photos": [
          "https://u-mercari-images.mercdn.net/photos/m13838165776_1.jpg?1793207895"
        ],
        "likes": 0,
        "listed_at": "2026-10-28T17:18:15Z",
        "updated_at": "2026-10-28T17:18:15Z",
        "seller": {
          "id": 135282760,
          "rating_count": 12574
        }
      },
      {
        "id": "m47199620622",
        "url": "https://www.mercari.com/us/item/m47199620622/",
        "market": "us",
        "title": "XL Nike Baseball Pants",
        "price": 1,
        "currency": "USD",
        "status": "on_sale",
        "condition": {
          "id": 3,
          "name": "Good"
        },
        "brand": {
          "id": 4578,
          "name": "Nike"
        },
        "size": {
          "id": 12,
          "name": "XL (46-48)"
        },
        "category": {
          "id": 379,
          "name": "Pants"
        },
        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m47199620622_1.jpg?1732321982",
        "photos": [
          "https://u-mercari-images.mercdn.net/photos/m47199620622_1.jpg?1732321982"
        ],
        "likes": 0,
        "listed_at": "2024-11-23T00:33:02Z",
        "updated_at": "2025-01-08T00:52:46Z",
        "seller": {
          "id": 313288575
        }
      },
      {
        "id": "m15817496767",
        "url": "https://www.mercari.com/us/item/m15817496767/",
        "market": "us",
        "title": "Nike Sticker Nike Decal .",
        "price": 1,
        "currency": "USD",
        "status": "on_sale",
        "condition": {
          "id": 1,
          "name": "New"
        },
        "category": {
          "id": 3509,
          "name": "Single Cards"
        },
        "thumbnail": "https://u-mercari-images.mercdn.net/photos/m15817496767_1.jpg?1794428031",
        "photos": [
          "https://u-mercari-images.mercdn.net/photos/m15817496767_1.jpg?1794428031"
        ],
        "likes": 0,
        "listed_at": "2026-11-11T20:13:51Z",
        "updated_at": "2026-11-11T20:13:51Z",
        "seller": {
          "id": 135282760,
          "rating_count": 12574
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_c24faa329fe84022b281884ff8a7bad0",
    "credits_charged": 1,
    "credits_remaining": 1921
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringurlurlmarketstringtitlestringpriceintegercurrencystringstatusstringconditionobjectcategoryobjectthumbnailurlphotosstring[]likesintegerlisted_atstringupdated_atstringsellerobject
1m13838165776https://www.mercari.com/us/item/m13838165776/usNike SB Sticker Nike SB Decal Nike Skateboard Sticker Nike Skateboard Decal1USDon_sale{2 fields}{2 fields}https://u-mercari-images.mercdn.net/photos/m13838165776_1.jpg?1793207895[1 item]02026-10-28T17:18:15Z2026-10-28T17:18:15Z{2 fields}
2m47199620622https://www.mercari.com/us/item/m47199620622/usXL Nike Baseball Pants1USDon_sale{2 fields}{2 fields}https://u-mercari-images.mercdn.net/photos/m47199620622_1.jpg?1732321982[1 item]02024-11-23T00:33:02Z2025-01-08T00:52:46Z{1 fields}
3m15817496767https://www.mercari.com/us/item/m15817496767/usNike Sticker Nike Decal .1USDon_sale{2 fields}{2 fields}https://u-mercari-images.mercdn.net/photos/m15817496767_1.jpg?1794428031[1 item]02026-11-11T20:13:51Z2026-11-11T20:13:51Z{2 fields}

Recorded from our API · 3 items shown · 15 datapoints per itemGET /v1/mercari/search?market=us&query=nike&status=on_sale&sort=price_asc&page=1

15 datapoints

Identity

  • idstring
  • titlestring
  • statusstring
  • categoryobject

Contact

  • urlurl
  • sellerobject

Reputation

  • photosstring[]

Price

  • priceinteger
  • currencystring

Other

  • marketstring
  • conditionobject
  • thumbnailurl
  • likesinteger
  • listed_atstring
  • updated_atstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/mercari/search?market=us&query=nike&status=on_sale&sort=price_asc&page=1" \
  -H "X-API-Key: $API_KEY"

Mercari · 3 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/mercari/item
market+2 optional
1 credit
GET/v1/mercari/search
marketstatuspage+11 optional
1 credit
GET/v1/mercari/seller
marketidstatuspage
1 credit

Overview

What you can get

The Mercari API returns Mercari marketplace data as JSON through 3 endpoints. Each takes a market of us or jp.

  • Search: search takes a status (on_sale or sold) and a page, with query, category, brand, size, color, condition, min_price, max_price, shipping_payer (buyer or seller), seller and sort (relevance, price_asc, price_desc or newest).
  • Items: item takes an id or a url.
  • Sellers: seller takes a seller id, a status (on_sale or sold) and a page.

The recorded search for "nike" in the us market, on sale and sorted by price_asc, returns items, each with id, url, title, price, currency, status, condition, category, thumbnail, photos, likes, listed_at, updated_at and seller (with id and rating_count). It also returns page, per_page, total, total_is_capped and has_next.

How a call works

Search a market: GET /v1/mercari/search?market=us&query=nike&status=on_sale&sort=price_asc&page=1 with your key in the X-API-Key header. Each result carries an id, which item takes, and a seller with an id, which seller takes to list that seller's on-sale or sold items. Check has_next before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track what an item sold for with `status=sold`

Use the Mercari API to track what an item sold for with `status=sold`

Compare asking prices for a brand or query in the US and Japan markets

Use the Mercari API to compare asking prices for a brand or query in the US and Japan markets

Watch new listings for a query with `sort=newest`

Use the Mercari API to watch new listings for a query with `sort=newest`

Follow a seller's on-sale and sold items

Use the Mercari API to follow a seller's on-sale and sold items

FAQ

Questions

How much does the Mercari API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I get sold listings?

Yes. Pass `status=sold` to `search` or `seller`.

Do I need a Mercari account?

No. You call this Mercari API with your Perceptlayer key in the `X-API-Key` header, with no Mercari login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Mercari scraper instead?

You can, but a Mercari scraper is code you maintain: page changes break it, requests get blocked, and Mercari's terms govern how you collect data. The Mercari API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Mercari API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs