# Changelog of Alibaba.com Product & Supplier Scraper \[Just 💰$0.63] (`blackfalcondata/alibaba-com-scraper`) Actor

- **URL**: https://apify.com/blackfalcondata/alibaba-com-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/blackfalcondata/alibaba-com-scraper.md

## Changelog

All notable changes to this Actor are documented here.

### \[Unreleased]

#### Added

- Keyword searches now cover suppliers in every country by default (China, Hong Kong, the US, Vietnam and more); enter a country code in "Supplier Country" to search only that country.
- New sourcing filters: min/max unit price, max minimum order quantity, min product rating, min review count and min supplier years.
- New "Currency" setting: price limits are read in that currency and each product gets its price range converted (`convertedPriceMin`, `convertedPriceMax`).

#### Fixed

- Runs with product-page details and a short run timeout no longer end with no results: rows are saved as each result page finishes, and when the timeout is close the remaining products are returned with their search-result fields (the log says how many lack details).
- Incremental runs with a price limit in another currency (e.g. 100 EUR) no longer share history with the same limit in USD, so products are no longer wrongly reported as expired after switching currency.
- A keyword search that overlaps an earlier keyword is now read to its end instead of stopping early and missing products.
- Products whose category could not be resolved are no longer labelled as fully enriched.
- Incremental mode now reports a product as updated when its rating or review count changes.
- "Skip reposts" now recognises a product relisted under a new id.
- When product pages cannot be read, the run is marked incomplete with the number of affected products instead of finishing silently.
- Products enriched from earlier detail data are now labelled as full records.

### \[0.1.0] — 2026-10-22

Initial release.

#### Added

- Scrape products from alibaba.com.
- Paste alibaba.com search, country search or showroom URLs as start URLs.
- Service badges such as "Easy Return" are delivered as selling points.
- Runs stay within your per-run spending limit.
- New "Max pages per keyword" setting limits how many result pages are read for each keyword or start URL.
- A pasted country-search URL on page N now starts reading at page N; URL filters that cannot be applied are named in the run log.
- Each product's `searchQuery` now shows the keyword that actually found it.
- Each product now shows which results page it was listed on (`page`), and the keyword also under `searchKeyword`.
- With incremental mode, "Emit expired listings" now delivers a row for each product that disappeared; products are only marked expired after a complete scan.
- If some searches fail, the run keeps the products it found and is clearly marked incomplete; if every search fails, the run fails with a clear error.
- Several keywords can be entered as a JSON list in the search field.
- With incremental mode, a search that now finds nothing marks every previously seen product as expired (and delivers expired rows when asked), instead of leaving them active.
- Each product now carries its category name (`category`) and the supplier's employee count: the declared range (`employeesTotal`, e.g. "101-200") and, where an on-site inspection exists, the verified headcount (`employeesVerified`).
- A product is never marked expired just because it lies beyond the 100 result pages alibaba.com shows when the site does not report a result count.
- With incremental mode, a long run keeps its hold on the saved state while it works, and a run that loses that hold to a newer run stops delivering (and is not billed for more rows) instead of overlapping it; a failing run never removes another run's hold.
- With incremental mode, a run that briefly cannot read its saved-state lock no longer keeps delivering (and billing) rows after a newer run has taken over; if the hold cannot be confirmed in time the run stops cleanly instead.
- A keyword no longer comes back with zero products when alibaba.com briefly serves its results page without products; the page is read again before a keyword is reported as having no results.
