Sign in Get API key
Mercari API

Mercari API for Listing Search, Item Details, Sold Prices, and Seller Profiles in the US and Japan

Scrappa's Mercari API returns structured JSON from Mercari, the second-hand marketplace of the United States and Japan. Search listings with filters for brand, category, condition, size, price and status, read sold prices, open one listing with photos, shipping and seller, and load a seller with ratings and listings. The US and Japanese markets are separate and selected with one parameter.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
3
Endpoints
US + Japan
Markets
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/mercari/search?query=nike&market=us&status=sold&sort=price_asc" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "market": "us",
    "query": "nike",
    "page": 1,
    "per_page": 30,
    "total": 10000,
    "total_is_capped": true,
    "has_next": true,
    "items": [
      {
        "id": "m85764352496",
        "url": "https://www.mercari.com/us/item/m85764352496/",
        "title": "Freddy Krueger SB Dunks",
        "price": 250,
        "currency": "USD",
        "status": "sold",
        "sold_price": 250,
        "condition": { "id": 1, "name": "New" },
        "brand": { "id": 31861, "name": "Nike SB" }
      }
    ]
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Resale Price Monitoring

Track asking prices and sold prices for a brand, size or condition and compare them over time.

Resale Arbitrage

Compare the same brand and model in the US and Japan to find items that sell for more elsewhere.

Trend and Brand Research

Count live listings and read likes for a brand or category to see what sells.

Seller Due Diligence

Check a seller rating, listing count and open or sold listings before you buy or partner.

Product Discovery Apps

Power search and item pages with prices, condition, full-size photos and shipping data.

Mercari scraper API

Mercari API for listing search, sold prices, item details, and sellers

The Mercari API is built for resale price tracking, arbitrage research and seller checks. The search endpoint returns listings with price as a number, currency, condition, brand, size, photos and status. Choose the US or the Japanese market with one parameter. Sold listings carry the sold price.

Filter by brand, category, condition, size, price range and on sale or sold.

Sort by price, or newest first. Page through results with the page parameter.

Read prices as numbers with a currency code: USD for the US, JPY for Japan.

Open one listing for the description, all photos, shipping and the seller.

Only public data is returned. No login is needed on your side.

Choose the right Mercari API endpoint

Use Listing Search to find listings

Send a query and a market. Add filters and a sort order, then page with the page parameter. Set status to sold to read sold prices.

Open Mercari Search API docs

Use Item to read one listing

Send the listing id or url from a search result to get the description, all photos, shipping, likes and the seller block.

Open Mercari Item API docs

Use Seller to check a seller

Send the seller id from a search result to read the profile and page through open or sold listings.

Open Mercari Seller API docs

Available endpoints

Everything you need in one API.

Related resources

Depop API overview

Compare second-hand fashion prices on Mercari with Depop listings.

Vinted API overview

Compare resale prices on Mercari with Vinted listings.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to ScrapingBee / ScraperAPI.

Mercari data as JSON
Scrappa
ScrapingBee / ScraperAPI
Build your own parser
US and Japan markets
Scrappa
One parameter
ScrapingBee / ScraperAPI
Two scrapers to build
Search filters and sorting
Scrappa
Typed parameters
ScrapingBee / ScraperAPI
Build the query yourself
Price per 1k requests
Scrappa
From $0.20
ScrapingBee / ScraperAPI
Varies by credits per request
Unified API key
Scrappa
Yes (350+ APIs)
ScrapingBee / ScraperAPI
Scraping only
Free tier
Scrappa
500 credits/month
ScrapingBee / ScraperAPI
Trial credits

Key features

US and Japanese Mercari in one API, selected with the market parameter
Filters for brand, category, condition, size, price range and on sale or sold
Sold prices, discount percent, likes, condition and full-size photos
Shipping payer, carrier and ships-from area per listing
Seller profile with ratings and paged listings
Public data only. Failed requests are never billed

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Mercari. The Mercari API returns structured JSON from public listing data.

Every Scrappa account includes 500 free credits each month. After that, each successful request costs one credit, which works out to $0.20 to $0.50 per 1,000 requests.

The US market reaches 33 pages of 30 listings and the Japanese market reaches 500 pages. For deep paging in the US, sort by price.

Set status to sold. The price of a sold listing is the sold price, and sold_price repeats it.

No. Only successful responses are billed.

Start using the Mercari API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation