{
  "data": {
    "id": "LNFor5LdH4n7klqTp",
    "actId": "PBuY58X41MQGWJZmc",
    "userId": "4BicJNfmk8uEe3GtT",
    "startedAt": "2026-11-19T15:30:01.104Z",
    "finishedAt": "2026-11-19T15:30:05.644Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 4471,
      "runTimeSecs": 4.471,
      "computeUnits": 0.0049677777777777776,
      "imageSizeBytes": 358347776
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "chIfRjofLtMMYtdFe",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Imovirtual Portugal Rent and Sale Listings Input\",\n  \"description\": \"Search Imovirtual.com rent and sale listings by location, property type and filters, or scrape search and listing URLs directly.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"How to find listings. Browse rent or sale listings, search by keyword, or paste Imovirtual URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"forRent\",\n        \"forSale\",\n        \"search\",\n        \"byUrl\"\n      ],\n      \"enumTitles\": [\n        \"For rent\",\n        \"For sale\",\n        \"Keyword search\",\n        \"Specific Imovirtual URLs\"\n      ],\n      \"default\": \"forRent\",\n      \"prefill\": \"forRent\"\n    },\n    \"propertyType\": {\n      \"title\": \"Property type\",\n      \"type\": \"string\",\n      \"description\": \"Property category. Any type searches every category one by one.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"apartment\",\n        \"house\",\n        \"land\",\n        \"garage\",\n        \"commercial\",\n        \"office\",\n        \"warehouse\",\n        \"room\",\n        \"development\"\n      ],\n      \"enumTitles\": [\n        \"Any type\",\n        \"Apartment\",\n        \"House or villa\",\n        \"Land\",\n        \"Garage or parking\",\n        \"Commercial property\",\n        \"Office\",\n        \"Warehouse\",\n        \"Room (rent only)\",\n        \"New development (sale only)\"\n      ],\n      \"default\": \"apartment\",\n      \"prefill\": \"apartment\"\n    },\n    \"transactionType\": {\n      \"title\": \"Transaction type (keyword search)\",\n      \"type\": \"string\",\n      \"description\": \"Rent or sale for mode=search. The For rent and For sale modes set this automatically.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"rent\",\n        \"sale\"\n      ],\n      \"enumTitles\": [\n        \"For rent\",\n        \"For sale\"\n      ],\n      \"default\": \"rent\",\n      \"prefill\": \"rent\"\n    },\n    \"location\": {\n      \"title\": \"Location\",\n      \"type\": \"string\",\n      \"description\": \"City, district, council or parish. Examples: Lisboa, Porto, Faro, lisboa/sintra, lisboa/lisboa/benfica. Leave empty for all Portugal.\",\n      \"editor\": \"textfield\",\n      \"default\": \"Lisboa\",\n      \"prefill\": \"Lisboa\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Keyword\",\n      \"type\": \"string\",\n      \"description\": \"Optional words to find in listing descriptions, e.g. piscina, varanda, garagem. Also used by mode=search.\",\n      \"editor\": \"textfield\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price (EUR)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum monthly rent or total sale price in euros.\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price (EUR)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum monthly rent or total sale price in euros.\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"minArea\": {\n      \"title\": \"Minimum area (m2)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum usable floor area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"maxArea\": {\n      \"title\": \"Maximum area (m2)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum usable floor area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"rooms\": {\n      \"title\": \"Typology\",\n      \"type\": \"array\",\n      \"description\": \"One or more Portuguese typologies: T0 is a studio, T3 has three bedrooms. Matches any selected value.\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"ONE\",\n          \"TWO\",\n          \"THREE\",\n          \"FOUR\",\n          \"FIVE\",\n          \"SIX_OR_MORE\"\n        ],\n        \"enumTitles\": [\n          \"T0\",\n          \"T1\",\n          \"T2\",\n          \"T3\",\n          \"T4\",\n          \"T5+\"\n        ]\n      },\n      \"default\": [],\n      \"prefill\": [],\n      \"uniqueItems\": true\n    },\n    \"extras\": {\n      \"title\": \"Features\",\n      \"type\": \"array\",\n      \"description\": \"Only return listings with any of these features.\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"IS_PRIVATE_OWNER\",\n          \"LIFT\",\n          \"GARAGE\",\n          \"AIR_CONDITIONING\",\n          \"BALCONY\",\n          \"TERRACE\",\n          \"HAS_PHOTOS\",\n          \"INTERNET\",\n          \"GARDEN\",\n          \"CABLE_TELEVISION\",\n          \"SEPARATE_KITCHEN\"\n        ],\n        \"enumTitles\": [\n          \"Private owner\",\n          \"Lift\",\n          \"Garage\",\n          \"Air conditioning\",\n          \"Balcony\",\n          \"Terrace\",\n          \"Has photos\",\n          \"Internet\",\n          \"Garden\",\n          \"Cable television\",\n          \"Separate kitchen\"\n        ]\n      },\n      \"default\": [],\n      \"prefill\": [],\n      \"uniqueItems\": true\n    },\n    \"privateOwnerOnly\": {\n      \"title\": \"Private owners only\",\n      \"type\": \"boolean\",\n      \"description\": \"Skip agency listings and keep only properties posted by private owners.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"daysSinceCreated\": {\n      \"title\": \"Listed within\",\n      \"type\": \"string\",\n      \"description\": \"Only include listings first published within this period.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"1\",\n        \"3\",\n        \"7\"\n      ],\n      \"enumTitles\": [\n        \"Any time\",\n        \"Last 24 hours\",\n        \"Last 3 days\",\n        \"Last 7 days\"\n      ],\n      \"default\": \"any\",\n      \"prefill\": \"any\"\n    },\n    \"buildYearMin\": {\n      \"title\": \"Built from year\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum construction year.\",\n      \"minimum\": 1800,\n      \"maximum\": 2100\n    },\n    \"buildYearMax\": {\n      \"title\": \"Built until year\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum construction year.\",\n      \"minimum\": 1800,\n      \"maximum\": 2100\n    },\n    \"floorsNumberMin\": {\n      \"title\": \"Building floors from\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum number of floors in the building.\",\n      \"minimum\": 0,\n      \"maximum\": 200\n    },\n    \"floorsNumberMax\": {\n      \"title\": \"Building floors until\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of floors in the building.\",\n      \"minimum\": 0,\n      \"maximum\": 200\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Order of the results.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"newest\",\n        \"oldest\",\n        \"priceAsc\",\n        \"priceDesc\",\n        \"areaAsc\",\n        \"areaDesc\"\n      ],\n      \"enumTitles\": [\n        \"Relevance\",\n        \"Newest first\",\n        \"Oldest first\",\n        \"Price: low to high\",\n        \"Price: high to low\",\n        \"Area: small to large\",\n        \"Area: large to small\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"listingUrls\": {\n      \"title\": \"Imovirtual URLs (mode=byUrl)\",\n      \"type\": \"array\",\n      \"description\": \"Search result or listing URLs. Search URLs are paginated; listing URLs produce one record each. Examples: https://www.imovirtual.com/pt/resultados/arrendar/apartamento/lisboa/lisboa and https://www.imovirtual.com/pt/anuncio/... .\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"includeDetails\": {\n      \"title\": \"Fetch full listing details\",\n      \"type\": \"boolean\",\n      \"description\": \"Open each listing page for description, bathrooms, energy certificate, build year, amenities, GPS coordinates and agency details. Turn off for faster bulk runs.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"maxItems\": {\n      \"title\": \"Max listings\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listing records to save.\",\n      \"minimum\": 1,\n      \"maximum\": 50000,\n      \"default\": 20,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Imovirtual Portugal Rent & Sale Listing Scraper\n\nImovirtual is one of Portugal's largest real-estate portals. This actor collects its public rent and sale listings: apartments, houses, land, garages, commercial property, offices, warehouses, rooms and new developments. Build a search from a location and filters, use a keyword, or paste Imovirtual search and listing URLs.\n\n## What this actor does\n\n- **Browse rent or sale listings** by location and property type without constructing a URL.\n- **Search by keyword** in listing descriptions, such as `piscina`, `varanda` or `garagem`.\n- **Scrape your own Imovirtual URLs**: search-result URLs are paginated from page to page, and individual listing URLs produce one record each.\n- **Apply the site's own filters** for price, area, typology, features, private-owner status, listing age, build year and building floors, plus sort order.\n- **Avoid duplicate rows** when pages, sponsored placements or multiple URLs overlap.\n- **Enrich every listing** with its detail page by default: description, bathrooms, energy certificate, construction year, building details, amenities, equipment, GPS coordinates, floor plans and agency contact details.\n- **Returns one flat record per listing** with prices as numbers, ISO dates, absolute URLs and omit-empty fields.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `forRent` | `forRent`, `forSale`, `search` or `byUrl`. |\n| `propertyType` | select | `apartment` | `any`, `apartment`, `house`, `land`, `garage`, `commercial`, `office`, `warehouse`, `room` or `development`. |\n| `transactionType` | select | `rent` | `rent` or `sale`; used by `search` mode. |\n| `location` | text | `Lisboa` | Council or city, e.g. `Porto`, `faro`. Use `faro/*` for a whole district and a full path for a parish, e.g. `lisboa/lisboa/benfica`. Empty means all Portugal. |\n| `searchQuery` | text | – | Words to find in listing descriptions. Also used by `search` mode. |\n| `minPrice` | integer | – | Minimum monthly rent or total sale price in EUR. |\n| `maxPrice` | integer | – | Maximum monthly rent or total sale price in EUR. |\n| `minArea` | integer | – | Minimum usable area in m2. |\n| `maxArea` | integer | – | Maximum usable area in m2. |\n| `rooms` | multi-select | `[]` | Typologies to include: `T0`, `T1`, `T2`, `T3`, `T4`, `T5+`. |\n| `extras` | multi-select | `[]` | Features to require: private owner, lift, garage, air conditioning, balcony, terrace, photos, internet, garden, cable TV, separate kitchen. |\n| `privateOwnerOnly` | boolean | `false` | Keep only private-owner listings. |\n| `daysSinceCreated` | select | `any` | `any`, `1`, `3` or `7` days. |\n| `buildYearMin` | integer | – | Minimum construction year. |\n| `buildYearMax` | integer | – | Maximum construction year. |\n| `floorsNumberMin` | integer | – | Minimum number of floors in the building. |\n| `floorsNumberMax` | integer | – | Maximum number of floors in the building. |\n| `sortBy` | select | `relevance` | `relevance`, `newest`, `oldest`, `priceAsc`, `priceDesc`, `areaAsc` or `areaDesc`. |\n| `listingUrls` | string list | `[]` | Imovirtual search or listing URLs for `byUrl` mode. |\n| `includeDetails` | boolean | `true` | Open each listing page for the full record. Turn off for faster bulk collection. |\n| `maxItems` | integer | `20` | Maximum number of listings to save, up to 50,000. |\n\n### Example: apartments for rent in Lisbon under EUR 2,000\n\n```json\n{\n  \"mode\": \"forRent\",\n  \"propertyType\": \"apartment\",\n  \"location\": \"Lisboa\",\n  \"maxPrice\": 2000,\n  \"rooms\": [\"T1\", \"T2\"],\n  \"sortBy\": \"priceAsc\",\n  \"maxItems\": 100\n}\n```\n\n### Example: houses for sale in Porto with three or more bedrooms\n\n```json\n{\n  \"mode\": \"forSale\",\n  \"propertyType\": \"house\",\n  \"location\": \"Porto\",\n  \"rooms\": [\"T3\", \"T4\", \"T5+\"],\n  \"includeDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: keyword search for swimming pools in the Algarve\n\n```json\n{\n  \"mode\": \"search\",\n  \"transactionType\": \"sale\",\n  \"propertyType\": \"house\",\n  \"location\": \"faro\",\n  \"searchQuery\": \"piscina\",\n  \"maxItems\": 50\n}\n```\n\n### Example: scrape search and listing URLs directly\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"listingUrls\": [\n    \"https://www.imovirtual.com/pt/resultados/arrendar/apartamento/lisboa/lisboa?priceMin=1000&priceMax=1500\",\n    \"https://www.imovirtual.com/pt/anuncio/apartamento-t3-em-areeiro-de-126-00-m2-ID1iXZM\"\n  ],\n  \"maxItems\": 40\n}\n```\n\n## Output per listing\n\n- `listingId`, `title`, `listingUrl`\n- `propertyType`, `transactionType`, `isDevelopment`, `developmentTitle`, `developmentUrl`\n- `price`, `currency`, `pricePerSqm`, `priceType`, `rentPrice`\n- `area`, `terrainArea`\n- `rooms`, `bedrooms`, `typology`, `floor`, `floorLabel`, `bathrooms`\n- `address`, `city`, `council`, `district`, `parish`, `neighborhood`, `postalCode`\n- `latitude`, `longitude`\n- `energyCertificate`, `buildYear`, `buildingFloors`, `buildingType`, `constructionStatus`, `usageLicense`, `market`, `availableFrom`\n- `description`\n- `features`, `amenities`, `equipment`, `security`\n- `imageUrls`, `imageCount`, `floorPlanUrls`, `videoUrl`, `virtualTourUrl`\n- `agencyName`, `agencyId`, `agencyUrl`, `agencyType`, `agencyLicenseNumber`, `agentName`, `advertiserType`, `advertiserAddress`\n- `isPrivateOwner`, `isPromoted`, `isExclusiveOffer`, `isCrossListed`, `hasVideo`, `hasVirtualTour`, `hasFloorPlan`\n- `dateCreated`, `firstListedAt`, `modifiedAt`, `pushedUpAt`\n- `sourceUrl`, `recordType`, `scrapedAt`\n\nFields a listing does not carry are omitted rather than returned as null or empty.\n\n## Use cases\n\n- Track asking prices and price per square metre across districts, councils and parishes.\n- Shortlist rentals by budget, typology and features before contacting agents.\n- Collect private-owner listings for lead generation.\n- Monitor new listings by listing age and sort order.\n- Compare resale and new-development inventory.\n- Build a repeatable Portugal housing-market dataset for analysis or valuation models.\n\n## FAQ\n\n**Do I need an account, cookies or an API key?**\nNo. The actor reads Imovirtual's public listing pages and detail pages without login.\n\n**What is the difference between the modes?**\n`forRent` and `forSale` build the search from `location`, `propertyType` and the filters. `search` adds a description keyword and uses `transactionType`. `byUrl` ignores the builder fields and scrapes the URLs you provide.\n\n**Why are some fields missing on some listings?**\nImovirtual only publishes what the seller supplied. A listing without an energy certificate has no `energyCertificate`; a private-owner listing has no agency fields. The actor omits those fields instead of inventing values.\n\n**Why does `rooms` differ from `bedrooms`?**\nImovirtual's room count includes the living room, so a Portuguese T2 usually has `rooms: 3` and `bedrooms: 2`. `typology` gives the familiar T number directly.\n\n**How many listings can one search return?**\nThe site paginates 36 listings at a time and exposes thousands of pages in broad searches. The actor keeps paging until `maxItems` is reached or the search is exhausted, and removes duplicate listings across pages and URLs.\n\n**How do I search a whole district instead of one council?**\nUse a slash and asterisk, e.g. `faro/*` for the Faro district or `lisboa/*` for the Lisbon district. A plain `Lisboa` searches the Lisbon council.\n\n**What does `propertyType: any` do?**\nIt visits every compatible Imovirtual category in turn and mixes the results: apartments, houses, land, garages, commercial property, offices, warehouses and rooms for rent, or new developments for sale. Rooms are rent-only and developments are sale-only on Imovirtual.\n\n**Does the actor use a proxy?**\nIt normally connects directly. If Imovirtual blocks a request, it retries and can fall back to Apify Proxy automatically; no proxy setup is required from you.\n\n**Are phone numbers included?**\nNo. Phone numbers are not part of the public listing data returned by the pages this actor reads.\n\n**Is this affiliated with Imovirtual?**\nNo. This is an independent, third-party actor that reads publicly available Imovirtual listing pages.\n\n## Limitations\n\n- Some Imovirtual filters (heating type, building type, floor level, availability window and map radius) are not exposed as actor inputs.\n- A plain `location` value resolves as a council. Use `faro/*` for a whole district and the site's path form for a parish, e.g. `lisboa/lisboa/benfica`.\n- English location aliases are provided for Lisbon and Oporto; other locations should use their Portuguese names.\n- Detail fields such as bathrooms, reference ID, build year, floor plans and video are present only when the seller or agency published them.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "imovirtual-portugal-rent-and-sale-listing-scraper",
      "title": "Imovirtual Portugal Rent & Sale Listing Scraper",
      "description": "Scrape Imovirtual rent and sale listings across Portugal: apartments, houses, land, garages, commercial space, offices, warehouses, rooms and developments, filtered by location, price, area, typology and features, with photos and agency details.",
      "version": "2.0",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# Imovirtual Portugal Rent & Sale Listing Scraper\n\nImovirtual is one of Portugal's largest real-estate portals. This actor collects its public rent and sale listings: apartments, houses, land, garages, commercial property, offices, warehouses, rooms and new developments. Build a search from a location and filters, use a keyword, or paste Imovirtual search and listing URLs.\n\n## What this actor does\n\n- **Browse rent or sale listings** by location and property type without constructing a URL.\n- **Search by keyword** in listing descriptions, such as `piscina`, `varanda` or `garagem`.\n- **Scrape your own Imovirtual URLs**: search-result URLs are paginated from page to page, and individual listing URLs produce one record each.\n- **Apply the site's own filters** for price, area, typology, features, private-owner status, listing age, build year and building floors, plus sort order.\n- **Avoid duplicate rows** when pages, sponsored placements or multiple URLs overlap.\n- **Enrich every listing** with its detail page by default: description, bathrooms, energy certificate, construction year, building details, amenities, equipment, GPS coordinates, floor plans and agency contact details.\n- **Returns one flat record per listing** with prices as numbers, ISO dates, absolute URLs and omit-empty fields.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `forRent` | `forRent`, `forSale`, `search` or `byUrl`. |\n| `propertyType` | select | `apartment` | `any`, `apartment`, `house`, `land`, `garage`, `commercial`, `office`, `warehouse`, `room` or `development`. |\n| `transactionType` | select | `rent` | `rent` or `sale`; used by `search` mode. |\n| `location` | text | `Lisboa` | Council or city, e.g. `Porto`, `faro`. Use `faro/*` for a whole district and a full path for a parish, e.g. `lisboa/lisboa/benfica`. Empty means all Portugal. |\n| `searchQuery` | text | – | Words to find in listing descriptions. Also used by `search` mode. |\n| `minPrice` | integer | – | Minimum monthly rent or total sale price in EUR. |\n| `maxPrice` | integer | – | Maximum monthly rent or total sale price in EUR. |\n| `minArea` | integer | – | Minimum usable area in m2. |\n| `maxArea` | integer | – | Maximum usable area in m2. |\n| `rooms` | multi-select | `[]` | Typologies to include: `T0`, `T1`, `T2`, `T3`, `T4`, `T5+`. |\n| `extras` | multi-select | `[]` | Features to require: private owner, lift, garage, air conditioning, balcony, terrace, photos, internet, garden, cable TV, separate kitchen. |\n| `privateOwnerOnly` | boolean | `false` | Keep only private-owner listings. |\n| `daysSinceCreated` | select | `any` | `any`, `1`, `3` or `7` days. |\n| `buildYearMin` | integer | – | Minimum construction year. |\n| `buildYearMax` | integer | – | Maximum construction year. |\n| `floorsNumberMin` | integer | – | Minimum number of floors in the building. |\n| `floorsNumberMax` | integer | – | Maximum number of floors in the building. |\n| `sortBy` | select | `relevance` | `relevance`, `newest`, `oldest`, `priceAsc`, `priceDesc`, `areaAsc` or `areaDesc`. |\n| `listingUrls` | string list | `[]` | Imovirtual search or listing URLs for `byUrl` mode. |\n| `includeDetails` | boolean | `true` | Open each listing page for the full record. Turn off for faster bulk collection. |\n| `maxItems` | integer | `20` | Maximum number of listings to save, up to 50,000. |\n\n### Example: apartments for rent in Lisbon under EUR 2,000\n\n```json\n{\n  \"mode\": \"forRent\",\n  \"propertyType\": \"apartment\",\n  \"location\": \"Lisboa\",\n  \"maxPrice\": 2000,\n  \"rooms\": [\"T1\", \"T2\"],\n  \"sortBy\": \"priceAsc\",\n  \"maxItems\": 100\n}\n```\n\n### Example: houses for sale in Porto with three or more bedrooms\n\n```json\n{\n  \"mode\": \"forSale\",\n  \"propertyType\": \"house\",\n  \"location\": \"Porto\",\n  \"rooms\": [\"T3\", \"T4\", \"T5+\"],\n  \"includeDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n### Example: keyword search for swimming pools in the Algarve\n\n```json\n{\n  \"mode\": \"search\",\n  \"transactionType\": \"sale\",\n  \"propertyType\": \"house\",\n  \"location\": \"faro\",\n  \"searchQuery\": \"piscina\",\n  \"maxItems\": 50\n}\n```\n\n### Example: scrape search and listing URLs directly\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"listingUrls\": [\n    \"https://www.imovirtual.com/pt/resultados/arrendar/apartamento/lisboa/lisboa?priceMin=1000&priceMax=1500\",\n    \"https://www.imovirtual.com/pt/anuncio/apartamento-t3-em-areeiro-de-126-00-m2-ID1iXZM\"\n  ],\n  \"maxItems\": 40\n}\n```\n\n## Output per listing\n\n- `listingId`, `title`, `listingUrl`\n- `propertyType`, `transactionType`, `isDevelopment`, `developmentTitle`, `developmentUrl`\n- `price`, `currency`, `pricePerSqm`, `priceType`, `rentPrice`\n- `area`, `terrainArea`\n- `rooms`, `bedrooms`, `typology`, `floor`, `floorLabel`, `bathrooms`\n- `address`, `city`, `council`, `district`, `parish`, `neighborhood`, `postalCode`\n- `latitude`, `longitude`\n- `energyCertificate`, `buildYear`, `buildingFloors`, `buildingType`, `constructionStatus`, `usageLicense`, `market`, `availableFrom`\n- `description`\n- `features`, `amenities`, `equipment`, `security`\n- `imageUrls`, `imageCount`, `floorPlanUrls`, `videoUrl`, `virtualTourUrl`\n- `agencyName`, `agencyId`, `agencyUrl`, `agencyType`, `agencyLicenseNumber`, `agentName`, `advertiserType`, `advertiserAddress`\n- `isPrivateOwner`, `isPromoted`, `isExclusiveOffer`, `isCrossListed`, `hasVideo`, `hasVirtualTour`, `hasFloorPlan`\n- `dateCreated`, `firstListedAt`, `modifiedAt`, `pushedUpAt`\n- `sourceUrl`, `recordType`, `scrapedAt`\n\nFields a listing does not carry are omitted rather than returned as null or empty.\n\n## Use cases\n\n- Track asking prices and price per square metre across districts, councils and parishes.\n- Shortlist rentals by budget, typology and features before contacting agents.\n- Collect private-owner listings for lead generation.\n- Monitor new listings by listing age and sort order.\n- Compare resale and new-development inventory.\n- Build a repeatable Portugal housing-market dataset for analysis or valuation models.\n\n## FAQ\n\n**Do I need an account, cookies or an API key?**\nNo. The actor reads Imovirtual's public listing pages and detail pages without login.\n\n**What is the difference between the modes?**\n`forRent` and `forSale` build the search from `location`, `propertyType` and the filters. `search` adds a description keyword and uses `transactionType`. `byUrl` ignores the builder fields and scrapes the URLs you provide.\n\n**Why are some fields missing on some listings?**\nImovirtual only publishes what the seller supplied. A listing without an energy certificate has no `energyCertificate`; a private-owner listing has no agency fields. The actor omits those fields instead of inventing values.\n\n**Why does `rooms` differ from `bedrooms`?**\nImovirtual's room count includes the living room, so a Portuguese T2 usually has `rooms: 3` and `bedrooms: 2`. `typology` gives the familiar T number directly.\n\n**How many listings can one search return?**\nThe site paginates 36 listings at a time and exposes thousands of pages in broad searches. The actor keeps paging until `maxItems` is reached or the search is exhausted, and removes duplicate listings across pages and URLs.\n\n**How do I search a whole district instead of one council?**\nUse a slash and asterisk, e.g. `faro/*` for the Faro district or `lisboa/*` for the Lisbon district. A plain `Lisboa` searches the Lisbon council.\n\n**What does `propertyType: any` do?**\nIt visits every compatible Imovirtual category in turn and mixes the results: apartments, houses, land, garages, commercial property, offices, warehouses and rooms for rent, or new developments for sale. Rooms are rent-only and developments are sale-only on Imovirtual.\n\n**Does the actor use a proxy?**\nIt normally connects directly. If Imovirtual blocks a request, it retries and can fall back to Apify Proxy automatically; no proxy setup is required from you.\n\n**Are phone numbers included?**\nNo. Phone numbers are not part of the public listing data returned by the pages this actor reads.\n\n**Is this affiliated with Imovirtual?**\nNo. This is an independent, third-party actor that reads publicly available Imovirtual listing pages.\n\n## Limitations\n\n- Some Imovirtual filters (heating type, building type, floor level, availability window and map radius) are not exposed as actor inputs.\n- A plain `location` value resolves as a council. Use `faro/*` for a whole district and the site's path form for a parish, e.g. `lisboa/lisboa/benfica`.\n- English location aliases are provided for Lisbon and Oporto; other locations should use their Portuguese names.\n- Detail fields such as bathrooms, reference ID, build year, floor plans and video are present only when the seller or agency published them.\n",
      "input": {
        "title": "Imovirtual Portugal Rent and Sale Listings Input",
        "description": "Search Imovirtual.com rent and sale listings by location, property type and filters, or scrape search and listing URLs directly.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "How to find listings. Browse rent or sale listings, search by keyword, or paste Imovirtual URLs.",
            "editor": "select",
            "enum": [
              "forRent",
              "forSale",
              "search",
              "byUrl"
            ],
            "enumTitles": [
              "For rent",
              "For sale",
              "Keyword search",
              "Specific Imovirtual URLs"
            ],
            "default": "forRent",
            "prefill": "forRent"
          },
          "propertyType": {
            "title": "Property type",
            "type": "string",
            "description": "Property category. Any type searches every category one by one.",
            "editor": "select",
            "enum": [
              "any",
              "apartment",
              "house",
              "land",
              "garage",
              "commercial",
              "office",
              "warehouse",
              "room",
              "development"
            ],
            "enumTitles": [
              "Any type",
              "Apartment",
              "House or villa",
              "Land",
              "Garage or parking",
              "Commercial property",
              "Office",
              "Warehouse",
              "Room (rent only)",
              "New development (sale only)"
            ],
            "default": "apartment",
            "prefill": "apartment"
          },
          "transactionType": {
            "title": "Transaction type (keyword search)",
            "type": "string",
            "description": "Rent or sale for mode=search. The For rent and For sale modes set this automatically.",
            "editor": "select",
            "enum": [
              "rent",
              "sale"
            ],
            "enumTitles": [
              "For rent",
              "For sale"
            ],
            "default": "rent",
            "prefill": "rent"
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, district, council or parish. Examples: Lisboa, Porto, Faro, lisboa/sintra, lisboa/lisboa/benfica. Leave empty for all Portugal.",
            "editor": "textfield",
            "default": "Lisboa",
            "prefill": "Lisboa"
          },
          "searchQuery": {
            "title": "Keyword",
            "type": "string",
            "description": "Optional words to find in listing descriptions, e.g. piscina, varanda, garagem. Also used by mode=search.",
            "editor": "textfield"
          },
          "minPrice": {
            "title": "Minimum price (EUR)",
            "type": "integer",
            "description": "Minimum monthly rent or total sale price in euros.",
            "minimum": 0,
            "maximum": 100000000
          },
          "maxPrice": {
            "title": "Maximum price (EUR)",
            "type": "integer",
            "description": "Maximum monthly rent or total sale price in euros.",
            "minimum": 0,
            "maximum": 100000000
          },
          "minArea": {
            "title": "Minimum area (m2)",
            "type": "integer",
            "description": "Minimum usable floor area in square metres.",
            "minimum": 0,
            "maximum": 1000000
          },
          "maxArea": {
            "title": "Maximum area (m2)",
            "type": "integer",
            "description": "Maximum usable floor area in square metres.",
            "minimum": 0,
            "maximum": 1000000
          },
          "rooms": {
            "title": "Typology",
            "type": "array",
            "description": "One or more Portuguese typologies: T0 is a studio, T3 has three bedrooms. Matches any selected value.",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "ONE",
                "TWO",
                "THREE",
                "FOUR",
                "FIVE",
                "SIX_OR_MORE"
              ],
              "enumTitles": [
                "T0",
                "T1",
                "T2",
                "T3",
                "T4",
                "T5+"
              ]
            },
            "default": [],
            "prefill": [],
            "uniqueItems": true
          },
          "extras": {
            "title": "Features",
            "type": "array",
            "description": "Only return listings with any of these features.",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "IS_PRIVATE_OWNER",
                "LIFT",
                "GARAGE",
                "AIR_CONDITIONING",
                "BALCONY",
                "TERRACE",
                "HAS_PHOTOS",
                "INTERNET",
                "GARDEN",
                "CABLE_TELEVISION",
                "SEPARATE_KITCHEN"
              ],
              "enumTitles": [
                "Private owner",
                "Lift",
                "Garage",
                "Air conditioning",
                "Balcony",
                "Terrace",
                "Has photos",
                "Internet",
                "Garden",
                "Cable television",
                "Separate kitchen"
              ]
            },
            "default": [],
            "prefill": [],
            "uniqueItems": true
          },
          "privateOwnerOnly": {
            "title": "Private owners only",
            "type": "boolean",
            "description": "Skip agency listings and keep only properties posted by private owners.",
            "default": false,
            "prefill": false
          },
          "daysSinceCreated": {
            "title": "Listed within",
            "type": "string",
            "description": "Only include listings first published within this period.",
            "editor": "select",
            "enum": [
              "any",
              "1",
              "3",
              "7"
            ],
            "enumTitles": [
              "Any time",
              "Last 24 hours",
              "Last 3 days",
              "Last 7 days"
            ],
            "default": "any",
            "prefill": "any"
          },
          "buildYearMin": {
            "title": "Built from year",
            "type": "integer",
            "description": "Minimum construction year.",
            "minimum": 1800,
            "maximum": 2100
          },
          "buildYearMax": {
            "title": "Built until year",
            "type": "integer",
            "description": "Maximum construction year.",
            "minimum": 1800,
            "maximum": 2100
          },
          "floorsNumberMin": {
            "title": "Building floors from",
            "type": "integer",
            "description": "Minimum number of floors in the building.",
            "minimum": 0,
            "maximum": 200
          },
          "floorsNumberMax": {
            "title": "Building floors until",
            "type": "integer",
            "description": "Maximum number of floors in the building.",
            "minimum": 0,
            "maximum": 200
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "Order of the results.",
            "editor": "select",
            "enum": [
              "relevance",
              "newest",
              "oldest",
              "priceAsc",
              "priceDesc",
              "areaAsc",
              "areaDesc"
            ],
            "enumTitles": [
              "Relevance",
              "Newest first",
              "Oldest first",
              "Price: low to high",
              "Price: high to low",
              "Area: small to large",
              "Area: large to small"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "listingUrls": {
            "title": "Imovirtual URLs (mode=byUrl)",
            "type": "array",
            "description": "Search result or listing URLs. Search URLs are paginated; listing URLs produce one record each. Examples: https://www.imovirtual.com/pt/resultados/arrendar/apartamento/lisboa/lisboa and https://www.imovirtual.com/pt/anuncio/... .",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "includeDetails": {
            "title": "Fetch full listing details",
            "type": "boolean",
            "description": "Open each listing page for description, bathrooms, energy certificate, build year, amenities, GPS coordinates and agency details. Turn off for faster bulk runs.",
            "default": true,
            "prefill": true
          },
          "maxItems": {
            "title": "Max listings",
            "type": "integer",
            "description": "Maximum number of listing records to save.",
            "minimum": 1,
            "maximum": 50000,
            "default": 20,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Imovirtual Portugal Property Listings Output",
        "description": "Imovirtual property listings with transaction type, price, price per square metre, area, typology, location hierarchy, features, photos, agency details, dates and optional full description, bathrooms, energy certificate, amenities and GPS coordinates.",
        "properties": {
          "properties": {
            "type": "string",
            "title": "Property listings",
            "description": "Dataset containing all scraped Imovirtual property listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Properties",
              "transformation": {
                "fields": [
                  "title",
                  "price",
                  "currency",
                  "area",
                  "bedrooms",
                  "typology",
                  "rooms",
                  "propertyType",
                  "transactionType",
                  "city",
                  "parish",
                  "agencyName",
                  "dateCreated",
                  "listingUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "2.0.1",
    "imageDigest": "81f72037baf7157806f4f3df298e84b9b59968223e433cac21ed20d7b1a9d2d4",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "2.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0049677777777777776
    }
  }
}