Mercari
Mercari Deals API
Listings on Mercari US's deals filter: listings whose price the seller dropped, each with price, original_price (the seller's earlier price) and discount_percent, plus status, condition, brand, category, seller id and listing time, 50 a page up to page 20, optionally narrowed by keywords, a category, a brand and the search filters. Mercari US only. 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/jsoncountrystringdefault:usThe Mercari market: us only (the default; the other market answers 400, not charged). 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
querystringOptional keywords.
Example: jordan
category_idstringA US category id to narrow the deals.
Example: 797
brand_idstringA US brand id.
Example: 1400
statusenum<string>default:on_saleWhich listings.
Example: sold
on_sale— Listings on sale now. The default.sold— Sold listings, including items sold but still in transit (status trading), with the price they sold at.all— No status filter.
pageintegerdefault:1Results page, 1-based: us 50 per page up to page 20, jp 120 per page up to page 91. Later us pages can repeat items from earlier pages (promoted placements): dedupe by item_id.
Example: 2
sortenum<string>default:relevanceResult order.
Example: price_asc
relevance— Mercari's best match. The default. On a us sold search Mercari still orders results most recently sold first.newest— Newest first. On jp this is Mercari Japan's own order, in which relisted items move up, so created_at is not strictly descending.price_asc— Price, low to high.price_desc— Price, high to low.likes— Most liked first. jp only.recently_sold— Most recently sold first, with status sold. us only (a us sold search is in this order under relevance too).
price_minnumberLowest price: US dollars on us, whole yen on jp.
Example: 50
price_maxnumberHighest price: US dollars on us, whole yen on jp.
Example: 300
conditionstring | string[]One or more of new, like_new, good, fair, poor; bad on jp only. Several are ORed.
Example: ["new", "like_new"]
shippingenum<string>free (the seller pays shipping) or buyer_pays. On us, result rows carry free_shipping only when you send this filter.
Example: free
size_idstringus only: a Mercari US size id (digits).
Notes
Markets. This endpoint serves Mercari US only: us only (the default; the other market answers 400, not charged). 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 |
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# Price drops in Consoles (us 797), deepest first.
r = client.mercari.deals(country="us", category_id="797")["data"]
for i in sorted(r["items"], key=lambda i: i["discount_percent"] or 0, reverse=True):
print(i["discount_percent"], i["original_price"], "->", i["price"], i["title"])Response