API de Mercari: Producto
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.
Precios
Precios del endpoint Producto de la API de Mercari
Pruébalo
Obtén Producto de Mercari en una sola solicitud
{
"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"
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-11 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este 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.
Respuesta
JSON, un valor de ejemplo por campo.
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.
Preguntas frecuentes
Acerca del endpoint Producto de la API de Mercari
El endpoint Producto de AnyAPI para Mercari devuelve datos de Mercari como JSON normalizado con una sola llamada POST a /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 devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual.