# Changelog of Mercari Japan Scraper – Listings & Sold Prices (メルカリ) (`tokyo-select-jp/mercari-search-scraper`) Actor

- **URL**: https://apify.com/tokyo-select-jp/mercari-search-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/tokyo-select-jp/mercari-search-scraper.md

## Changelog

### 0.2.0 — 2026-11-02

- New `outputMode` input: `items` (default, unchanged), `summary` (one market-summary row per search instead of the listings), `both`. A summary row (`recordType: "summary"`) carries the sample size and the site's total count, price statistics (min / p25 / median / mean / p75 / max / stddev, on-sale vs sold), a price histogram, status / condition-rank / size / brand / category / gender breakdowns, recent-listing counts where the site exposes listing times, and the cheapest listings (all, and in good condition). Billed once per search as the `summary` event; in `summary` mode the sampled listings are not stored and not billed.
- Shared `src/core/summary.ts` — the same file in every JP Data Works Actor, so summaries from different sites line up field by field.
- Dataset schema: `recordType` added; only `source` is required now (summary rows have no item fields).

### 0.1 (2026-11-02)

- First release: keyword / category / brand / seller searches on api.mercari.jp with status (on sale / sold / trading), price range, condition, shipping payer, sort order and createdAfter.
- Normalized output shared with the other JP Data Works scrapers (`priceJpy`, `sizeNorm`, `conditionRank`, `imageUrls`), `soldAt` for sold items.
- Optional item detail enrichment (description, category path, colour, shipping, likes, seller ratings, attributes) for C2C items.
- Pay-per-event pricing: result, detail page, Actor start.