# Properati Scraper (`shahidirfan/properati-scraper`) Actor

Extract real estate listings from Properati across Latin America, including houses, apartments, and properties for sale or rent. Gather property prices, locations, descriptions, and listing details for real estate market research, price comparisons, and investment analysis.

- **URL**: https://apify.com/shahidirfan/properati-scraper.md
- **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

### What does Properati Scraper do?

Properati Scraper collects property listings from the four Properati marketplaces in Latin America: Argentina, Colombia, Ecuador and Peru. Give it a search page, a country home page or a single listing URL, and it returns structured records with price, currency, property type, location, size, publisher, publication date and the full photo gallery.

### Why use Properati Scraper?

- Reads 30 listings per request, so a 1000 listing job takes about half a minute instead of one request per property.
- Returns the complete gallery of every property at original size, not the small preview images.
- Works across all four country sites with the same input. The actor detects the market from the domain, so a list can mix countries.
- Accepts what you actually copy from the browser: a home page such as `https://www.properati.com.pe/`, a filtered search such as `https://www.properati.com.co/s/venta`, a page two link, or a single property page.
- Pages through results until your limit is reached and removes duplicate listings automatically.
- Skips new development projects, which use a different page format, so every saved record is a real property.

### What data can you extract?

| Field            | Example                                                  |
| ---------------- | -------------------------------------------------------- |
| `id`             | `14032-32-ce50-a9152d9fda5f-198d383-ae4a-7439`           |
| `url`            | `https://www.properati.com.ar/detalle/14032-32-ce50-...` |
| `title`          | `Casa en Venta en Santa María`                           |
| `property_type`  | `Casa`                                                   |
| `operation_type` | `Venta`                                                  |
| `price`          | `85000`                                                  |
| `currency`       | `USD`                                                    |
| `price_text`     | `USD 85.000`                                             |
| `bedrooms`       | `2`                                                      |
| `bathrooms`      | `1`                                                      |
| `area_total_m2`  | `160`                                                    |
| `location`       | `Santa María, Córdoba`                                   |
| `publisher`      | `GRUPO A3`                                               |
| `published_at`   | `2025-08-22`                                             |
| `image`          | `https://img.properati.com/...`                          |
| `images`         | `["https://img.properati.com/...", "..."]`               |
| `country`        | `AR`                                                     |

One request returns 30 listings, so a 1000 listing run needs about 34 requests. Fields that a listing does not publish are left out of the record instead of being filled with empty values.

Pasting a single `/detalle/` URL reads that page and also returns `description`, `address`, `locality`, `region`, `latitude`, `longitude`, `area_covered_m2`, `area_plot_m2` and `construction_year`.

### How to use Properati Scraper

1. Open the actor and paste one or more URLs into **Start URLs**.
2. Set **Maximum listings** and **Maximum search pages**.
3. Start the run and download the dataset as JSON, CSV or Excel.

| Input                | Type    | Description                                                                                                                                     |
| -------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `urls`               | array   | Pages to scrape. Home pages become the for sale search of that country. Search, paged search and `/detalle/` listing URLs are used as they are. |
| `maxResults`         | integer | Stop after this many listings. Default 100.                                                                                                     |
| `maxPages`           | integer | Result pages to read per search URL, about 30 listings per page. Default 10.                                                                    |
| `proxyConfiguration` | object  | Defaults to Apify residential proxy, because the sites reject datacenter addresses.                                                             |

#### Scrape one country

```json
{
    "urls": ["https://www.properati.com.ar/s/venta"],
    "maxResults": 100,
    "maxPages": 5
}
```

#### Scrape several countries in one run

```json
{
    "urls": ["https://www.properati.com.co/s/venta", "https://www.properati.com.ec/", "https://www.properati.com.pe/"],
    "maxResults": 300,
    "maxPages": 5
}
```

#### Refresh a set of specific listings

```json
{
    "urls": [
        "https://www.properati.com.ar/detalle/14032-32-ce50-a9152d9fda5f-198d383-ae4a-7439",
        "https://www.properati.com.pe/detalle/14032-32-f5d8-d0190eddb80b-b3b1ef3b-a344-4975"
    ]
}
```

#### Filter by location, type or operation

Properati keeps its filters in the URL. Open the site, set the filters you need, and paste the resulting address, for example `https://www.properati.com.ar/s/capital-federal/departamento/venta`.

### Sample output

```json
{
    "id": "14032-32-ce50-a9152d9fda5f-198d383-ae4a-7439",
    "url": "https://www.properati.com.ar/detalle/14032-32-ce50-a9152d9fda5f-198d383-ae4a-7439",
    "country": "AR",
    "title": "Casa en Venta en Santa María",
    "property_type": "Casa",
    "operation_type": "Venta",
    "price": 85000,
    "currency": "USD",
    "price_text": "USD 85.000",
    "bedrooms": 2,
    "bathrooms": 1,
    "area_total_m2": 160,
    "location": "Santa María, Córdoba",
    "publisher": "GRUPO A3",
    "published_at": "2025-08-22",
    "image": "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMi...",
    "images": [
        "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMi...",
        "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMi..."
    ]
}
```

This record comes from the search page and lists all 28 photos of that property at original size.

### Tips for best results

- Use a search URL that already contains the filters you want. The actor reads the URL and does not build filters itself.
- Keep the residential proxy on for cloud runs. Without it the sites answer with a verification page.
- A country home page is turned into the for sale search, so it is a quick way to sample a market.
- Raise `maxPages` rather than repeating the same run if you need more than 300 listings.

### FAQ

**Does it support rentals?** Yes. Use the rental search of any country, for example `https://www.properati.com.ar/s/alquiler`.

**Why is there no description in the record?** The search pages do not publish it. Paste the listing URL itself if you need the description, exact address and coordinates for that property.

**Are the photos full size?** Yes. Each record lists the whole gallery with the CDN resize step removed, so the URLs point at the original photos.

**Are new development projects included?** No. Project pages use a different layout without per unit data, so the actor lists the resale market only.

**What happens with a listing that has no price?** The record is saved without `price`, and `price_text` keeps whatever the site shows.

### Integrations

Send the dataset to Google Sheets, Airtable, a database or your own API through the Apify integrations, or call this actor from another actor with the Apify API.

### Support

Open an issue on the actor page and include the run ID and the URL you used. That is enough to reproduce most problems.

### Legal notice

This actor reads publicly visible listing pages. Use it for research and monitoring, respect the terms of service of the sites, and do not republish personal contact details without permission.

# Actor input Schema

## `urls` (type: `array`):

Properati pages to scrape. Accepts search pages such as https://www.properati.com.ar/s/venta, country home pages such as https://www.properati.com.pe, and individual /detalle/ listing URLs.

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

Stop after this many listings. The actor never saves more than this number.

## `maxPages` (type: `integer`):

How many result pages to read per search URL. Each page holds about 30 listings.

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

Properati rejects datacenter addresses, so the default is Apify residential proxy.

## Actor input object example

```json
{
  "urls": [
    "https://www.properati.com.ar/s/venta"
  ],
  "maxResults": 100,
  "maxPages": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "urls": [
        "https://www.properati.com.ar/s/venta"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("shahidirfan/properati-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 = { "urls": ["https://www.properati.com.ar/s/venta"] }

# Run the Actor and wait for it to finish
run = client.actor("shahidirfan/properati-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 '{
  "urls": [
    "https://www.properati.com.ar/s/venta"
  ]
}' |
apify call shahidirfan/properati-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,shahidirfan/properati-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/LirLlptzc2e8t1AVY/builds/MJEA7mMLfT8Hr8vOz/openapi.json
