Mercari: Search

Search from Mercari as JSON. 1 credit per successful call.

GET /v1/mercari/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`market`	string	Required	us, jp
`query`	string	Optional	Up to 200 characters
`category`	string	Optional	Any
`brand`	string	Optional	Any
`size`	string	Optional	Any
`color`	string	Optional	Any
`condition`	string	Optional	Any
`min_price`	number	Optional	Any
`max_price`	number	Optional	Any
`status`	string	Required	on_sale, sold
`sort`	string	Optional	relevance, price_asc, price_desc, newest
`shipping_payer`	string	Optional	buyer, seller
`seller`	integer	Optional	Any
`page`	integer	Required	Any

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.