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.
- 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.