# Changelog of Gumtree UK Car Scraper (`rastriq/gumtree-scraper`) Actor

- **URL**: https://apify.com/rastriq/gumtree-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/rastriq/gumtree-scraper.md

## Changelog

### 0.3 (2026-11-15)

Store page; no change to the extraction.

- **Reminder: `km` is in kilometres since 0.2.** Up to 0.1, `km` held the miles shown on Gumtree.
  Since 0.2 it holds kilometres (miles x 1.609344, rounded) and the listed miles are in
  `mileage_miles`. The same car shows a value about 61 % higher in `km` than before. Now
  explained in the README and in the dataset schema.
- Proxy: the input now defaults to Apify Proxy **datacenter**, which is enough (0 blocked pages in
  the November 2026 test runs). The README and the log no longer recommend a residential proxy.
- `dataset_schema.json` rewritten as a JSON Schema with titles, descriptions, nullable types and two
  views (`overview`, `details`); `actor.json` declares it in `storages.dataset`.
- Output schema links the default dataset; input schema with prefill (1 page), section and
  descriptions; `max_pages` limited to 50 in the form (the code already capped it).
- Default memory 512 -> 256 MB (maximum measured: 74 MB).
- README rewritten (data, use cases, km vs miles, pricing, limits, FAQ).
- Offline test of the parser output and of a real run sample against the dataset schema.

### 0.2 (2026-11-14)

- Fix: 0 listings since ~Nov 2026. `/cars/page{N}` now redirects to an SEO landing page with no
  results, and the results page no longer ships `__NEXT_DATA__`. The actor now requests
  `/search?search_category=cars&search_location=uk&page={N}` and parses `window.clientData`
  (`resultsPage.searchAds`). Legacy parsers kept as fallback.
- Fix: the proxy from `proxyConfiguration` was computed but never passed to the HTTP client.
- `km` is now kilometres (converted from the listed miles); new `mileage_miles` keeps the raw value.
- New additive fields: `mileage_miles`, `body_type`, `engine_size_cc`, `colour`, `posted_at`;
  `make`, `model`, `year`, `hp`, `region` now populated.
- A run that extracts nothing now fails instead of ending SUCCEEDED; `SUMMARY` record with counters.
- Dedup by listing id within a run (featured ads repeat across pages). `max_pages` capped at 50.

### 0.1 (2026-06-23)

- Initial version (build 0.1.8).
