# Changelog of 1688 Sourcing Profit Analyzer — Landed Cost, Margin & ROI (`haketa/1688-sourcing-profit-analyzer`) Actor

- **URL**: https://apify.com/haketa/1688-sourcing-profit-analyzer/changelog.md
- **Full Actor documentation**: https://apify.com/haketa/1688-sourcing-profit-analyzer.md

## Changelog

### 0.2.0 — 2026-11-01

- **Fixed a pagination bug that capped every keyword at ~19 products.** The 1688 mobile search endpoint returns a variable page size (typically ~16–19 cards per page, not a fixed 20). The previous stop condition `products.length < 20` therefore fired after the very first page of every keyword, so the actor could never advance to page 2 — a run requesting 400 items returned only ~71. The actor now keeps paginating while pages return meaningful card counts and stops cleanly only on a nearly-empty page, when two consecutive pages add no new unique offers, or when it passes the match count 1688 reports.
- Widened the internal per-keyword page budget so a high `maxItems` is no longer artificially throttled by the old fixed-20 page estimate (the hard 50-page-per-keyword ceiling is unchanged).
- **Hardened anti-bot resilience.** Per-page session rotation now retries up to 6 times (was 3) against 1688's intermittent `bxpunish` challenge, and a blocked page is no longer mistaken for the end of results — the crawler rotates on to the next page and only gives up on a keyword after several consecutive blocked pages, so an unlucky batch of China-residential sessions can recover instead of returning an empty dataset.
- Verified the fix with fresh China-residential runs: core fields (`offerId`, `title`, `priceCny`, `url`, `landedCost`, `unitProfit`, `netMarginPercent`, `sourcingScore`) at **100%** coverage, **0%** duplicate `offerId`, 33 distinct output fields, valid product/image URLs, and no value bugs.
- Refreshed the README to the current gold standard: output example and field-reference table regenerated from the live sample, honest notes on which supplier/demand signals are data-dependent, updated performance numbers, FAQ and related-scrapers links.