# Changelog of OfferUp Scraper: Marketplace Listings, Cars & Deals (`unitbytes/offerup-scraper`) Actor

- **URL**: https://apify.com/unitbytes/offerup-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/unitbytes/offerup-scraper.md

## Changelog

All notable changes to **OfferUp Scraper** will be documented in this file.

### \[1.0.35] - 2026-10-01

#### Fixed

- **URL Search Query Precedence**: Fixed bug where category URLs without a search query silently inherited the form pre-fill query (`"used cars"`). URL parameters now take authoritative precedence, allowing browsing categories/locations without keyword pollution.
- **Pay-Per-Event (PPE) Multi-Event Fallback**: Added robust multi-event fallback for discovery (`search-result`, `listing`, `discovery`, `result`) and detail enrichment (`detail-result`, `detail`, `listing-details`, `result`) with event caching, ensuring 100% billing reliability regardless of Apify Console naming.
- **Proxy 407 Tunnel Fallback**: Added automatic fallback to direct Chrome TLS impersonation when encountering proxy 407 authentication or tunnel drop errors.
- **Customer-Grade Logs**: Removed raw HTTP/curl error codes and internal dictionary logs from INFO level. Added clean discovery confirmation and 0-result live verification link guidance.
- **Input Schema**: Updated `searchQuery` title to `Search Query / Keyword (Optional)` and clarified that leaving it empty browses all items.

### \[1.0.34] - 2026-09-29

#### Added

- **Store Plan Discounts**: Activated automatic Apify subscription tier discounts for paying users:
  - Feed Discovery: $0.80/1k (Free), $0.73/1k (Bronze), $0.67/1k (Silver), $0.60/1k (Gold & Enterprise).
  - Deep Detail Enrichment: $2.50/1k (Free), $2.25/1k (Bronze), $2.00/1k (Silver), $1.80/1k (Gold & Enterprise).
- **Free Monthly Trial Allowance**: Every Apify account receives $5.00 in free monthly credits, enabling up to 6,000 listings extracted free every month.
- **Docker Image Hardening**: Enforced clean container build context, stripping development artifacts and local test scripts.

### \[1.0.33] - 2026-09-28

#### Added

- **Two-Tier Pay-Per-Event (PPE) Pricing**: Separated lightweight discovery ($0.80/1k) from deep detail enrichment ($2.50/1k), cutting costs by up to 68% for high-speed price sweeps.
- **Universal UnitBytes Marketplace Branding**: Upgraded listing banner with verified UnitBytes organization asset integration.
- **SEO & Store Discoverability**: Optimized title, metadata, and category mappings for improved visibility in Apify Store search.

### \[1.0.30] - 2026-09-27

#### Added

- **Smart Scrape 24h Deduplication Engine**: Added cross-run listing memory via persistent Key-Value Store with automatic 24-hour cache retention pruning.
- **Flexible Duplicate Actions**: Added `dedupAction` modes: `"skip"` (only output brand-new listings for clean alerting streams) and `"mark"` (tag existing listings with `isDuplicate: true`).
- **Post Date Recency Filter**: Added `maxAgeHours` parameter to filter listings posted within the last N hours.

### \[1.0.20] - 2026-09-25

#### Added

- **Deep Automotive Specs**: Extracted complete vehicle attributes including VIN, make, model, trim, transmission type, fuel type, title status, and mileage.
- **Direct Listing URL & Raw ID Support**: Seamless support for single item URLs (`/item/detail/<id>`) and raw UUID strings with instant detail auto-enrichment.
- **Seller Reputation Intelligence**: Added seller rating average, review counts, account age, verified badges, and average message response times.

### \[1.0.10] - 2026-09-20

#### Added

- **Multi-Parameter Search Filtering**: Added support for 5-digit US ZIP codes, customizable radius (5–500 miles), minimum/maximum price bounds, and sort orders (newest, distance, price ascending/descending).
- **Category Browse Mode**: Enabled category exploration without requiring a search query.
- **Resilient Request Pipeline**: Integrated automatic proxy session rotation and retry backoff.

### \[1.0.0] - 2026-09-15

#### Added

- Initial public release of OfferUp Scraper on Apify.
- Zero-login local marketplace scraping with 100% free server compute under Pay-Per-Event billing.
- JSON, CSV, and Excel structured data export.
