# Changelog of Mercari Japan Scraper — Products, Prices, Brands & Sellers (`haketa/mercari-scraper`) Actor

- **URL**: https://apify.com/haketa/mercari-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/haketa/mercari-scraper.md

## Changelog

### 1.0.1 — 2026-11-01

- Verified a fresh run of **501 unique listings in ~12 seconds** across two keywords (`nike`, `ポケモンカード`) with **0 duplicates** on the `id` key and `pageToken` pagination confirmed working to the `maxItems` cap.
- Confirmed **100% core-field coverage**: `id`, `name`, `price`, `currency`, `status`, `condition`, `categoryId`, `sellerId`, `imageUrl`, `url`, `createdAt`, `updatedAt` all fully populated; prices are clean integers (¥300–¥346,500), URLs and image URLs well-formed, no value bugs (`[object Object]`, scheme-less URLs, wrong types).
- Documented honest data-dependent coverage for optional fields: `brand`/`brandId` (~55%, branded items only), `size`/`sizes` (~39%, items with a size), `shippingPayer` (~88%), and `shopName` (Mercari Shops "beyond" listings only).
- Rewrote the README to the gold standard: keyword-rich intro, Why/What/Use-cases sections, full input & output field references matched to the real fresh-run sample, Pagination & scale notes, expanded FAQ, and a Related scrapers block.
- No code changes — the DPoP token flow, pagination and field flattening all verified correct and healthy.

### 1.0.0 — 2026-11-01

- Initial release: Mercari Japan (メルカリ) keyword scraper. HTTP-only via impit (Firefox-TLS) with a fresh self-signed ES256 **DPoP** proof-of-possession token minted per request — no login, no browser.
- Keyword search with `status` (on-sale / sold-out / both), `sort` (relevance / newest / price / likes), and `priceMin` / `priceMax` filters.
- Native `pageToken` pagination (120 listings per page), de-duplication by listing ID, and configurable `maxItems` / `maxPages` / `maxConcurrency`.
- Outputs price (JPY), condition, brand, size, category, item type, seller, shipping payer, timestamps, images and the canonical item URL.