--- title: "Mercari API: JSON data, 3 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/mercari --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Mercari 1 credit per call 3 endpoints 15 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id string | url url | market string | title string | price integer | currency string | status string | condition object | category object | thumbnail url | photos string\[\] | likes integer | listed\_at string | updated\_at string | seller object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | m13838165776 | https://www.mercari.com/us/item/m13838165776/ | us | Nike SB Sticker Nike SB Decal Nike Skateboard Sticker Nike Skateboard Decal | 1 | USD | on\_sale | {2 fields} | {2 fields} | https://u-mercari-images.mercdn.net/photos/m13838165776\_1.jpg?1793207895 | \[1 item\] | 0 | 2026-10-28T17:18:15Z | 2026-10-28T17:18:15Z | {2 fields} | | 2 | m47199620622 | https://www.mercari.com/us/item/m47199620622/ | us | XL Nike Baseball Pants | 1 | USD | on\_sale | {2 fields} | {2 fields} | https://u-mercari-images.mercdn.net/photos/m47199620622\_1.jpg?1732321982 | \[1 item\] | 0 | 2024-11-23T00:33:02Z | 2025-01-08T00:52:46Z | {1 fields} | | 3 | m15817496767 | https://www.mercari.com/us/item/m15817496767/ | us | Nike Sticker Nike Decal . | 1 | USD | on\_sale | {2 fields} | {2 fields} | https://u-mercari-images.mercdn.net/photos/m15817496767\_1.jpg?1794428031 | \[1 item\] | 0 | 2026-11-11T20:13:51Z | 2026-11-11T20:13:51Z | {2 fields} | Recorded from our API · 3 items shown · 15 datapoints per item GET /v1/mercari/search?market=us&query=nike&status=on\_sale&sort=price\_asc&page=1 15 datapoints ### Identity - id string - title string - status string - category object ### Contact - url url - seller object ### Reputation - photos string\[\] ### Price - price integer - currency string ### Other - market string - condition object - thumbnail url - likes integer - listed\_at string - updated\_at string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/mercari/item`](https://perceptlayer.com/apis/mercari/item) | `market` +2 optional | 1 credit | | [GET `/v1/mercari/search`](https://perceptlayer.com/apis/mercari/search) | `market` `status` `page` +11 optional | 1 credit | | [GET `/v1/mercari/seller`](https://perceptlayer.com/apis/mercari/seller) | `market` `id` `status` `page` | 1 credit | Overview ## About the Mercari API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)