Mercari-Produkt-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.
Preise
Preise der Mercari-Produkt-API
Ausprobieren
Mercari Produkt mit einer Anfrage abrufen
{
"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"
}Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.
Referenz
Eine Anfrage, eine Antwortstruktur.
Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.
Zuletzt geprüft 2026-11-11 · Verfügbarkeit und Latenz gemessen über 30d
Request-Body
JSON, per POST an diesen Endpoint gesendet.
- 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.
Antwort
JSON, ein Beispielwert pro Feld.
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
Über die Mercari-Produkt-API
Die AnyAPI-Mercari-Produkt-API liefert Mercari-Daten als normalisiertes JSON aus einem POST-Aufruf an /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 liefert ein normalisiertes Schema, egal welche Quelle antwortet. Sie kostet ab 0,85 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum.