Mercari+API.SH

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
Mercari search
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}
1 credit · $1 per 1,000 calls

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 categories/mercari/v1/categories
countryJPcount13
categories[]id · name · parent_id · children
Mercari item/mercari/v1/item
countryUS
item[]id · name · price · original_price · currency · status · url · description · photos · condition · brand · size
countryJPseller_id482357918count20next_cursor1729198119
applied_filters[]as
summary[]ratings · num_ratings · star_rating
reviews[]rating · message · as · reviewer · created_at

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

Search and discovery1
Mercari search
/mercari/v1/search
params q +15 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts3
Mercari seller reviews (Japan)
/mercari/v1/reviews
params id +4 optionaldocstry
$1 · $2 PAYG
1 credit
Mercari seller profile
/mercari/v1/seller
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
Mercari seller listings
/mercari/v1/seller-items
params id +10 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places3
Mercari categories
/mercari/v1/categories
params none required +1 optionaldocstry
$1 · $2 PAYG
1 credit
Mercari item
/mercari/v1/item
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
Mercari similar items (US)
/mercari/v1/similar
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Mercari API

Mercari search: GET https://api.api.sh/mercari/v1/search

curl "https://api.api.sh/mercari/v1/search?q=nintendo+switch" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 913 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 913 platforms.
Get a free API key