Mercari
Mercari Brand API
The listings of one Mercari brand, by brand id from brands, on Mercari US or Mercari Japan: the brand, then items with price, the seller's earlier price and discount, status, condition, category, seller id and listing time, paged and sorted, optionally within a category or with keywords and the search filters. status sold lists the brand's sold listings with the prices they sold at. 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/jsonbrand_idstringrequiredA brand id of the market (brands answer), e.g. us 4591 Nintendo, jp 539 COACH.
Example: 4591
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
querystringOptional keywords within the brand.
Example: switch
category_idstringA category id of the same market.
Example: 797
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).
deals_onlybooleanus only: only listings on Mercari's deals filter (the seller dropped the price).
Example: true
shops_onlybooleanjp only: only Mercari Shops products (business sellers).
Example: true
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)
# Coach (us 1400): the latest sold listings, newest sale first.
r = client.mercari.brand(brand_id="1400", country="us", status="sold", sort="recently_sold")["data"]
for i in r["items"]:
print(i["item_id"], i["price"], i["original_price"], i["title"])Response