---
title: "Mercari API: Search | Perceptlayer"
description: "Search from Mercari as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/mercari/search
---

[APIs](https://perceptlayer.com/apis) / [Mercari](https://perceptlayer.com/apis/mercari) / Search

# 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/mercari?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.