+Mercari API
Search Mercari US and Mercari Japan listings, items and sellers, and get clean JSON back.
The API.SH Mercari API reads public listings from mercari.com and jp.mercari.com. Search with the site's own filters (sort, on sale or sold, price range, condition, category, brand, shipping, color and size), open an item for its full description, photos, condition, shipping and seller, read a seller's profile and listings, pull Japanese seller reviews, see the items Mercari US shows as similar, and list the category tree. Japan also covers Mercari Shops products.
- 7 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/mercari/v1/ search
{"country": "US","applied_filters": {"sort": "relevance","status": "all","q": "nintendo switch"},"total": 20000,"count": 30,"items": [{"id": "m15770090881","name": "BMO \"Adventure Time\" Nintendo Switch Dock","price": 27.07,"original_price": 30,"currency": "USD","status": "on_sale","url": "https://www.mercari.com/us/item/m15770090881/","seller_id": "717873356","condition": "Good","brand": "Nintendo","brand_id": 4591,"category": "Accessories","category_id": 798,"categories": [{"id": 7,"name": "Electronics"},{"id": 84,"name": "Video games & consoles"},"… 1 more"],"size": null,"description": "BMO-themed Nintendo switch (1st generation) holder/dock! Pose-able arms, vents in the back for air circulation and a slot for cable manageme…","photos": ["https://u-mercari-images.mercdn.net/photos/m15770090881_1.jpg?1790860364"],"thumbnail": "https://u-mercari-images.mercdn.net/photos/m15770090881_1.jpg?1790860364&width=200&height=200","likes": null,"label": null,"free_shipping": null,"created_at": "2026-10-01T13:12:44.000Z"},{"id": "m71193799913","name": "Pokemon Violet Nintendo Switch New","price": 59,"original_price": 59,"currency": "USD","status": "on_sale","url": "https://www.mercari.com/us/item/m71193799913/","seller_id": "152470088","condition": "New","brand": "Nintendo","brand_id": 4591,"category": "Games","category_id": 796,"categories": [{"id": 7,"name": "Electronics"},{"id": 84,"name": "Video games & consoles"},"… 1 more"],"size": null,"description": "Pokemon Violet for Nintendo Switch new and sealed \nAll sales are final\nFeel free to send questions!","photos": ["https://u-mercari-images.mercdn.net/photos/m71193799913_1.jpg?1785021194"],"thumbnail": "https://u-mercari-images.mercdn.net/photos/m71193799913_1.jpg?1785021194&width=200&height=200","likes": null,"label": null,"free_shipping": null,"created_at": "2026-07-25T23:13:14.000Z"},"… 28 more"],"next_cursor": "c64.eyJvIjoyOCwicyI6MiwicCI6LTEsImsiOiJDQndRLy8vLy8vLy8vLy8vQVJnQ0tBST0ifQ","cached": false,"credits_used": 1} What you can build with the Mercari API
Resale price research
Search sold listings for a product with a price range and condition to see what it actually sells for on Mercari US or Japan.
Japan sourcing for resellers
Find items on Mercari Japan by keyword, category or brand, then pull the full listing with photos, condition, shipping days and seller rating.
New-listing alerts
Run a search sorted by newest on a schedule and alert when a new item under your price limit appears.
Seller and competitor tracking
Follow a seller's profile, rating, sales and listings, and read the reviews Japanese sellers received.
Comparable items
Get the items Mercari US shows as similar to a listing to compare prices and conditions side by side.
Mercari data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Mercari API endpoints and prices
Every Mercari endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Mercari search /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari seller reviews (Japan) /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari seller profile /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari seller listings /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari categories /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari item /mercari/ | $1 · $2 PAYG 1 credit |
| Mercari similar items (US) /mercari/ | $1 · $2 PAYG 1 credit |
Call the Mercari API
Mercari search: GET https://api.api.sh/mercari/
curl "https://api.api.sh/mercari/v1/search?q=nintendo+switch" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/mercari/v1/search",
params={"q": "nintendo switch"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/mercari/v1/search");
url.searchParams.set("q", "nintendo switch");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/mercari/v1/search", "q", "nintendo switch")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Mercari" and "Mercari search".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 913 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Mercari data
- Public data only: no Mercari login, cookies or account needed
- One key and one response shape for Mercari and 912 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Mercari API
Mercari does not offer a public, self-serve API for reading marketplace listings. The official integrations are for business partners and for Mercari Shops sellers managing their own shop with their own credentials. API.SH returns the public listings, items and seller pages of mercari.com and jp.mercari.com as JSON with one API key.
Instead of maintaining a Mercari scraper or a GitHub client that breaks when the site changes, or paying per run for an Apify actor, API.SH gives you documented routes for both the US and Japan sites with one key and a fixed price per call, with blocks and retries handled for you.
Mercari API questions
What Mercari data can I get?+
Search results with filters (/mercari/v1/search), a full item (/mercari/v1/item), a seller's profile (/mercari/v1/seller) and listings (/mercari/v1/seller-items), Japanese seller reviews (/mercari/v1/reviews), similar items on Mercari US (/mercari/v1/similar) and the category tree (/mercari/v1/categories).
How much does the Mercari API cost?+
Every Mercari endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /mercari/v1/categories at 1 credit each.
Is there an official Mercari API?+
Not for reading listings. Mercari works with approved business partners, and Mercari Shops has an API for sellers managing their own shop. API.SH reads the public marketplace pages and needs no partner agreement.
Do I need a Mercari account or login?+
No. API.SH returns what any logged-out visitor can see on mercari.com and jp.mercari.com. You only need an API.SH key.
Does it work for Mercari Japan?+
Yes. Pass country=JP to search, item, seller and seller-items. Prices are in JPY, and item ids from Mercari Shops work in the item route too. Seller reviews come from Mercari Japan.
Can I get sold prices from Mercari?+
Yes. Use status=sold in /mercari/v1/search or /mercari/v1/seller-items to list sold items with their final listed price, condition and date.
How do I get started?+
Sign up at api.sh, copy your API key and call /mercari/v1/search with q and country. The docs at https://api.sh/docs show every parameter; you can also use the SDKs, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the Mercari API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Mercari calls in parallel as you need and pay only for the calls that run. If Mercari itself slows down, the call returns 503 with a retry-after header and is not charged.