Sold or active listings
Use one endpoint for public sold-price research or current asking-price inventory while keeping the listing status explicit in every row.
100 free requests, no Mercari login
Search Mercari sold and active listings through one API.
Use GET /v1/mercari to search public Mercari US listings by keyword. One page returns up to 100 sold listings by default, or active listings with sold=false, including price, condition, brand, category, seller ID, status, and images. Sold pages include a deterministic median and price range. Customers need only a CompSniper API key, not a Mercari account or cookies.
Reviewed by Marc Andrew, owner of CompSniper. Updated September 4, 2026.
curl --fail-with-body \
-H "Authorization: Bearer $COMPSNIPER_API_KEY" \
"https://api.compsniper.com/v1/mercari?keyword=sony+wh-1000xm5&count=25&sold=true"Endpoint
GET /v1/mercari
Results per page
Up to 100 listings
Coverage
Mercari US
What the API provides
Marketplace evidence without building another scraper
Fast structured pages
Return up to 100 listings with stable native fields, pagination, total results, and a deterministic summary for sold searches.
Managed guest access
Use one CompSniper bearer key and the same quota, credit, caching, request-ID, and retry behavior as the rest of the API.
Request filters
Start with a keyword, then narrow the page
Authentication uses the same CompSniper API key as every other endpoint. No Mercari account or customer cookie is required.
| Parameter | Accepted values | Default |
|---|---|---|
| keyword | Any non-empty product search | Required |
| page | 1 through 100 | 1 |
| count | 1 through 100 | 100 |
| sold | true or false | true |
| minPrice, maxPrice | Non-negative USD values | No limit |
| itemCondition | any, new, likeNew, good, fair, poor | any |
| sortOrder | bestMatch, newest, lowestPrice, highestPrice, recentlySold | bestMatch |
| categoryId, brandId | Positive Mercari identifiers | Any |
Response
Stable JSON with native fields
Every successful sold page includes a deterministic median, average, p25 to p75 range, and sample size calculated from the returned prices.
Response
{
"keyword": "sony wh-1000xm5",
"page": 1,
"count": 25,
"totalResults": 347,
"totalItems": 25,
"hasNextPage": true,
"items": [
{
"itemId": "m93973576506",
"url": "https://www.mercari.com/us/item/m93973576506/",
"title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones",
"price": "70.00",
"currency": "USD",
"originalPrice": "199.00",
"condition": "Good",
"conditionId": 3,
"status": "sold",
"sellerId": 928815218,
"brand": "Sony",
"categoryName": "Bluetooth Headphones"
}
],
"summary": {
"count": 25,
"currency": "USD",
"median": 112,
"p25": 85,
"p75": 149
}
}Returned fields
The data needed for pricing workflows
- Displayed listing price and original price
- Sold or active listing status
- Condition label and numeric condition ID
- Brand, category ID, and category name
- Seller ID and canonical item URL
- Full image and thumbnail URLs
- Deterministic sold-price summary and sample size
- Pagination, total results, and request-usage headers
Common workflows
Built for resale tools and repeatable research
Collectible pricing
Compare public sold prices for cards, games, electronics, fashion, and other products commonly resold on Mercari.
Cross-marketplace tools
Add Mercari evidence beside eBay and Poshmark without requiring users to maintain separate scraping infrastructure.
Active versus sold research
Compare current asking prices with sold evidence while keeping the two datasets and summaries clearly separated.
FAQ
Mercari API questions
Does Mercari provide a public sold listings API?+
Mercari does not offer a broadly documented developer API for general US marketplace sold-listing research. CompSniper provides a stable authenticated endpoint over public Mercari US search data for sold and active listing workflows.
Can the same endpoint return active Mercari listings?+
Yes. sold=true returns sold listings and is the default. Set sold=false to retrieve active listings and their current asking prices. Active results return summary as null because asking prices are not completed-sale evidence.
Do customers need a Mercari account or cookies?+
No. Customers use only their CompSniper API key. CompSniper manages the anonymous guest request flow, so the integration does not collect a Mercari login or customer cookies.
Does Mercari return the exact date an item sold?+
Mercari public search does not provide a reliable exact sold timestamp. CompSniper returns the listing status and price but leaves an unsupported sold date out instead of inferring or inventing one.
How many Mercari listings are returned?+
Each page returns up to 100 listings. Use page and count for pagination while hasNextPage is true. Every successful page uses one CompSniper monthly request or purchased credit.
Run your first Mercari search
Create a free account, get an API key, and use the same quota from REST, the dashboard, or CompSniper MCP tools.