ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/mercari/brand

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
brand_idstringrequired

A brand id of the market (brands answer), e.g. us 4591 Nintendo, jp 539 COACH.

Example: 4591

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

Example: switch

category_idstring

A category id of the same market.

Example: 797

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)

# 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

"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": 4978
}
PreviousMercari BrandsNextMercari Deals
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