eSpolubydleni.cz Roommate Listings Scraper

A Crawlee + Cheerio scraper for extracting roommate and shared housing listings from espolubydleni.cz.

Features

• 🏠 Scrapes listings for rooms, apartments, and shared housing
• 📞 Extracts phone numbers from WhatsApp links
• 💰 Parses prices (CZK) and dates (availability/published)
• 📍 Extracts location, district, and detailed amenities
• 📄 Supports pagination and "soft" item limits

Input Parameters

Parameter	Type	Default	Description
searchUrl	string	(Default URL)	Full search URL from espolubydleni.cz with filters applied
maxItems	integer	100	Maximum number of listings to scrape
maxListPages	integer	5	Maximum number of pagination pages to crawl
useApifyProxy	boolean	false	Enable Apify Proxy to avoid blocking

Output Schema

Each listing produces an object with the following structure:

{
  "id": "12345",
  "url": "https://www.espolubydleni.cz/podnajem-spolubydlici/...",
  "location": "Praha",
  "district": "Praha 5",
  "priceCzk": 12000,
  "priceText": "12 000 Kč/měsíc",
  "availableFrom": "01.02.2024",
  "apartmentSize": "2+kk",
  "contactName": "Jan Novák",
  "phoneNumber": "+420 123 456 789",
  "whatsAppUrl": "https://wa.me/420123456789",
  "description": "Full listing description...",
  "amenities": ["Internet", "Washing machine"],
  "scrapedAt": "2024-01-20T12:00:00.000Z"
}

Usage

Local Development

1. Install dependencies: npm install
2. Run the scraper: npm start

Apify Platform

1. Push to Apify: apify push
2. Run on platform: apify run