Mercari Produit 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.
Tarifs
Tarifs de l’API Mercari Produit
Essayer
Obtenez Mercari Produit en une requête
{
"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"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-11-11 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet 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.
Réponse
JSON, une valeur d’exemple par champ.
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
À propos de l’API Mercari Produit
L’API Mercari Produit d’AnyAPI renvoie des données Mercari en JSON normalisé à partir d’un appel POST à /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 renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel.