# Zome Portugal Scraper - Property Listings (`studio-amba/zome-scraper`) Actor

Scrape property listings from Zome Portugal (zome.pt). Apartments, houses, land and commercial for sale and rent with price, area, bedrooms, coordinates, location and photos.

- **URL**: https://apify.com/studio-amba/zome-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Zome Portugal Scraper

Scrape property listings from Zome Portugal (zome.pt). Each listing comes back as one structured row: title, reference, sale or rent, property type, typology, price, previous price, usable and gross area, plot area, bedrooms, bathrooms, condition, pool, garage, elevator, district, municipality, parish, coordinates, listing dates and photos.

### Why use this actor?

- Covers the whole Zome listing base: about 8,200 properties for sale, about 380 for rent and about 145 commercial transfers.
- Gives coordinates for every listing, so listings can be placed on a map.
- Gives price, previous price, usable area and a price per square metre.
- Gives the date a listing entered the network and the date it was last updated.
- Filters on business type, property type, district, municipality and price.
- Plain HTTP requests. No browser, so runs are fast and cheap.

### How to scrape Zome data

1. Open the actor and leave the prefill (district Lisboa) or enter your own filters.
2. Set `maxResults` to the number of listings you want.
3. Optionally choose sale, rent or commercial transfer, a property type, a municipality or a price range.
4. Start the run and download the dataset as JSON, CSV or Excel.

District, municipality and property type are written the way Zome shows them, and accents do not matter: `Lisboa`, `Setubal`, `Porto`, `Faro`, `Apartamento`, `Moradia`. Leave all filters empty to read every sale and rent listing.

### Input

| Field | Description |
|---|---|
| `businessType` | `sale`, `rent` or `transfer` (commercial transfer, called trespasse in Portugal). Empty reads sale and rent. |
| `propertyType` | Property type, for example `Apartamento`, `Moradia`, `Terreno`, `Loja`, `Escritorio`. Empty reads all types. |
| `district` | District (distrito), for example `Lisboa`, `Porto`, `Faro`, `Setubal`. Empty reads all of Portugal. |
| `municipality` | Municipality (concelho), for example `Cascais`, `Oeiras`, `Sintra`. |
| `minPrice`, `maxPrice` | Price range in euro. For rentals this is the monthly rent. |
| `maxResults` | Maximum number of rows. Default 50, maximum 30000. |
| `proxyConfiguration` | Apify Proxy settings. Datacenter addresses work. |

The actor reads the same listing search that the Zome website uses, 500 listings per request, newest listings first. Listings that Zome shows on its website are returned, one row per property.

### What you get back

| Field | Description |
|---|---|
| `listingId`, `internalId` | The Zome reference, for example `ZMPT594366`, and the numeric id behind it. |
| `url`, `title` | The listing address on zome.pt and the headline, for example `Apartamento T2`. |
| `businessType` | `sale`, `rent` or `transfer`. |
| `propertyType`, `typology` | The type, such as apartment or house, and the typology such as `T2`. |
| `bedrooms`, `suites`, `bathrooms` | Counts as stated. `bedrooms` is taken from the typology. |
| `condition` | New, used, renovated, ruin or similar. |
| `price`, `previousPrice`, `currency`, `priceHidden` | The asking price in euro and the earlier price when it was lowered. `priceHidden` is true and `price` is empty when the agent does not show the price. |
| `pricePerSqm` | Price divided by usable area, rounded. |
| `usableAreaM2`, `grossAreaM2`, `plotAreaM2`, `implantationAreaM2` | Usable, gross construction, plot and implantation areas in square metres. |
| `hasPool`, `hasGarage`, `garageSpaces`, `hasParking`, `hasElevator`, `reducedMobilityAccess` | Features as flagged by the agent. Empty when the agent did not give the feature. |
| `district`, `municipality`, `parish`, `locality` | Location levels. |
| `latitude`, `longitude` | Coordinates. |
| `agencyName`, `reservedZomeNow`, `featured` | Agency name when the listing belongs to a partner agency, and the reserved and featured flags. |
| `listedAt`, `updatedAt` | When the listing entered the Zome network and when it was last changed. |
| `imageUrl`, `imageUrls` | Photo links. |
| `scrapedAt` | Time of the run. |

### Example output

