Mercari
Mercari Categories API
Mercari's category tree with category ids for the category endpoint and the search category_id filter. us answers one level at a time: the 17 top-level categories, or the children of parent_id. jp answers the whole tree in Japanese (8,784 categories on 2026-11-16) or the children of parent_id. Each row has category_id, name, parent_id, level and has_children. 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 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
parent_idstringA category id: its children. Omitted: us answers the 17 top-level categories, jp the whole tree (8,700+ rows, each with parent_id).
Example: 7
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)
# Walk the US tree one level at a time.
top = client.mercari.categories(country="us")["data"]["categories"]
for c in top:
print(c["category_id"], c["name"], c["has_children"])
kids = client.mercari.categories(country="us", parent_id="7")["data"]["categories"]Response