Mercari
Mercari Item API
One Mercari listing by item id or link, on sale or sold: title, description, price, the seller's earlier price and discount when the price was dropped, status and sold_at (when it sold, if Mercari shows it), condition, brand, category path, size, color, shipping (who pays, method, fee, days to ship, ships from), likes, photos, listing and update times, and a seller summary with rating and review count. A sold listing keeps its full data. On jp it adds the item's full public comment list, and a Mercari Shops product returns its shop. Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonitem_idstringA Mercari item id (items[].item_id of a search answer): m and 11 digits, or on jp a 22-character Mercari Shops product id. Send item_id or url.
Example: m38943035688
urlstringA Mercari item link (https://www.mercari.com/us/item/<id>/, https://jp.mercari.com/item/<id> or a /shops/product/ link): the link's market is used.
Example: https://www.mercari.com/us/item/m38943035688/
countrystringdefault:usThe Mercari market: us and jp (default us). us = mercari.com (USD, English), jp = Mercari Japan (JPY, Japanese). Mercari UK closed: gb and uk answer 400, as does any other value, before anything is charged.
Example: us
Notes
Markets. This endpoint serves both Mercari markets: us and jp (default us). us is mercari.com (USD, English); jp is Mercari Japan (JPY, Japanese). Every answer echoes country, currency and language. Mercari UK closed: gb and uk answer 400, as does any other country, before anything is charged.
| country | Market | Prices | Language |
|---|---|---|---|
us | Mercari US (mercari.com) | USD, dollars and cents | English |
jp | Mercari Japan (jp.mercari.com) | JPY, whole yen | Japanese, as sellers wrote it (not translated) |
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# When did it sell, and was the price dropped first?
d = client.mercari.item(item_id="m38943035688", country="us")["data"]
print(d["status"], d["sold_at"], d["price"], d["original_price"], d["discount_percent"])
print(d["shipping"]["payer"], d["likes"], d["seller"]["rating"], d["seller"]["review_count"])Response