# Changelog of OpenSooq Scraper السوق المفتوح: MENA Data API (`getascraper/opensooq-scraper`) Actor

- **URL**: https://apify.com/getascraper/opensooq-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/getascraper/opensooq-scraper.md

## Changelog

All notable changes to this project will be documented in this file.

### \[0.2.0] - 2026-07-26

#### Added

- 🚗 Added a source-validated Saudi Cars for Sale route with model-year and OpenSooq mileage-band filters.
- 🏠 Added Saudi apartment sale and rent routes with bedroom, bathroom, and square-metre surface filters.
- 🧭 Added runtime validation for vertical-specific filters, numeric location IDs, sort compatibility, and inverted ranges.
- 🔗 Added URL-builder coverage for guided routes, legacy category-ID compatibility, invalid combinations, and exact-URL precedence.

#### Fixed

- 🧩 Replaced ignored query names such as `priceFrom`, `sortBy`, and `hasImages` with OpenSooq's live URL format, including `price_from`, `sort_code`, and `has_images=1`.
- 📍 Updated the guided category IDs to the IDs exposed by OpenSooq's current search response while continuing to accept previous Actor category IDs through the API.

### \[0.1.4] - 2026-07-26

#### Improved

- 🔎 Added bilingual search coverage for OpenSooq, السوق المفتوح, Saudi used-car data, and MENA real-estate listings.
- 💳 Corrected the Store description to match the active Free-tier rate of $0.89 per 1,000 successfully saved listings.

### \[0.1.3] - 2026-07-26

#### Improved

- 🚗 Changed the Store prefill to a focused ten-listing Saudi Arabia Toyota search in the vehicle category.
- 🧭 Corrected input-form guidance so it consistently refers to marketplace listings.
- 🔌 Preserved the existing default API query for backward compatibility.

### \[0.1.2] - 2026-07-26

#### Improved

- 🗂️ Added five task-focused dataset views: **🔎 Listings**, **🚗 Vehicle Specs**, **🏠 Property Leads**, **🏪 Seller Signals**, and **📊 Market Monitor**.
- ✨ Each view foregrounds genuine price, location, property or vehicle, seller, status, date, and source-link fields without adding or inferring data.

#### Pricing

- 💳 Corrected documentation to match deployed pricing: **$0.89 / $0.82 / $0.74 / $0.67 per 1,000 successfully saved listings** for Free, Bronze, Silver, and Gold respectively, plus the small Actor Start event.

### \[0.1.1] - 2026-07-25

#### Fixed

- 🔒 Enforced `maxItems` as one atomic run-wide cap across concurrent searches.
- 🆔 Deduplicated listing IDs across pages, queries, and exact start URLs.
- 🩺 Classified blocked responses, malformed JSON, source-shape changes, partial phone-reveal failures, and genuine empty searches separately.
- 📦 Preserved valid listings when optional phone reveal fails.

#### Pricing

- 💰 See version 0.1.2 for current deployed pricing.