# Changelog of Mercari Japan & Yahoo Auctions Scraper – メルカリ ヤフオク Sold Prices (`deadc0dex/mercari-yahoo-auctions-scraper`) Actor

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

## Changelog

### 2.1 (2026-10-16)

- Sold comps rows always carry a clean view: `cleanMedian`, `cleanP25`, `cleanP75`, `cleanSampleSize` (accessory / part / empty-box titles and price outliers removed) plus `accessoryShare`; `collectionWarnings: ["accessories_in_sample"]` when ≥ 10 % of the sample looks like accessories. Main stats are unchanged by default.
- `compsFilter`: `outliers` (drop prices outside p25 − 1.5 IQR … p75 + 1.5 IQR) or `accessories` (also drop accessory titles while collecting, so the sample refills; market_research live listings too). Rows report `compsFilter` and `outliersRemoved`.
- `yahooFleaCrossListings`: `exclude` keeps real Yahoo! Auctions only (comps = auction prices), `only` keeps the Yahoo! Flea Market cross-listings; comps rows get `fleaCrossListingShare` and `mostly_yahoo_flea_market_cross_listings` when ≥ 50 %.
- Prices and events unchanged.

### 2.0 (2026-10-15)

- New `market_research` operation: sold comps per market + cross-market row, live listings priced vs the sold median (`vsSoldMedianPct`, `dealFlag`) and one free computed `insight` row (recommended price, best market after fees, cheapest buyable listing, arbitrage spread, deals found, top title terms).
- `dealsOnly`: scan up to 100-300 live listings per market without billing and return only deal / below_p25 rows. Rows priced against a mixed sold sample are flagged `sold_reference_mixed_keyword`.
- `titleMatch` (any / all / off) and `matchTerms` filters (client-side, after fetch).
- Trust fields on every data row: `isPartial`, `unavailableFields`, `collectionWarnings`; comps rows get sample completeness, pages fetched and stop reason.
- Snapshot mode: `deltaKey` + `trackMetrics` adds priceDelta / likesDelta / bidCountDelta / watchCountDelta (listings) and medianDelta / activeListingsDelta / soldPerDayDelta / sellThroughRateDelta (comps) vs the previous run.
- `RATE_LIMITED` error rows (HTTP 429 after retries) besides `BLOCKED` / `UPSTREAM_ERROR`; partial item details now say `details_failed_listing_fields_only`.
- market_research reuses the live-listing page for the active-listings count (one request less per keyword × market).
- Yahoo! Auctions rows that are Yahoo! Flea Market cross-listings now link to the Flea Market page (the auction page returned 404) and carry `collectionWarnings: ["yahoo_flea_market_cross_listing"]`.
- Prices and events unchanged.

### 1.1 (2026-10-13)

- Faster: Mercari pages open in parallel and rows stream out as pages arrive (first of 500 rows in under a second); include details opens 8 items ahead with 4 parallel Yahoo! requests; sold_comps counts active listings in parallel and sizes the last Yahoo! page to what is still needed.
- Yahoo! Auctions sellers: seller_items (live listings) and seller_profiles (rating good / neutral / bad, rating %, listings, identity verified, store flag) from a seller id or auctions.yahoo.co.jp/seller URL; include seller works for Yahoo! Auctions rows.
- Yahoo! Flea Market sold rows now carry soldAt and daysToSell (Flea comps get days to sell, windowDays and sell-through).
- status "all" on Yahoo! Auctions / Flea Market / Rakuma now mixes on-sale and sold rows one by one (v1.0 filled small requests from the first status only).
- Item rows: first 3 photos in compact mode (maxImagesPerItem, all in full) + imageCount; Yahoo! image URLs lose the proxy's not-found fallback params; free text whitespace tidied. Fewer tokens per row.

### 1.0 (2026-10-13)

- First release: Mercari Japan (+ Mercari Shops), Yahoo! Auctions live + sold, Yahoo! Flea Market, Rakuma in one Actor.
- Operations: search, item_details, seller_items, seller_profiles, seller_reviews, sold_comps (per market + cross-market), capabilities; auto routing.
- Agent controls: fields, include (details, seller, evidence, comments), outputMode compact/full/lean/table, maxItems, maxItemsPerInput, maxCostUsd, dryRun, currency conversion, deltaKey change tracking, EN→JA query expansion (search both).
- Free error rows with fixes, summary row, RUN_SUMMARY, status message. PPE: listing $0.002, item-detail $0.004, seller $0.005, comps $0.01, review $0.0012.