🏠 Imovirtual Property Scraper

Want to pull property listings from Imovirtual, Portugal's leading real estate platform? This scraper makes it super easy!

Set location and filters (property type, buy/rent, price, area, bedrooms) and get structured listings with prices, sizes, agency details, and photos as CSV or JSON.

💡 Perfect for...

• Real Estate Market Analysis: Track property prices and trends across Portugal.
• Lead Generation: Collect agency names and listing contacts for outreach.
• Investment Research: Compare prices by city, type, and size.
• Market Competition: Monitor competitor listings and pricing.
• Property Database: Build your own structured inventory of Portuguese listings.
• 🤖 AI Agents: Power bots and workflows with filter-based search.
• 📚 RAG Systems: Feed listing specs and descriptions into retrieval pipelines.

✨ Why you'll love this scraper

• 🎯 Flexible Filters: Location, property type, buy/rent, price range, area, and bedrooms.
• 📊 Rich Listings: Title, price, price per m², size, rooms, floor, agency, photos, and flags.
• 🔁 Pagination: Collects listings across result pages until max_properties is reached.

📦 What's inside the data?

For every listing you get:

• Core: id, title, url, description
• Location: full_address, province
• Pricing & Size: price, price_per_square_meter, area_square_meter, terrain_area_square_meter
• Details: rooms_number, floor_number, date_created
• Agency & Media: agency_id, agency_name, first_photo, number_of_photos
• Flags: is_private_owner, is_promoted, is_exclusive_offer

🚀 Quick start

1. Set search_location (e.g. Lisboa, Porto, Braga).
2. Pick property_type and listing_type (buy or rent).
3. Optionally set price, area, and bedrooms.
4. Set max_properties and click Start.

Export JSON, CSV, or Excel when done.

---

Tech details for developers 🧑‍💻

Input Example

{
  "search_location": "Lisboa",
  "property_type": "apartment",
  "listing_type": "buy",
  "min_price": 50000,
  "max_price": 500000,
  "min_sqft": 50,
  "max_sqft": 100,
  "number_of_bedrooms": 1,
  "max_properties": 100
}

Output Example

{
  "id": 18668154,
  "title": "Apartamento T0 espaçoso com terraço, em São Bento, Lisboa",
  "url": "https://www.imovirtual.com/pt/anuncio/apartamento-t0-espacoso-com-terraco-em-sao-bento-lisboa-ID1gkrg",
  "description": "O projeto São Bento 21...",
  "full_address": "Rua de São Bento 123, Misericórdia, Lisboa",
  "province": "Lisboa",
  "first_photo": "https://...",
  "number_of_photos": 13,
  "agency_id": 3456674,
  "agency_name": "Infante & Riu - Portugal Real Estate",
  "price": 450000,
  "price_per_square_meter": 7759,
  "area_square_meter": 58,
  "rooms_number": "ONE",
  "floor_number": "GROUND",
  "date_created": "2025-08-04 21:00:37",
  "is_private_owner": false,
  "is_promoted": false,
  "is_exclusive_offer": false
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
search_location	string	Yes	Lisboa	Location to search (e.g. Lisboa, Porto, Braga).
property_type	string enum	Yes	apartment	apartment, house, studio, building, room, land, commercial, office/warehouse, garage.
listing_type	string enum	Yes	buy	buy or rent.
min_price / max_price	integer	No	—	Price bounds in euros.
min_sqft / max_sqft	integer	No	—	Area bounds in m².
number_of_bedrooms	integer	No	1	Number of bedrooms (1–6).
max_properties	integer	No	100	How many listings to return (1–300).

Notes

• Each run returns at most max_properties listings.
• Narrow filters (location, price, type) if you need a focused dataset.