🏠 home.al Scraper

Want property listings from home.al across Albania and Kosovo? This scraper makes it easy.

Use structured filters (sale/rent/B&B, type, location, price, area) — structured filters work better for AI agents — or paste an input_url from your browser once you've already filtered on home.al. When input_url is set it overrides the filters below. Either way, you get clean CSV/JSON with prices, specs, photos, phones, and emails.

💡 Perfect for...

• Buyers & Investors: Track apartments and villas in Tirana, Prishtina, Durrës, and more.
• Estate Agencies: Monitor competitor listings and collect contact leads.
• Market Research: Analyze EUR pricing and supply by city or category.
• Data Analysts: Export structured home.al data for dashboards and models.
• 🤖 AI Agents: Power bots and OpenClaw workflows with live home.al results.
• 📚 RAG Systems: Feed titles, locations, and prices into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a home.al search URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 Website-Matched Filters: Listing type, category, price, area, and sort use the same query params as home.al.
• 📍 Location Suggest Dictionary: Free-text cities/districts (Tirana, Tiranë, Prishtina, …) resolve through the site’s embedded administrative divisions.
• 📞 Phone + Email on Cards: Pulls call/email contacts when the listing card exposes them.
• 🇦🇱🇽🇰 Albania & Kosovo: Covers Blej, Qira, and B&B across both markets.

📦 What's inside the data?

For every property listing, you will get:

• Core Details: id, url, transaction, property_type, title, badge
• Pricing: price, price_label, price_currency (EUR)
• Specs: area_m2, bedrooms, bathrooms, parking_spaces
• Location: location, street, district, city
• Contact / Media: agency_name, phone, email, listed_on, image_url

🛠️ Sort options

Use sort_by with these values:

• (empty) – Newest (default)
• date_asc – Oldest
• price_asc / price_desc – Price low→high / high→low

🚀 Quick start

Option A — Input URL

1. Open home.al, apply filters in the browser, copy the results URL — e.g. https://www.home.al/en/listings/sale/?category=apartment&location_id=451&price_max=150000.
2. Paste it into input_url.
3. Set max_properties and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Set listing type, property type, location, and optional price / area / sort.
3. Set max_properties (up to 2000) and click Start.

Export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "listing_type": "sale",
  "property_type": "apartment",
  "location": "Tirana",
  "price_min": 50000,
  "price_max": 150000,
  "sort_by": "price_asc",
  "max_properties": 100
}

Input Example (URL override):

{
  "input_url": "https://www.home.al/en/listings/rent/?category=apartment&location_id=451",
  "max_properties": 50
}

Output Example:

{
  "id": "01kz3jqq2fmvwvc7smwf8xygx7",
  "url": "https://www.home.al/en/listings/01kz3jqq2fmvwvc7smwf8xygx7/",
  "transaction": "sale",
  "property_type": "apartment",
  "title": "Apartment",
  "price": 123000,
  "price_currency": "EUR",
  "area_m2": 58,
  "bedrooms": 1,
  "bathrooms": 1,
  "location": "Rruga Sokrat Miho • Kashar • Tiranë",
  "city": "Tiranë",
  "agency_name": "Merlin Imobiliare Agjensi Imobiliare",
  "phone": "+355684044520",
  "email": "info@merlinimobiliare.com",
  "image_url": "https://cdn.home.al/ul/..."
}