# Idealista Real Estate Detail Scraper (Portugal) Collect full Idealista.pt property details from listing URLs: price, location, features, advertiser comment, energy certificate section, reference, professional, and photos. - Template page: [https://www.octoparse.com/template/idealista-real-estate-detail-scraper-portugal](https://www.octoparse.com/template/idealista-real-estate-detail-scraper-portugal) - Categories: Real Estate - Status: `PUBLISHED` - Run mode: `CLOUD` ## Pricing Current price: **$0.3/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required. ## What is an Octoparse template? An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters. ## Overview This ready-to-use template collects structured data from detail pages. ## Output The current workflow extracts 18 fields, including `Características_básicas`, `Características_destacadas`, `Certificado_energético`, `Comentário_do_anunciante`, `Contacto_URL`, `Equipamento`, `Hora_atual`, `Localização`, `Preço`, `Profissional`, `Prédio`, `Ref`, `Título`, `URL_inserido`, `imagem1`, `imagem2`, `imagem3`, `Última_atualização`. ## Use Cases - Use structured results for research, comparison, and monitoring. - Collect rows without building the extraction workflow from scratch. - Combine results with other templates for downstream enrichment. - Review a representative result before starting a large batch. ## Why Octoparse - **No coding required:** complete Detail Page URLs (up to 5000) and start the template in cloud mode. - **Flexible export:** review and export results as CSV, Excel, or JSON. ## Input ### Detail Page URLs (up to 5000) Required. The URLs of the property detail pages on Idealista.pt Constraints: minItems=1; maxItems=5000; items.minLength=1; items.maxLength=10000. ## How to Use # Idealista Real Estate Detail Scraper (Portugal) – Usage Guide ## Input - **Detail Page URLs**: One Idealista Portugal listing URL per line, up to 5,000 per task. Format: `https://www.idealista.pt/imovel//` (e.g., `https://www.idealista.pt/imovel/35342540/`). Language variants (e.g., `/en/imovel//`) accepted, query strings ignored. Only `idealista.pt` listing pages. ## How to Use 1. Open the template and click **Try it!**. 2. Paste listing URLs into the **Detail Page URLs** field, one per line. 3. Start the task (runs in cloud). 4. Review collected rows. 5. Export data as needed. ## Output Fields Each submitted URL returns one row with these fields (field names in Portuguese): - `URL_inserido` – Your input URL. - `Título` – Property title. For unavailable listings, contains an error message. - `Preço` – Price. - `Características_destacadas` – Highlighted features. - `Localização` – Location. - `Comentário_do_anunciante` – Advertiser's description. - `Características_básicas` – Basic characteristics. - `Prédio` – Building information. - `Equipamento` – Equipment. - `Certificado_energético` – Energy certificate section text. - `Ref` – Listing reference. - `Profissional` – Advertising professional name. - `Contacto_URL` – Professional's Idealista profile URL. - `Última_atualização` – Last update note. - `Hora_atual` – Collection time. - `imagem1`, `imagem2`, `imagem3` – First three listing photos. When a listing cannot be collected, only `URL_inserido` and `Título` are filled; `Título` holds one of: - `Lamentamos, mas este anúncio já não está publicado` (removed) - `Não foi possível obter o anúncio, tentativas esgotadas` (retries exhausted) - `Não foi possível ler o anúncio` (page retrieved but unreadable) - `URL inválido, esperado https://www.idealista.pt/imovel//` (invalid URL) ## Limitations - Only `idealista.pt/imovel//` URLs. Max 5,000 per task. - Each input line yields one output row. Duplicate URLs not merged. - Only first three photos returned. - `Certificado_energético` may not include the rating itself. - Idealista may block automated access; the template retries automatically. Blocked pages result in "tentativas esgotadas" row. Tasks with invalid/blocked/unreadable URLs are reported as failed (but rows for successful URLs are delivered). Removed listings do not cause failure. - URLs processed sequentially; large batches take proportionally longer. - Cloud run only. ## Limitations Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above. ## Tips Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed. ## FAQ ### What do I need to enter? Use the exact inputs and limits listed above. ### What data does this template return? See Output Schema below; availability can vary by source record. ### How is usage billed? See the Pricing section above for current pricing and billing details. ## Related Templates - [Idealista Real Estate Listing Scraper (Portugal)](https://www.octoparse.com/template/idealista-real-estate-listing-scraper-portugal) - [Idealista Real Estate Detail Scraper (Italy)](https://www.octoparse.com/template/crawler-dettagli-immobili-idealista) - [Idealista Real Estate Listing Scraper (Italy)](https://www.octoparse.com/template/crawler-lista-immobili-idealista) - [Immobiliare Real Estate Detail Scraper](https://www.octoparse.com/template/crawler-dettagli-immobili-immobiliare) - [Immobiliare Real Estate Listing Scraper (Local Only)](https://www.octoparse.com/template/crawler-lista-immobili-immobiliare) ## Input Schema ```json { "title": "Idealista Real Estate Detail Scraper (Portugal) input", "description": "Input parameters configured for the current published template version.", "type": "object", "schemaVersion": 1, "additionalProperties": false, "properties": { "detail_Page_URLs": { "title": "Detail Page URLs (up to 5000)", "description": "The URLs of the property detail pages on Idealista.pt", "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 10000 }, "minItems": 1, "maxItems": 5000, "x-octoparse": { "apiEnabled": true } } }, "required": [ "detail_Page_URLs" ] } ``` ## Input JSON Example Example 1 ```json { "detail_Page_URLs": [ "https://www.idealista.pt/imovel/35231715/", "https://www.idealista.pt/imovel/35231715", "https://www.idealista.pt/imovel/33114810/", "https://www.idealista.pt/imovel/1/", "https://www.idealista.pt/imovel/35227342/" ] } ``` Example 2 ```json { "detail_Page_URLs": [ "https://www.idealista.pt/en/multi/comprar-casas/aYa,byK,byL,byM,byO,byP,byT/com-preco-max_280000,tamanho-min_60,t2,novo,bom-estado/" ] } ``` Example 3 ```json { "detail_Page_URLs": [ "https://www.idealista.pt/imovel/34665653/" ] } ``` Example 4 ```json { "detail_Page_URLs": [ "https://www.idealista.pt/imovel/34665653/" ] } ``` Example 5 ```json { "detail_Page_URLs": [ "https://www.idealista.pt/imovel/35231715/", "https://www.idealista.pt/imovel/35231715", "https://www.idealista.pt/imovel/33114810/", "https://www.idealista.pt/imovel/1/", "https://www.idealista.pt/imovel/35227342/" ] } ``` ## Output Schema ```json { "schemaVersion": 1, "type": "object", "properties": { "Características_básicas": { "type": "string", "description": "" }, "Características_destacadas": { "type": "string", "description": "" }, "Certificado_energético": { "type": "string", "description": "" }, "Comentário_do_anunciante": { "type": "string", "description": "" }, "Contacto_URL": { "type": "string", "description": "" }, "Equipamento": { "type": "string", "description": "" }, "Hora_atual": { "type": "string", "description": "" }, "Localização": { "type": "string", "description": "" }, "Preço": { "type": "string", "description": "" }, "Profissional": { "type": "string", "description": "" }, "Prédio": { "type": "string", "description": "" }, "Ref": { "type": "string", "description": "" }, "Título": { "type": "string", "description": "" }, "URL_inserido": { "type": "string", "description": "" }, "imagem1": { "type": "string", "description": "" }, "imagem2": { "type": "string", "description": "" }, "imagem3": { "type": "string", "description": "" }, "Última_atualização": { "type": "string", "description": "" } }, "title": "Idealista Real Estate Detail Scraper (Portugal) output", "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.", "additionalProperties": false } ``` ## Output Example Example 1 ```json { "Características_básicas": "212 m² área bruta, 120 m² úteis; T3; 2 casas de banho; Terraço e varanda; Lugar de garagem incluído no preço; Segunda mão/bom estado; Armários embutidos; Orientação Norte, Sul, Este, Oeste; Construído em 1998", "Características_destacadas": "212 m² área bruta T3 Garagem incluída", "Certificado_energético": "Em trâmite", "Comentário_do_anunciante": "Apartamento com várias possibilidades de utilização no centro das Caldas da Rainha. Situada na encantadora cidade de Caldas da Rainha, esta excelente oportunidade de investimento apresenta um conjunto de apartamentos recentemente renovados, com uma área de 120,08 m² + Garagem (50m²), escritório (18m²) e terraço (68m²), distribuída por três pisos. A sua localização privilegiada junto ao centro da cidade de Caldas da Rainha combina conforto, funcionalidade e uma vista urbana que valoriza cada momento de convivência. A orientação solar privilegia um pôr do sol único que poderá desfrutar da sua varanda. Disposição: T2 amplo e moderno, com áreas muito boas, roupeiros novos em todos os quartos e 2 varandas. Conta ainda com uma despensa. Deste piso poderá aceder internamente ao piso de baixo, onde vai encontrar o escritório de 18m2, a lavandaria e a garagem com portão automático e já pré preparada para carregamento de carros elétricos e que devido à sua área generosa comporta um bom carro, sobrando ainda espaço para arrumação ou mesmo veículos de 2 rodas. No piso de baixo temos um T1, totalmente novo, com open space entre a cozinha e sala, arrumação, casa de banho ampla ( 8m²) e um belíssimo quarto. Deste piso tem acesso direto ao logradouro onde encontrará um telheiro com churrasqueira e ponto de água, ideal para desfrutar de refeições ao ar livre. Tem ainda o terraço e zona de jardim. Uma das maiores vantagens deste imóvel é que todos têm entradas independentes, podendo utilizar parte do imóvel e rentabilizar a outra parte, fazendo desta compra um duplo investimento ou simplesmente utilizar a totalidade do espaço e usufruir de uma \"moradia\" no centro da cidade. Uma das cozinhas fica semi equipada com eletrodomésticos de última geração, incluindo frigorífico, placa, forno, esquentador e exaustor. Não perca esta excelente oportunidade de negócio, marque a sua visita! (Foi utilizada inteligência artificial para remoção de bens pessoais das imagens exibidas neste anúncio).", "Contacto_URL": "https://www.idealista.pt/pro/veigas-caldas-da-rainha/", "Equipamento": "Jardim", "Hora_atual": "2026-10-26 01:51:37", "Localização": "Rua de Santo António; Caldas da Rainha (Nossa Senhora do Pópulo); Nossa Senhora do Pópulo - Coto - São Gregório; Caldas da Rainha, Leiria", "Preço": "350.000 €", "Profissional": "Veigas Caldas da Rainha", "Prédio": "", "Ref": "CAL-217159", "Título": "Apartamento T3 à venda na Rua de Santo António", "URL_inserido": "https://www.idealista.pt/imovel/35231715/", "imagem1": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/4c/c0/eb/325315495.jpg", "imagem2": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/75/dc/7c/325315496.jpg", "imagem3": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/59/94/2f/325315492.jpg", "Última_atualização": "Anúncio atualizado no dia 22 de Outubro" } ``` Example 2 ```json { "Características_básicas": "", "Características_destacadas": "", "Certificado_energético": "", "Comentário_do_anunciante": "", "Contacto_URL": "", "Equipamento": "", "Hora_atual": "", "Localização": "", "Preço": "", "Profissional": "", "Prédio": "", "Ref": "", "Título": "URL inválido, esperado https://www.idealista.pt/imovel//", "URL_inserido": "https://www.idealista.pt/en/multi/comprar-casas/aYa,byK,byL,byM,byO,byP,byT/com-preco-max_280000,tamanho-min_60,t2,novo,bom-estado/", "imagem1": "", "imagem2": "", "imagem3": "", "Última_atualização": "" } ``` Example 3 ```json { "Características_básicas": "151 m² área bruta; T2; 2 casas de banho; Terraço e varanda; Lugar de garagem incluído no preço; Empreendimento de nova construção; Armários embutidos; Orientação Este, Oeste; Aquecimento individual: Bomba de calor/frio", "Características_destacadas": "Nova construção 151 m² área bruta T2 Rés do chão sem elevador Garagem incluída apartamentos T2 e duplex", "Certificado_energético": "Classe energética:", "Comentário_do_anunciante": "T2 com logradouro nas Avenidas Novas | Exterior privado e elevada procura DESCRIÇÃO T2 com logradouro privado no Quartier 100, um edifício exclusivo de apenas 5 apartamentos novos nas Avenidas Novas. Um ativo que combina qualidade de vida, liquidez e potencial de valorização numa das zonas mais procuradas de Lisboa. Exterior privativo •Logradouro exclusivo — espaço raro em contexto urbano •Ideal para uso próprio ou valorização em arrendamento •Extensão natural da zona social Características do imóvel •Sala ampla com boa luminosidade •2 quartos bem dimensionados •Cozinha funcional •Distribuição eficiente •Pronto a habitar Ângulo de investimento •Yield estimado: 4-6% •Zona com procura constante (arrendamento e compra) •Forte liquidez em Avenidas Novas •Ativo com potencial de valorização a médio prazo Projeto •Empreendimento Quartier 100 •Reabilitação com foco em funcionalidade urbana •Produto novo em zona consolidada Localização Avenidas Novas — localização central e segura. A poucos minutos de: •Fundação Calouste Gulbenkian •El Corte Inglés Lisboa •Entrecampos ✔ Transportes, serviços e comércio premium ✔ 15 min do aeroporto ✔ Zona consolidada e altamente líquida Perfil ideal •Investidor (arrendamento tradicional ou médio prazo) •Comprador que valoriza exterior + centralidade •Cliente que procura produto novo sem risco de obra Porque este imóvel é uma oportunidade •Logradouro (escassez real em Lisboa) •Produto novo em zona madura •Yield atrativo para o mercado atual •Forte potencial de valorização Solicite já a brochura completa ou agende visita. Resposta em menos de 1 hora. Fantástico projeto residencial na freguesia das Avenidas Novas. O QUARTIER 100 Com cinco frações exclusivas, de T0 a T2 Duplex com orientação nascente/poente, áreas entre os 45 e os 151 m², este é um projeto pensado para quem procura centralidade, discrição e autenticidade. Um projeto que celebra a fusão entre tradição e modernidade. O empreendimento conta com acabamentos de excelência, ar condicionado e cozinhas totalmente equipadas com eletrodomésticos SMEG. A localização é privilegiada, 10 minutos walking distance da Cidade Universitária/metro, Praça de Espanha/metro El Corte Inglês/Metro e jardim da Gulbenkian. Conta com estacionamento 24h para um ano em garagem coberta em frente ao edifício. \"Avenidas Novas\" foi a designação utilizada para o desenvolvimento urbano que fez avançar a cidade de Lisboa nos finais do século XIX e primeira metade do século XX. Surgem novos bairros com moradias unifamiliares e imóveis de rendimento, ocupados por uma classe média-alta e em expansão. Os novos bairros, de ruas largas, logradouros ajardinados e homogéneos no desenho das fachadas, foram numa fase inicial erguidos ao gosto de uma arquitetura eclética e vagamente Arte Nova, sendo de destacar as figuras variados arquitetos. Com assinatura do Arquiteto Tiago Silva Dias, O QUARTIER 100 na Rua da Beneficência é um espaço de encontros entre gerações, entre histórias partilhadas à porta de casa, entre a tradição de um mercado de bairro e o ritmo contemporâneo da cidade. Convidamo-lo a visitar este espaço.", "Contacto_URL": "https://www.idealista.pt/pro/flipstone/", "Equipamento": "Ar condicionado; Jardim", "Hora_atual": "2026-10-09 09:12:14", "Localização": "Rua da Beneficência, 100; Entrecampos; Avenidas Novas; Lisboa", "Preço": "660.000 €", "Profissional": "FLIPSTONE", "Prédio": "Rés do chão; Sem elevador", "Ref": "34665653", "Título": "Apartamento T2 à venda na Rua da Beneficência, 100", "URL_inserido": "https://www.idealista.pt/imovel/34665653/", "imagem1": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/18/79/fd/321088422.jpg", "imagem2": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/da/93/2b/321088420.jpg", "imagem3": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/07/09/cb/321088421.jpg", "Última_atualização": "Anúncio atualizado no dia 6 de Julho" } ``` Example 4 ```json { "Características_básicas": "", "Características_destacadas": "", "Certificado_energético": "", "Comentário_do_anunciante": "", "Contacto_URL": "", "Equipamento": "", "Hora_atual": "", "Localização": "", "Preço": "", "Profissional": "", "Prédio": "", "Ref": "", "Título": "Não foi possível obter o anúncio, tentativas esgotadas", "URL_inserido": "https://www.idealista.pt/imovel/34665653/", "imagem1": "", "imagem2": "", "imagem3": "", "Última_atualização": "" } ``` Example 5 ```json { "Características_básicas": "212 m² área bruta, 120 m² úteis; T3; 2 casas de banho; Terraço e varanda; Lugar de garagem incluído no preço; Segunda mão/bom estado; Armários embutidos; Orientação Norte, Sul, Este, Oeste; Construído em 1998", "Características_destacadas": "212 m² área bruta T3 Garagem incluída", "Certificado_energético": "Em trâmite", "Comentário_do_anunciante": "Apartamento com várias possibilidades de utilização no centro das Caldas da Rainha. Situada na encantadora cidade de Caldas da Rainha, esta excelente oportunidade de investimento apresenta um conjunto de apartamentos recentemente renovados, com uma área de 120,08 m² + Garagem (50m²), escritório (18m²) e terraço (68m²), distribuída por três pisos. A sua localização privilegiada junto ao centro da cidade de Caldas da Rainha combina conforto, funcionalidade e uma vista urbana que valoriza cada momento de convivência. A orientação solar privilegia um pôr do sol único que poderá desfrutar da sua varanda. Disposição: T2 amplo e moderno, com áreas muito boas, roupeiros novos em todos os quartos e 2 varandas. Conta ainda com uma despensa. Deste piso poderá aceder internamente ao piso de baixo, onde vai encontrar o escritório de 18m2, a lavandaria e a garagem com portão automático e já pré preparada para carregamento de carros elétricos e que devido à sua área generosa comporta um bom carro, sobrando ainda espaço para arrumação ou mesmo veículos de 2 rodas. No piso de baixo temos um T1, totalmente novo, com open space entre a cozinha e sala, arrumação, casa de banho ampla ( 8m²) e um belíssimo quarto. Deste piso tem acesso direto ao logradouro onde encontrará um telheiro com churrasqueira e ponto de água, ideal para desfrutar de refeições ao ar livre. Tem ainda o terraço e zona de jardim. Uma das maiores vantagens deste imóvel é que todos têm entradas independentes, podendo utilizar parte do imóvel e rentabilizar a outra parte, fazendo desta compra um duplo investimento ou simplesmente utilizar a totalidade do espaço e usufruir de uma \"moradia\" no centro da cidade. Uma das cozinhas fica semi equipada com eletrodomésticos de última geração, incluindo frigorífico, placa, forno, esquentador e exaustor. Não perca esta excelente oportunidade de negócio, marque a sua visita! (Foi utilizada inteligência artificial para remoção de bens pessoais das imagens exibidas neste anúncio).", "Contacto_URL": "https://www.idealista.pt/pro/veigas-caldas-da-rainha/", "Equipamento": "Jardim", "Hora_atual": "2026-09-23 08:33:39", "Localização": "Rua de Santo António; Caldas da Rainha (Nossa Senhora do Pópulo); Nossa Senhora do Pópulo - Coto - São Gregório; Caldas da Rainha, Leiria", "Preço": "365.000 €", "Profissional": "Veigas Caldas da Rainha", "Prédio": "", "Ref": "CAL-217159", "Título": "Apartamento T3 à venda na Rua de Santo António", "URL_inserido": "https://www.idealista.pt/imovel/35231715/", "imagem1": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/75/dc/7c/325315496.jpg", "imagem2": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/59/94/2f/325315492.jpg", "imagem3": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/82/0f/af/325315493.jpg", "Última_atualização": "Anúncio atualizado no dia 17 de Setembro" } ``` ## API `POST https://openapi.octoparse.com/api/agentTools/executeTask` This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token. Request body: `templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional. Obtain a token: ```http POST https://openapi.octoparse.com/token Content-Type: application/json { "username": "YOUR_USERNAME", "password": "YOUR_PASSWORD", "grant_type": "password" } ``` Use `data.access_token` as `Authorization: Bearer `. After starting, poll `getTaskStatus` and export with `exportData`. ```json { "templateName": "idealista-real-estate-detail-scraper-portugal", "taskName": "Idealista Real Estate Detail Scraper (Portugal)", "parameters": "{\"detail_Page_URLs\":[\"https://www.idealista.pt/imovel/35231715/\",\"https://www.idealista.pt/imovel/35231715\",\"https://www.idealista.pt/imovel/33114810/\",\"https://www.idealista.pt/imovel/1/\",\"https://www.idealista.pt/imovel/35227342/\"]}" } ``` ## Python Example ```python import json import requests OPENAPI_BASE = "https://openapi.octoparse.com" ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" parameters = json.loads("{\"detail_Page_URLs\":[\"https://www.idealista.pt/imovel/35231715/\",\"https://www.idealista.pt/imovel/35231715\",\"https://www.idealista.pt/imovel/33114810/\",\"https://www.idealista.pt/imovel/1/\",\"https://www.idealista.pt/imovel/35227342/\"]}") response = requests.post( f"{OPENAPI_BASE}/api/agentTools/executeTask", headers={ "Authorization": f"Bearer {ACCESS_TOKEN}", "Content-Type": "application/json", }, json={ "templateName": "idealista-real-estate-detail-scraper-portugal", "taskName": "Idealista Real Estate Detail Scraper (Portugal)", "parameters": json.dumps(parameters, ensure_ascii=False), }, timeout=60, ) print(response.status_code) print(response.json()) ``` ## HTTP/cURL Example ```bash curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @- <<'JSON' { "templateName": "idealista-real-estate-detail-scraper-portugal", "taskName": "Idealista Real Estate Detail Scraper (Portugal)", "parameters": "{\"detail_Page_URLs\":[\"https://www.idealista.pt/imovel/35231715/\",\"https://www.idealista.pt/imovel/35231715\",\"https://www.idealista.pt/imovel/33114810/\",\"https://www.idealista.pt/imovel/1/\",\"https://www.idealista.pt/imovel/35227342/\"]}" } JSON ``` ## MCP Setup Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `idealista-real-estate-detail-scraper-portugal`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results. ## Machine-readable Resources - [Template contract](https://www.octoparse.com/templates/idealista-real-estate-detail-scraper-portugal.json) - [Manifest](https://www.octoparse.com/templates/idealista-real-estate-detail-scraper-portugal-manifest.json)