# Changelog of Job Listings & Salary Scraper for ZipRecruiter (US, UK, IE, CA) (`haketa/ziprecruiter-scraper`) Actor

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

## Changelog

### 1.1.0 — 2026-11-01

- **Cloudflare bypass fixed (all markets).** ZipRecruiter rolled its UK/IE sites behind the same Cloudflare challenge as US/CA, and the previous got-scraping Chrome fingerprint began hitting hard `403` / "Just a moment…" blocks on every IP (0 results). Swapped the HTTP transport to an **impit Firefox-TLS client** with a fresh residential IP per request, which clears the challenge over plain HTTP. All parsing is unchanged.
- **Block-detection made content-aware.** ZipRecruiter now embeds Cloudflare's `challenge-platform` script and an "enable JavaScript and cookies" note on fully-rendered pages, which caused false-positive "blocked" retries. Detection now treats a page as blocked only when the genuine challenge title appears *and* no job content is present — eliminating false negatives.
- **Cleaner job descriptions.** ZipRecruiter's JSON-LD `description` embeds literal `\n` / `\t` escape sequences (they were leaking into 83% of `descriptionText` / `descriptionHtml` values). These are now normalised to real whitespace, so the plain-text description is clean prose and the HTML stays tidy.
- **Fresh verification run:** 320 unique UK "manager" jobs scraped with full per-job detail enrichment — **100% core-field coverage** (jobId, title, company, listingUrl, city, country), **0% duplicates**, ~87% detail-field coverage (dates, geo, employment type, Quick Apply), ~43% disclosed salary, out of 19,200 reported results, in ~11 minutes. Post-fix spot-check confirmed 0/25 descriptions with leftover escape artifacts.
- **README refreshed** to the gold standard: accurate output example + field reference grounded in the fresh run, updated pagination/scale notes, Cloudflare-resilience explanation, FAQ and related-scraper links.
- Added `impit` dependency; removed the `--no-optional` flag from the Docker build so impit's native client installs cleanly.

### 1.0 — 2026-07-02

- Initial release. Markets: US / UK / IE / CA. Listing + per-job detail enrichment.
- Salary parsing (min/max/currency/period), Quick Apply (`directApply`) flag, geo coordinates, employment type, ISO posted/valid-through dates, remote detection.
- HTTP-only (got-scraping + cheerio); automatic pagination with de-duplication by job id; clean exit on empty searches.
