# Changelog of Marketplace Search Scanner: Amazon, eBay, Etsy (`cleanpull/marketplace-search-scanner`) Actor

- **URL**: https://apify.com/cleanpull/marketplace-search-scanner/changelog.md
- **Full Actor documentation**: https://apify.com/cleanpull/marketplace-search-scanner.md

## Changelog

### 0.3.x reliability (2026-10-24)

- A run that finds nothing searchable (input naming nothing, a source with no reader for the marketplace) ends SUCCEEDED with a free `unreadable` row per search saying why, instead of FAILED. A run whose every search Amazon or the service refused still fails.
- A run stops starting searches before its time limit, delivers what it read and lists the rest (`stoppedForTime`), never TIMED-OUT. Prices and events unchanged.

### 0.3.x (2026-10-23)

- Keyword summaries: `salesFloor` on Amazon (the top 10 organic results' "bought in past month" floors, in units and in revenue; a floor, not an estimate) and `marketplaceFees` (published list rates for US sellers on Amazon, eBay, Etsy and Walmart). Both ride on the keyword summary: no new event, prices unchanged.

### 0.2 (2026-10-15)

- eBay and Etsy come through CleanPull's marketplace data service: no developer keys. Inputs with the old key fields (`ebayClientId`, `ebayClientSecret`, `etsyApiKey`, `etsySharedSecret`, `ebayMarketplace`, `etsyShopDetails`, `maxShopLookups`) run as they are; those fields are ignored.
- New marketplaces: Walmart, Target and Best Buy (US).
- New events: provider record, one per result the service returns, and provider search, one per service job (a marketplace and the run's keywords on it), both billed with the search's summary.
- The service's searches of a run start together (1 to 5 minutes each), within Max cost per run and the spending limit; a run restarted after a migration picks up the searches already started.
- eBay is ebay.com only, and no marketplace but Amazon marks ads.

### 0.1 review changes (2026-10-15)

- Price, seller and review figures come from organic results; ads are summarised apart (`ads`). Added p10 and p90.
- eBay auctions are left out of the price figures. New `ebayFixedPriceOnly` option.
- Watchlist:
  - a candidate entrant waits one extra run;
  - a restarted run compares with the state before it;
  - a change of watched top or depth starts a new baseline;
  - the warning about US reads with ads shows whenever there is an earlier state.
- Amazon:
  - the residential wire cap drops to 400 KB;
  - after 2 refused searches in a run, US searches go straight to standard addresses;
  - the keyword's own words are never read as a brand.
- `maxRunCostUsd` worst case: the depth plus up to 20 ads a page.
- The search reader moved to `@cleanpull/amazon/search`.

### 0.1 (2026-10-14)

- First version: listing rows and keyword summaries for Amazon (22 marketplaces, organic and sponsored), eBay (Browse API) and Etsy (Open API v3) with the user's own keys as secret inputs.
- Keyword summaries:
  - price percentiles: min, p25, median, p75, max;
  - seller concentration: top sellers, top-3 share, HHI;
  - review depth and ad count.
- Watchlist mode with SHA-256 keys:
  - new entrants and new sellers in the top results;
  - listings that left the top, confirmed on a second run;
  - price-band moves past a threshold;
  - Changes only.
- Max cost per run, platform spending limit, restart- and migration-safe delivery.