OLX.ua Property Search Scraper & Parser

A fast, highly optimized, and robust hybrid web scraper for extracting real estate listing details from olx.ua (Ukraine's leading classifieds platform).

Designed to bypass anti-bot detections, rotate proxy IPs, filter out unwanted recommended listings, and scale efficiently.

---

🚀 Key Features

• Hybrid Architecture (High Speed & Low Cost): Scrapes search catalog pages and details using fast HTTP requests, utilizing browser automation (Playwright) as a targeted fallback if direct requests are blocked.
• Apify Proxy Integration: Native support for Apify Residentials and rotating proxy pools to bypass anti-bot challenges and IP blocks.
• Smart Filtering: Automatically identifies the separator banner (e.g. "Look at results for a larger distance") and filters out all recommended/suggested listings from other cities, keeping only relevant search matches.
• Concurrent Scraping (Semaphore Control): Fetches property details in parallel (default: 4 concurrent tasks) to speed up crawling without overloading the target server.
• Single & Multi-Listing Support: Scrapes entire search lists (with pagination support) or processes a single listing URL.

---

📥 Input Parameters

Define search targets in the Apify Console with the following parameters:

Field Name	Type	Description	Default
url	String	Required. OLX.ua search category URL or a direct listing URL.	https://www.olx.ua/uk/nedvizhimost/prodazha-kvartir/kiev/
include_phone	Boolean	Whether to extract owner/agency phone numbers (requires more proxy/browser resources).	false
max_pages	Integer	Maximum search pages to crawl (0 = unlimited).	0
max_items	Integer	Maximum property objects to scrape (0 = unlimited).	0
proxyConfiguration	Object	Proxy configuration settings. Recommended to enable Apify Proxy.	{"useApifyProxy": true}

---

📤 Output Structure

The output is exported in a structured JSON format to the Apify Dataset. Each item contains:

{
  "page_number": 1,
  "link": "https://www.olx.ua/d/uk/obyavlenie/prodatsya-dvokmnatna-kvartira-ID10x6jh.html",
  "title": "Продається двокімнатна квартира",
  "id": "olx_10x6jh",
  "price": "40 000 $",
  "location_date": "OLX",
  "image": "https://ireland.apollo.olxcdn.com:443/v1/files/y0h4ymoszu8i3-UA/image;s=750x1000",
  "description": "Продається двокімнатна квартира заг.пл. 50м2, також є підвал під кімнатою 14 м2...",
  "photos": [
    "https://ireland.apollo.olxcdn.com:443/v1/files/y0h4ymoszu8i3-UA/image;s=750x1000",
    "https://ireland.apollo.olxcdn.com:443/v1/files/ko3j5wozde8a-UA/image;s=750x1000"
  ],
  "phones": [],
  "user_name": "АН ФОП Суржок Євгеній",
  "params": [
    {
      "name": "Вид об'єкта",
      "value": "Вторинний ринок"
    },
    {
      "name": "Загальна площа",
      "value": "50 м²"
    }
  ]
}

---

💼 Ideal For:

• Real Estate Agencies: Track competitor pricing, new properties, and market changes.
• Investment Analytics: Monitor average price per square meter across different regions/cities.
• CRM Integrations: Feed qualified buyer leads directly into your database.