ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/mercari/deals

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
countrystringdefault:us

The 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

querystring

Optional keywords.

Example: jordan

category_idstring

A US category id to narrow the deals.

Example: 797

brand_idstring

A US brand id.

Example: 1400

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

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.

countryMarketPricesLanguage
usMercari US (mercari.com)USD, dollars and centsEnglish

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

"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": 9568
}
PreviousMercari BrandNextMercari Trending
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