🇺🇦 Universal OLX UA Scraper (Real Estate Optimized)

🚀 High-performance asynchronous scraper for OLX.ua.
Extracts detailed data from any category (Real Estate, Cars, Electronics, Services) using internal API state, ensuring 100% data accuracy and stability.

---

✨ Key Features

This is not just a text parser. This actor extracts hidden metadata not visible on the page:

• 🌍 Exact GPS Coordinates: Extracts precise latitude and longitude (hidden in map data), perfect for mapping real estate.
• 📊 Price Analytics: Automatically calculates Price per SQM (Price/m²) for real estate listings.
• 🏎 Universal Support: Works perfectly with Apartments, Houses, Cars (Nissan, BMW, etc.), Electronics, and more.
• 👤 Detailed Seller Info: Extracts Seller ID, Registration Date (exact ISO format), Last Seen time, and Business status.
• 🖼 High-Res Images: Retrieves full list of original image URLs without duplicates.
• ⚡ Asynchronous Speed: Built with aiohttp and asyncio for maximum performance with parallel processing.

---

🏠 Why for Real Estate?

If you are a Real Estate Analyst or Agent, this tool provides specific calculated metrics:

Field	Description	Example
price_per_sqm	Calculated price per square meter	292.31 (Currency/m²)
coordinates	Exact GPS location for heatmap generation	{"lat": 50.409, "lon": 30.692}
details	Structured dictionary of all parameters	{"Floor": "4", "Heating": "Central"}
seller.is_business	Distinguish Realtors from Private Owners	true / false

---

🚗 Why for Cars & Others?

For automotive and general listings, the scraper automatically adapts:

• Extracts Mileage, Year, Fuel Type, Transmission into structured details.
• Ignores real-estate specific calculations (sets price_per_sqm to 0).
• Perfect for monitoring car market trends.

---

📥 Input Parameters

The actor accepts a list of URLs and proxy configuration.

Example Input

{
  "startUrls": [
    { "url": "https://www.olx.ua/d/uk/obyavlenie/your-real-estate-link-ID..." },
    { "url": "https://www.olx.ua/d/uk/obyavlenie/your-car-link-ID..." }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

⚠️ Proxy Requirement

OLX has strict anti-bot protection. Residential Proxies (Ukraine or Europe) are highly recommended to avoid 403 errors and CAPTCHAs. Datacenter proxies may work intermittently but are not guaranteed.

---

📤 Output Sample

The scraper returns flat, structured JSON ready for Excel/CSV export.

{
  "id": "906528023",
  "url": "https://www.olx.ua/d/uk/obyavlenie/...",
  "title": "Здам ВПЕРШЕ 2-х кім. в цегляному будинку!",
  "price": 19000,
  "currency": "UAH",
  "price_per_sqm": 292.31,
  "coordinates": {
    "lat": 50.40931,
    "lon": 30.69263
  },
  "location": "Київ, Дарницький",
  "seller": {
    "id": 8806387,
    "name": "Татьяна",
    "created": "2012-05-02T12:53:50+03:00",
    "last_seen": "2025-12-05T18:00:00+02:00",
    "is_business": true,
    "profile_url": "https://www.olx.ua/list/user/8806387/"
  },
  "details": {
    "Поверх": "4",
    "Поверховість": "16",
    "Загальна площа": "65 м²",
    "Площа кухні": "10 м²",
    "Тип стін": "Цегляний",
    "Опалення": "Централізоване",
    "Меблювання": "З меблями"
  },
  "description": "Full description text...",
  "images": [
    "https://ireland.apollo.olxcdn.com:443/v1/files/image1/image",
    "https://ireland.apollo.olxcdn.com:443/v1/files/image2/image"
  ],
  "published_at": "2025-11-15T07:09:54+02:00",
  "status": "active"
}

---

🛠 Technical Info

Parameter	Value
Stability	Does not rely on unstable CSS selectors (class names)
Language	Returns data in Ukrainian (uk-UA)
Performance	Parallel processing with asyncio.gather()
Proxy Support	Full support for Apify Proxy (Residential recommended)

---

🚀 Performance

Thanks to parallel execution with asyncio.gather():

• 1 URL: ~2 seconds
• 10 URLs: ~3 seconds (parallel)
• 100 URLs: ~15-20 seconds (parallel)

Traditional synchronous scrapers would take 200+ seconds for 100 URLs.

---

📋 Common Use Cases

Real Estate Analytics

• Monitor rental/sale prices by district
• Build price heatmaps using GPS coordinates
• Track price trends over time
• Identify business vs. private sellers

Automotive Market Research

• Compare car prices by brand/model
• Monitor mileage vs. price correlation
• Track seller activity

General E-commerce

• Price monitoring for any category
• Seller reputation tracking
• Product availability monitoring

---

🐛 Troubleshooting

Error 403 (Forbidden)

• Cause: IP blocked or CAPTCHA triggered
• Solution: Use Residential proxies or switch proxy groups

Error 410 (Gone)

• Cause: Listing has been deleted
• Solution: This is expected, filter these out in post-processing

Empty Results

• Cause: OLX changed page structure
• Solution: Report in Issues, usually fixed within 24h

---

📞 Support & Feedback

If you have any feature requests or encounter issues, please open an issue. I actively maintain this scraper to ensure compatibility with OLX updates.

---

📄 License

MIT License - feel free to use for commercial purposes.

---

Built with ❤️ for the Ukrainian market