# Changelog of Chotot.com Scraper | Vietnam Classifieds & Property (`haketa/chotot-scraper`) Actor

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

## Changelog

### 1.1.0 — 2026-11-01

Full quality pass with a fresh verification run of **400 listings** (All Categories, nationwide) via the live Chotot gateway API. The run returned **400 unique records in ~150 s with 0 duplicates**; core fields (`listingId`, `subject`, `category`, `price`, `priceDisplay`, `listingUrl`, `region`, `district`, `ward`, `latitude`, `longitude`, `sellerName`, `description`) landed at **99–100%** coverage. That run surfaced several stale assumptions from the original build, now fixed:

- **Fixed stale category codes.** Chotot renumbered its taxonomy — the old codes (`2010`=property-sale, `4010`=motorbikes, `7000`=furniture…) now resolve to completely different sections (`2010` is Cars, `2020` is Motorbikes, `7000` is food/collectibles). Rebuilt the `category` input enum and labels against the **live taxonomy**: `1000` Real Estate (+ `1010` apartments, `1020` houses, `1040` land, `1050` rooms), `2010` Cars, `2020` Motorbikes, `2050` Trucks, `5010` Phones, `5030` Laptops, `5020` TV/Audio, `9000` Home Appliances, `3000` Fashion. Choosing "Property" now actually returns property.
- **Fixed broken image URLs.** The listing API now returns a full `cdn.chotot.com` URL, but the actor still prepended its own `unsafe/640x0/` prefix, producing double-prefixed, non-loading URLs on every record. Image URLs are now emitted correctly whether the source is a full URL or a bare path.
- **Fixed the `date` field.** The listing payload now ships a Vietnamese relative string (`"8 giờ trước"`) in `date`; the actor assumed a Unix epoch. `date` is now a real, sortable `YYYY-MM-DD` derived from `list_time`/`orig_list_time`, and the original relative string is preserved in a new **`datePosted`** field.
- **Fixed the rental `type` label.** Rentals use type code `u` (not `k`); listings now correctly report `Cho thuê` (rent) vs `Bán` (sale).
- **Fixed area leaking onto vehicles.** `area` (m²) is now sourced only from the true surface-area field (`size`) and never from Chotot's internal `area` location code, and motorbikes/trucks are correctly detected as vehicles (via `mileage_v2`/`regdate`/category) so a bike's internal code can no longer appear as its floor area.
- **Refreshed the README** end-to-end against the fresh sample: corrected the category reference, the Output example and field table (added `datePosted`), and the pagination/scale notes.
- Added this CHANGELOG.

### 1.0.0 — 2026-05

- Initial public release — direct Chotot gateway API (no browser), multi-category + multi-city coverage, optional detail-API enrichment (phone, full description, full image gallery), code-to-label translation maps (transmission, fuel, colour), 429 back-off with retries, Apify Proxy support, flat deterministic JSON schema.
