ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

Mercari

Mercari Category API

The listings of one Mercari category, by category id from categories, on Mercari US or Mercari Japan: the category, then items with price, the seller's earlier price and discount, status, condition, brand, seller id and listing time, paged and sorted, optionally narrowed by keywords, a brand and the search filters. status sold lists the category's sold listings with the prices they sold at. Costs 1 credit.

POST/api/v1/mercari/category

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json
category_idstringrequired

A category id of the market (categories answer), e.g. us 797 Consoles, jp 1289 ポケモンカードゲーム.

Example: 797

countrystringdefault:us

The 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

querystring

Optional keywords within the category.

Example: oled

brand_idstring

A brand id of the same market.

Example: 4591

statusenum<string>default:on_sale

Which 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:1

Results 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:relevance

Result 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_minnumber

Lowest price: US dollars on us, whole yen on jp.

Example: 50

price_maxnumber

Highest 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_idstring

us only: a Mercari US size id (digits).

deals_onlyboolean

us only: only listings on Mercari's deals filter (the seller dropped the price).

Example: true

shops_onlyboolean

jp 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.

countryMarketPricesLanguage
usMercari US (mercari.com)USD, dollars and centsEnglish
jpMercari Japan (jp.mercari.com)JPY, whole yenJapanese, as sellers wrote it (not translated)

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=180)

# The latest sales in Consoles (us 797), newest sale first.
r = client.mercari.category(category_id="797", country="us", status="sold", sort="recently_sold")["data"]
print(r["category"]["name"], r["total"])
for i in r["items"]:
    print(i["item_id"], i["price"], i["condition"], i["title"])

Response

"country": "us",
"currency": "USD",
"language": "en",
"query": null,
"status": "on_sale",
"sort": "relevance",
"page": 1,
"page_size": 50,
"max_page": 20,
"total": 10000,
"has_more": true,
"count": 50,
},
"response_time": 3667
}
PreviousMercari ItemNextMercari Categories
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy