Mercari Product API
Get one Mercari US or Japan listing by item id or URL: title, description, price, original price, status, condition, brand, category, size, photos, shipping terms, seller name, rating and listing count, when it was listed, and for a sold US item when it sold.
Pricing
Mercari Product API pricing
Try it
Get Mercari product in one request
{
"data": {
"items": [
{
"brand": "Acme Inc",
"brandId": "Acme Inc",
"category": "general",
"categoryId": "general",
"condition": "example",
"createdUtc": 12.5,
"currency": "USD",
"description": "A short example description of this item.",
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"itemId": "a1b2c3d4",
"likeCount": 12500,
"originalPrice": 19.99,
"price": 19.99,
"sellerId": "a1b2c3d4",
"sellerListingsCount": 12500,
"sellerName": "Example title",
"sellerRating": 4.6,
"sellerRatingCount": 5,
"shippingPayer": "example",
"shipsFrom": "example",
"size": "example",
"soldUtc": 12.5,
"status": "active",
"title": "Example title",
"updatedUtc": 12.5,
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-11 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- itemIdstring
m73121443159
Mercari item id or full listing URL (e.g. m73121443159 or https://www.mercari.com/us/item/m73121443159/). A jp.mercari.com URL is looked up in Japan whatever country says. Every mercari.search and mercari.sold_listings row carries its itemId.
- countryenum
Mercari marketplace of the item id: us (USD) or jp (JPY). Ids are not shared between countries.
Response
JSON, one example value per field.
The one listing record. Populated whenever the provider has data for the entity.
- brandstring
Brand name the seller tagged; null when untagged.
- brandIdstring
Mercari brand id, usable as the brandId filter in the same country.
- categorystring
Leaf category name.
- categoryIdstring
Mercari leaf category id, usable as the categoryId filter in the same country.
- conditionstring
Item condition grade: new, like_new, good, fair, poor, or worn (Japan only).
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the item was listed.
- currencystring
ISO currency code of the price: USD for the US, JPY for Japan. Populated whenever the provider has data for the entity.
- descriptionstring
Listing description written by the seller.
- imagestring
Primary listing image URL. Populated whenever the provider has data for the entity.
- imagesstring[]
All listing photo URLs, primary first.
- itemIdstring
Mercari item id (m followed by 11 digits, or a 22-character Mercari Shops product id in Japan). Populated whenever the provider has data for the entity.
- likeCountinteger
Number of users who liked the listing.
- originalPricenumber
First asking price of the listing in USD; differs from price when the seller lowered it or accepted an offer. US only: null in Japan.
- pricenumber
Price in the listing currency; it does not include buyer fees, and whether shipping is included depends on shippingPayer. For a sold item (status sold_out or trading) it is the final sale price after any accepted offer. Populated whenever the provider has data for the entity.
- sellerIdstring
Mercari seller id.
- sellerListingsCountinteger
Number of items the seller has listed.
- sellerNamestring
Seller display name.
- sellerRatingnumber
Seller star rating; null when the seller has no ratings yet.
- sellerRatingCountinteger
Number of ratings the seller has received.
- shippingPayerstring
Who pays shipping: seller (the price is delivered) or buyer.
- shipsFromstring
Region the item ships from (a US state or Japanese prefecture).
- sizestring
Size label the seller chose (e.g. 8.5 (39)), when the category has sizes.
- soldUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the item sold. US only, and null unless status is sold_out or trading; in Japan updatedUtc is the nearest proxy.
- statusstring
Listing state: on_sale (active), trading (sold, handover in progress) or sold_out (sold). Populated whenever the provider has data for the entity.
- titlestring
Listing title. Populated whenever the provider has data for the entity.
- updatedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing last changed.
- urlstring
Canonical listing URL. Populated whenever the provider has data for the entity.
- foundboolean
True when the listing was found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Mercari Product API
The AnyAPI Mercari Product API returns Mercari product data as normalized JSON from one POST call to /v1/run/mercari.product. Get one Mercari US or Japan listing by item id or URL: title, description, price, original price, status, condition, brand, category, size, photos, shipping terms, seller name, rating and listing count, when it was listed, and for a sold US item when it sold. AnyAPI returns one normalized schema whichever source serves it. It costs from $0.85 per 1,000 requests, in US dollars with no subscription and no monthly minimum.