Mercari Item API Documentation Read one Mercari listing by id (for example m85764352496) or by its page url. The url also sets the market. The answer has title, description, price with currency, status, sold price, condition, brand, size, category, all photos in full size, likes, shipping (payer, carrier, ships from, fee), listing and update time and the seller with rating. The Japanese market adds the category path, colors, comments, attributes and the sold time. Mercari Shops listings are not supported. Listings are single items, so there is no stock per size. A listing that does not exist answers 404 and is not billed. Each successful request costs 1 credit. A failed request is never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Listing id, for example m85764352496. Send id or url.
1234567890
string
Optional
Listing page url on mercari.com/us or jp.mercari.com. The url also sets the market.
https://example.com/product
string
Optional
Marketplace: us (United States) or jp (Japan). Defaults to us. The two markets are separate: ids and filters differ.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
success
{
"data": {
"item": {
"id": "m85764352496",
"url": "https://www.mercari.com/us/item/m85764352496/",
"size": {
"id": 78,
"name": "13 (46)"
},
"brand": {
"id": 31861,
"name": "Nike SB"
},
"likes": 7,
"price": 250,
"title": "Freddy Krueger SB Dunks",
"market": "us",
"photos": [
"https://u-mercari-images.mercdn.net/photos/m85764352496_1.jpg?1793310628"
],
"seller": {
"id": 207052431,
"name": "donburgundy01",
"rating_count": 81
},
"status": "on_sale",
"sold_at": null,
"category": {
"id": 399,
"name": "Fashion sneakers"
},
"currency": "USD",
"shipping": {
"fee": 0,
"payer": "buyer",
"method": null,
"carrier": "UPS Ground Saver",
"package": "3 lb",
"ships_from": {
"id": 19,
"name": "Louisiana"
}
},
"condition": {
"id": 1,
"name": "New"
},
"listed_at": "2026-10-29T21:50:28Z",
"thumbnail": "https://u-mercari-images.mercdn.net/photos/m85764352496_1.jpg?1793310628",
"sold_price": null,
"updated_at": "2026-10-29T21:50:28Z",
"description": "Nike SB Dunk Low Premium Freddy Krueger. Size US 13",
"total_price": 259,
"original_price": null,
"discount_percent": null
}
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. Mercari is not called and the request is not billable.
{
"errors": {
"id": [
"The id must look like m12345678901. Mercari Shops listings are not supported."
]
},
"message": "The request validation failed"
}Not Found
The listing was removed or is not public. This response is not billable.
{
"error": {
"code": "not_found",
"message": "Mercari has no public listing or seller for this id."
},
"success": false
}Transport Unavailable
Mercari did not answer after several tries. Retry later. This response is not billable.
{
"error": {
"code": "transport_unavailable",
"message": "Mercari could not be reached right now. The request is not billed. Try again."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.