Imóveis Portugal Listings — Imovirtual Scraper
Edigual Store · @createstudios
Listagens de imóveis do maior portal PT em dataset JSON
About
Imóveis Portugal Listings — Imovirtual Scraper
Extrai imóveis de imovirtual.com (grupo OLX, portal imobiliário #1 de Portugal) para dataset JSON. Por anúncio: URL, preço, localização hierárquica (distrito → concelho → freguesia), área, quartos, floor, agência, tipo de negociante, data de publicação e número de imagens.
Actor ID: createstudios/imovirtual-pt-listings.
Como funciona
O imovirtual serve cada página de resultados em HTML com um bloco
<script id="__NEXT_DATA__"> contendo JSON estruturado
(props.pageProps.data.searchAds.items, ~36 anúncios/página + paginação).
O Actor faz HTTP simples (httpx), sem browser e sem visita por anúncio —
1 página = 36 anúncios completos.
Saída de rede (importante): o imovirtual bloqueia com HTTP 403 qualquer
IP de datacenter — incluindo o IP directo do container da plataforma. Por isso o
Actor sai por omissão pelo proxy RESIDENTIAL da plataforma (campo standard
useApifyProxy). Desligar esse campo só é útil em execuções locais a partir de
um IP residencial.
Campos por anúncio
id, url, title, price (numérico), currency, price_per_sqm,
area_m2, rooms, rooms_raw, floor, estate_type, transaction,
district, council, parish, neighborhood, agency, agency_url,
private_owner, exclusive, promoted, published (ISO), n_images,
scraped_at.
Input
| campo | omissão | notas |
|---|---|---|
estate | apartamento | apartamento, moradia, terreno, escritorio, loja, arazendeavel, quinta-herdade, garagem, armazem |
transaction | comprar | comprar / arrendar |
locations | ["lisboa"] | slugs imovirtual: lisboa, porto, faro, braga, coimbra… |
max_items | 100 | por localização |
max_pages_per_location | 3 | 36 anúncios/página |
request_delay_s | 1.5 | rate-limit humanizado |
useApifyProxy | true | proxy da plataforma (RESIDENTIAL) — desliga o 403 |
apifyProxyGroups | ["RESIDENTIAL"] | grupos pedidos ao proxy |
apifyProxyCountry | PT | país pedido ao proxy |
Quem usa
- Agências imobiliárias que precisam de leads frescos por freguesia.
- Investidores a monitorizar preço por m² em zonas concretas.
- Consultores de crédito que fazem pré-filtragem antes da avaliação.
- Data analysts que cruzam preço de oferta com dados de população e renda.
Exemplo de output
{
"id": 19362712,
"url": "https://www.imovirtual.com/pt/anuncio/t3-novo-em-vialonga-ID1jf7O",
"title": "T3 Novo em Vialonga",
"price": 460000,
"currency": "EUR",
"price_per_sqm": 4181.82,
"area_m2": 110,
"rooms": 4,
"district": "Lisboa",
"council": "Vila Franca de Xira, Lisboa",
"parish": "Vialonga, Vila Franca de Xira, Lisboa",
"agency": "Espaços",
"private_owner": false,
"published": "2026-11-20T00:30:02+00:00",
"n_images": 3
}
Notas
- Delay humanizado 1–2 s entre pedidos; robots.txt respeitado (só páginas
/pt/resultados/). - Custo: compute + bytes de proxy, cobrados à mistura da plataforma.
Related actors
More from this publisher and Actors in the same categories.

Bing Scraper - Search Results & SERP Data
codemaster devops · @codemasterdevops
Scrape Bing search results, titles, links, and snippets. Run multiple queries with market, language, and page controls for SEO and competitor research.
SEO toolsMarketingDeveloper toolsUsage-based
Facebook Group Post Scraper
bhansalisoft · @bhansalisoft
Facebook Group Post Scraper : Scrap facebook group post data.
AutomationLead generationMarketing$19/mo1-day free trial
Facebook Message Sender
bhansalisoft · @bhansalisoft
Facebook Message Sender: send bulk message to multiple facebook profiles
AutomationMarketingSocial media$19/mo1-day free trial
Facebook Group Members Scraper
bhansalisoft · @bhansalisoft
Facebook Group Members Scraper : Scrap Facebook Members from facebook group
AutomationLead generationMarketing$19/mo1-day free trial
Input
Preview of the input form. Rent the Actor to fill it in and start runs from the console.
Fields
estateSlug do tipo de imóvel no imovirtual.
transactioncomprar (venda) ou arrendar (aluguer).
locationsSlugs de localização imovirtual, ex.: lisboa, porto, faro.
max_itemsNúmero máximo de anúncios a extrair.
max_pages_per_locationMáximo de páginas de resultados por localização (~36 anúncios por página).
request_delay_sDelay humanizado entre pedidos para respeitar rate-limit (recomendado 1-2 s).
useApifyProxyPor omissão TRUE: sai pelo proxy RESIDENTIAL da plataforma — obrigatório, porque o imovirtual bloqueia (HTTP 403) IPs de datacenter. Desligar só funciona em execuções locais.
apifyProxyGroupsGrupos pedidos ao proxy da plataforma. RESIDENTIAL é o que passa no imovirtual.
apifyProxyCountryCódigo ISO do país pedido ao proxy (ex.: PT). Vazio = sem filtro de país.
API
Bytewells speaks the Apify API. Existing integrations keep working: point apify-client at https://bytewells.com/api and use your Bytewells API token (Console → Settings → API access). The Actor ID is createstudios/imovirtual-pt-listings (or createstudios~imovirtual-pt-listings in URLs).
JavaScript · apify-client
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({
token: process.env.BYTEWELLS_TOKEN,
baseUrl: 'https://bytewells.com/api',
});
const input = {
"helloWorld": 123
};
const run = await client.actor('createstudios/imovirtual-pt-listings').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);Python · apify-client
import os
from apify_client import ApifyClient
client = ApifyClient(os.environ["BYTEWELLS_TOKEN"], api_url="https://bytewells.com/api")
run_input = {
"helloWorld": 123
}
run = client.actor("createstudios/imovirtual-pt-listings").call(run_input=run_input)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)HTTP · curl
curl -X POST "https://bytewells.com/api/v2/acts/createstudios~imovirtual-pt-listings/runs" \
-H "Authorization: Bearer $BYTEWELLS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"helloWorld":123}'Runs are billed as compute from your credit balance. Paid Actors need an active rental or trial; otherwise the API answers 402 rental-required.
Related
More Actors from the same publisher.
OLX Portugal Listings — Classificados PT
Edigual Store · @createstudios
Scrape de anúncios do OLX Portugal (olx.pt): imóveis, autos, electrónica, moda, serviços e mais. Por anúncio: URL, preço, localização, fotos, vendedor, data de publicação, área/tipologia. Dataset JSON. SEO: olx portugal, classificados portugal, scrape olx pt.
$29/mo3-day free trialPortugal Public Contracts (base.gov.pt)
Edigual Store · @createstudios
Scrape Portuguese public procurement announcements (concursos publicos) from base.gov.pt: entity, procedure type, base price and publication date, ready for supplier lead generation.
BusinessReal estate$29/mo3-day free trial