```json
{
  "listingId": "ZMPT594366",
  "internalId": 164755,
  "url": "https://www.zome.pt/pt/apartamento-t2-lisboa-odivelas-povoa_de_santo_adriao_e_olival_basto-ZMPT594366",
  "title": "Apartamento T2",
  "businessType": "sale",
  "propertyType": "Apartamento",
  "typology": "T2",
  "bedrooms": 2,
  "suites": 2,
  "bathrooms": 1,
  "condition": "Usado",
  "price": 300000,
  "previousPrice": 310000,
  "currency": "EUR",
  "pricePerSqm": 3614,
  "priceHidden": false,
  "usableAreaM2": 83,
  "grossAreaM2": 112,
  "plotAreaM2": null,
  "hasGarage": true,
  "garageSpaces": 1,
  "district": "Lisboa",
  "municipality": "Odivelas",
  "parish": "Póvoa de Santo Adrião e Olival Basto",
  "latitude": 38.7957689,
  "longitude": -9.1518749,
  "listedAt": "2026-10-30T12:39:20",
  "updatedAt": "2026-11-12T12:46:48",
  "imageUrl": "https://images.zome.pt/listings/mres/2/0/2/6/1/0/2/1/1/0/3/0/0/3/eira13_20261030102957.jpg",
  "scrapedAt": "2026-11-12T20:34:19.435Z"
}
```

### Use cases

- Track asking prices per municipality and per parish.
- Compare price per square metre between districts.
- Find price reductions with `previousPrice`.
- Watch new listings every day with a schedule and `listedAt`.
- Map supply with the coordinates.
- Build a Portuguese property dataset next to other portals and brokers.
- Feed a valuation model or a market report.

### Cost and speed

Each listing is one result row and is billed as one result. The price per result is on the actor page. The actor reads 500 listings per request, so 1,000 listings take a few seconds and a full read of the site takes about a minute. The usage cost of a run only settles after the run has finished successfully.

### Notes and limits

- The actor returns the listings that Zome shows on its public website. It does not log in.
- Sale or rent is read from the business type. Commercial transfers are only returned when `businessType` is `transfer`.
- District, municipality and property type are matched against the location and type names of the listing. Accents and capital letters do not matter.
- The price filter is applied by the site's search. For rentals it applies to the monthly rent.
- Some listings do not show a price. They have no `price` and `priceHidden` is true.
- Listings change while a run is going. A listing that enters or leaves the network during a long run can move between result pages.
- Feature fields such as `hasPool` and `hasElevator` are empty when the agent did not give the feature.
- Agent names and phone numbers are not part of the rows.
- A filter with no matching listing ends the run as SUCCEEDED with no rows.
- You are responsible for how you use the data. Check the site's terms and the rules that apply to your use case.

### Frequently asked questions

#### How do I read one district?

Set `district`, for example `Lisboa`. Districts with accents work with or without them.

#### How do I read only rentals?

Set `businessType` to `rent`.

#### How do I read only apartments?

Set `propertyType` to `Apartamento`. Use `Moradia` for houses.

#### How do I find listings that dropped in price?

Run the actor and keep the rows where `previousPrice` is higher than `price`.

#### Why is the price empty on some listings?

The agent did not show the price on the website. `priceHidden` is true on those rows.

#### How often can I run it?

As often as you like. A scheduled run with a small `maxResults` gives a feed of the newest listings, because rows are returned newest first.

### Related scrapers

- [KW Portugal Scraper](https://apify.com/studio-amba/kwportugal-scraper) for Keller Williams listings in Portugal
- [RE/MAX Portugal Scraper](https://apify.com/studio-amba/remax-pt-scraper) for RE/MAX listings in Portugal
- [Century 21 Portugal Scraper](https://apify.com/studio-amba/century21-pt-scraper) for Century 21 listings in Portugal
- [ERA Portugal Scraper](https://apify.com/studio-amba/era-pt-scraper) for ERA listings in Portugal

# Actor input Schema

## `businessType` (type: `string`):

Sale, rent or commercial transfer (trespasse). Leave empty for sale and rent.

## `propertyType` (type: `string`):

Optional. Type as Zome writes it, for example Apartamento, Moradia, Terreno, Loja, Escritorio. Leave empty for all types.

## `district` (type: `string`):

Optional. District (distrito), for example Lisboa, Porto, Faro, Setubal. Leave empty for all of Portugal.

## `municipality` (type: `string`):

Optional. Municipality (concelho), for example Cascais, Oeiras, Sintra. Leave empty for all municipalities.

## `minPrice` (type: `integer`):

Only listings priced at or above this amount.

## `maxPrice` (type: `integer`):

Only listings priced at or below this amount.

## `maxResults` (type: `integer`):

Maximum number of listings to return. Capped at 30000 per run.

## `proxyConfiguration` (type: `object`):

The search answers plain requests. The automatic Apify proxy is the default.

## Actor input object example

```json
{
  "district": "Lisboa",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "district": "Lisboa",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/zome-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "district": "Lisboa",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/zome-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "district": "Lisboa",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/zome-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/zome-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/MIk39CipgIVOA8DNV/builds/QUOjM2pTihh8G9d0Z/openapi.json
