Mercari 商品详情 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.
价格
Mercari 商品详情 API 价格
试一试
一个请求获取 Mercari 商品详情
{
"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"
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-11 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- 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.
响应
JSON，每个字段一个示例值。
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.
常见问题
关于 Mercari 商品详情 API
AnyAPI 的 Mercari 商品详情 API 只需一次 POST 请求 /v1/run/mercari.product，就以统一格式的 JSON 返回 Mercari 数据。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 都返回同一套统一的 schema。费用：每千次请求 US$0.85 起，以美元计价，无需订阅，也没有每月最低消费。