# Loft Scraper — Brazil Property Data & API (`sian.agency/loft-property-scraper`) Actor

Loft scraper & real estate data API for Brazil. Sale & rent listings: price, condo fee, IPTU, area, bedrooms, suites, parking, address, GPS, neighbourhood, amenities, photos — clean JSON/CSV. Fast overview or full detail. No API key needed.

- **URL**: https://apify.com/sian.agency/loft-property-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 9 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 overview listings

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Loft Scraper — Brazil Property Data & Real Estate API 🏠🇧🇷

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![QuintoAndar Scraper](https://img.shields.io/badge/Store-QuintoAndar%20Scraper-1AE392)](https://apify.com/sian.agency/quintoandar-property-scraper?fpr=sian) [![VivaReal Scraper](https://img.shields.io/badge/Store-VivaReal%20Scraper-1AE392)](https://apify.com/sian.agency/vivareal-property-scraper?fpr=sian) [![Zillow Scraper](https://img.shields.io/badge/Store-Zillow%20Scraper-1F4E79)](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian)

#### 🎉 Turn Brazil's Loft listings into clean, analysis-ready datasets — sale & rent, every city, no API key

##### For real-estate analysts, proptech teams, investors, and lead-gen agencies who need structured Brazilian property data fast

***

### 📋 Overview

**Need Loft property data without copy-pasting?** This scraper pulls Loft (loft.com.br) sale and rent listings into a clean, structured dataset — price, condo fee, IPTU, area, bedrooms, suites, parking, address, GPS, neighbourhood, amenities, photos and agency — ready for Excel, your CRM, or a model.

**Why teams choose us:**

- ✅ **Complete records**: ~55 structured fields per listing, including monthly IPTU, condo fee, GPS coordinates and the full photo set
- ⚡ **Two speeds, one tool**: a fast, cheap **Overview** mode for bulk lists and a rich **Detail** mode for full per-listing data
- 🎯 **Search the way you work**: by city, by a pasted search URL, or by specific listing URLs/IDs
- 💰 **Transparent pay-per-result**: you're only charged for listings actually extracted — no charge until your input is validated
- 💎 **Brazil-native**: prices in BRL, Portuguese locale, every state and city covered
- ✨ **No account or API key** needed — paste a city and run

***

### ✨ Features

- 🏙️ **City search**: pull every sale or rent listing in any Brazilian city (e.g. `sao paulo, sp`)
- 🔗 **Search-URL mode**: paste a loft.com.br search URL and the actor mirrors your filters
- 🆔 **Listing-URL mode**: enrich a specific set of listings by URL or ID
- 💵 **Full pricing picture**: sale price, previous price, condo fee, monthly & annual IPTU, monthly expenses, and a computed price per m²
- 📐 **Rich attributes**: area, bedrooms, suites, bathrooms, parking, floor, build year, tower floors, balcony & elevator flags
- 📍 **Geo-ready**: street, neighbourhood, city, state, postal code, latitude & longitude
- 🏢 **Agency & marketplace data**: agency name/ID and marketplace flags for lead generation
- 🏊 **Amenities & media**: condo infrastructure, leisure amenities, unit features, virtual/video tour links and every photo URL
- 📤 **Export anywhere**: JSON, CSV, or Excel straight from the Apify dataset

***

### 🎬 Quick Start

Pick a mode, give it a city (or URLs), and run. Results stream into the dataset as they're extracted — export to JSON/CSV/Excel when it finishes.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~loft-property-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCity","cities":["sao paulo, sp"],"maxResults":100}'
```

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Choose your mode

**Overview** for fast, cheap lists. **Detail** for the full per-listing record.

#### Step 2: Tell it where to look

Enter one or more cities (`sao paulo, sp`), paste loft.com.br search URLs, or list specific listing URLs/IDs.

#### Step 3: Run and export

Hit **Start** and download your dataset as JSON, CSV, or Excel.

**That's it! In a few minutes, you'll have:**

- A clean table of Brazilian property listings
- Price, costs, attributes, location and contact data
- A reusable dataset you can refresh on a schedule

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `scrapeMode` | string | No | `overview` (fast list) or `detail` (full record). Default `overview`. |
| `searchMode` | string | No | `byCity`, `bySearchUrl`, or `byListingUrl`. |
| `cities` | array | No | City facets, e.g. `["sao paulo, sp"]`. |
| `searchUrls` | array | No | loft.com.br search URLs to mirror. |
| `listingUrls` | array | No | Listing URLs or IDs (detail mode). |
| `transactionType` | string | No | `for_sale` or `for_rent`. Default `for_sale`. |
| `orderBy` | string | No | `rankB` (relevance) or `rankA`. Default `rankB`. |
| `neighborhood` | string | No | Optional neighbourhood facet, e.g. `pinheiros, sao paulo, sp`. |
| `minBedrooms` | integer | No | Minimum bedrooms (≥ N). |
| `maxResults` | integer | No | Max listings per run. Default `100`. |
| `proxyCountry` | string | No | `BR` to route via a Brazilian residential exit; blank = direct. |

**Example — overview by city:**

```json
{
  "scrapeMode": "overview",
  "searchMode": "byCity",
  "cities": ["sao paulo, sp"],
  "transactionType": "for_sale",
  "minBedrooms": 2,
  "maxResults": 200
}
```

**Example — detail by listing URL:**

```json
{
  "scrapeMode": "detail",
  "searchMode": "byListingUrl",
  "listingUrls": ["https://loft.com.br/imovel/apartamento-vila-madalena/1fdwpn8"]
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **~55 fields** including:

| Field | Type | Description |
|-------|------|-------------|
| `propertyTitle` | string | Human-readable listing title |
| `url` | string | Canonical listing URL |
| `price` | number | Sale price (BRL) |
| `rental_price` | number | Monthly rent (BRL) |
| `complex_fee` | number | Monthly condo fee (BRL) |
| `property_tax` | number | Monthly IPTU (BRL) |
| `annual_property_tax` | number | Annual IPTU (BRL, detail) |
| `price_per_sqm_brl` | number | Computed price per m² |
| `area` | number | Usable area (m²) |
| `bedrooms` / `suits` / `restrooms` / `parking_spots` | number | Room counts |
| `neighborhood` / `city` / `state` | string | Location |
| `latitude` / `longitude` | number | GPS coordinates |
| `agency_name` | string | Listing agency |
| `photos` | array | All photo URLs |

**Example:**

```json
{
  "listingId": "1fdwpn8",
  "url": "https://loft.com.br/imovel/1fdwpn8",
  "propertyTitle": "Cobertura, Rua Fidalga, Vila Madalena, 2 quartos, 233m2",
  "property_type": "rooftop",
  "transaction_type": "FOR_SALE",
  "price": 2600000,
  "complex_fee": 1800,
  "annual_property_tax": 11262,
  "price_per_sqm_brl": 11158,
  "area": 233,
  "bedrooms": 2,
  "suits": 1,
  "restrooms": 3,
  "parking_spots": 2,
  "neighborhood": "Vila Madalena",
  "city": "São Paulo",
  "state": "SP",
  "latitude": -23.5523645,
  "longitude": -46.6930137,
  "agency_name": "Foxter Imobiliária",
  "currency": "BRL"
}
```

***

### 💼 Use Cases & Examples

#### 1. Market Analysis

**Analysts tracking price and inventory across São Paulo neighbourhoods.**

- **Input:** a city + neighbourhood facet, overview mode
- **Output:** every active listing with price, area and price per m²
- **Use:** build a live comparables table and spot pricing trends

#### 2. Lead Generation

**Agencies building a list of listing agencies and marketplace sellers.**

- **Input:** overview mode across multiple cities
- **Output:** agency names, listing URLs and locations
- **Use:** feed your CRM with fresh, structured prospects

#### 3. Investment Research

**Investors screening yield by comparing rent and sale data.**

- **Input:** for\_sale and for\_rent runs for the same city
- **Output:** price, rent, condo fee and IPTU per property
- **Use:** model gross yield and total carrying cost

#### 4. Price Monitoring

**Proptech teams refreshing a dataset on a schedule.**

- **Input:** a saved search URL, run daily
- **Output:** updated prices and `previous_price` history
- **Use:** detect price drops and new inventory

#### 5. Property Detail Enrichment

**Teams that need deep data on a shortlist.**

- **Input:** detail mode with specific listing URLs/IDs
- **Output:** build year, tower floors, annual IPTU, tour links, full photos
- **Use:** populate a listing page or valuation report

#### 6. Data Feeds & Dashboards

**Builders powering a real-estate dashboard.**

- **Input:** scheduled overview runs by city
- **Output:** clean JSON ready for a database
- **Use:** keep an internal property dashboard current

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/loft-property-scraper').call({
  scrapeMode: 'overview',
  searchMode: 'byCity',
  cities: ['sao paulo, sp'],
  maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/loft-property-scraper').call(
    run_input={
        'scrapeMode': 'overview',
        'searchMode': 'byCity',
        'cities': ['sao paulo, sp'],
        'maxResults': 100,
    }
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~loft-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCity","cities":["sao paulo, sp"]}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule or webhook
2. **HTTP Request**: Call the actor API
3. **Process**: Handle JSON results
4. **Action**: Save to a sheet, notify a channel, or sync to your CRM

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 listings** per run — full feature access, same quality
- No credit card required
- Perfect for testing and small projects

#### PAID Tier (Production Ready)

- **Unlimited** listings per run
- Faster processing, no caps
- Pay-per-result: only charged for listings actually extracted

💰 **Cost-efficient by design** — Overview mode is the cheap, high-volume path; pay the premium Detail rate only on the listings you choose to enrich.

🔗 [View current pricing](https://apify.com/sian.agency/loft-property-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many listings can I extract?**
A: FREE tier: 25 per run. PAID tier: unlimited.

**Q: What's the difference between Overview and Detail mode?**
A: Overview is the fast, cheap list — great for bulk. Detail enriches each listing with build year, tower floors, annual IPTU, tour links and the full photo set.

**Q: Can I search a specific neighbourhood?**
A: Yes — set the `neighborhood` facet (e.g. `pinheiros, sao paulo, sp`) or paste a filtered search URL.

**Q: What output formats are available?**
A: JSON, CSV, and Excel — export directly from the Apify dataset.

**Q: Do I need an API key or a Loft account?**
A: No. Just provide a city or URLs and run.

**Q: Which currency are prices in?**
A: Brazilian Real (BRL), as listed on the site.

**Q: Is this legal?**
A: We only extract publicly available listing data. See the legal note below.

***

### 🐛 Troubleshooting

**No results returned**

- Check the city format: `"city, uf"` lowercase (e.g. `sao paulo, sp`)
- Confirm the `transactionType` (for\_sale vs for\_rent) matches what's available

**Fewer results than expected**

- FREE tier is capped at 25 listings — switch to PAID for unlimited
- Raise `maxResults`

**Detail mode is slower**

- Detail fetches each listing individually for the full record — use Overview for bulk lists and Detail only on a shortlist

**Hitting limits at very high volume**

- Set `proxyCountry` to `BR` to spread requests across a Brazilian residential exit

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what has been chosen to be shared publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

#### Trademark notice

**Loft** is a trademark of Loft Tecnologia S.A. and/or its respective owners. This actor is an **independent** tool and is **not affiliated with, endorsed by, or sponsored by** Loft. All product names, logos, and brands are property of their respective owners and are used for identification purposes only.

***

### 🤝 Support

[![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi)

**Join our active support community**

- For issues or questions, open an issue in the actor's repository
- Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `scrapeMode` (type: `string`):

⚡ **OVERVIEW (default, cheapest):** fast list extraction from Loft's public search API — price, area, rooms, location, photos and more for every listing.

🔎 **DETAIL:** full per-listing record enriched with building metadata (build year, tower floors), annual IPTU, virtual/video tour URLs and the complete photo set. Discovers listings via the overview path, then enriches each one.

## `searchMode` (type: `string`):

How to find listings:

- **📍 By city** — provide one or more city facets (e.g. `sao paulo, sp`).
- **🔗 By search URL** — paste loft.com.br search URLs from your browser.
- **🆔 By listing URL** — provide specific listing URLs or IDs (detail mode only).

## `cities` (type: `array`):

🏙️ **CITY FACETS:** one or more `"city, uf"` strings, e.g. `sao paulo, sp` or `rio de janeiro, rj`.

💡 **TIP:** lowercase, comma + space. Used when **Search mode = By city**.

📋 Click **Bulk edit** to paste several cities (one per line).

## `searchUrls` (type: `array`):

🔗 **SEARCH URLS:** paste loft.com.br search URLs, e.g. `https://loft.com.br/venda/imoveis/sp/sao-paulo`.

💡 Any filters in the URL (bedrooms, neighborhood, …) are carried through. Used when **Search mode = By search URL**.

## `listingUrls` (type: `array`):

🆔 **DETAIL TARGETS:** specific listing URLs (e.g. `https://loft.com.br/imovel/.../1fdwpn8`) or bare IDs (e.g. `1fdwpn8`).

Used when **Scrape mode = Detail** and **Search mode = By listing URL**.

## `transactionType` (type: `string`):

💰 **For sale (venda)** or 🔑 **For rent (aluguel)**. Applies to city / search-URL discovery.

## `orderBy` (type: `string`):

📊 **Sort order** for the search results:

- **rankB** — Loft relevance (default).
- **rankA** — alternate relevance score.

ℹ️ Sorting by price is not supported by Loft's API.

## `neighborhood` (type: `string`):

🏘️ **OPTIONAL NEIGHBORHOOD FILTER:** display facet, e.g. `pinheiros, sao paulo, sp`. Narrows the search to a single neighborhood.

## `minBedrooms` (type: `integer`):

🛏️ **MIN BEDROOMS:** returns listings with at least this many bedrooms (≥ N).

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

🔢 **MAX LISTINGS PER RUN.**

🎯 **TIER-BASED LIMITS:**

- **FREE users:** up to 25 listings per run
- **PAID users:** unlimited

💡 Overview paginates automatically (38 listings per page) until this cap.

## `proxyCountry` (type: `string`):

🌐 **OPTIONAL PROXY:** set to `BR` to route requests through a Brazilian residential exit (helps at very high volume). Leave **blank** to run DIRECT (default, fastest, no proxy cost).

## Actor input object example

```json
{
  "scrapeMode": "overview",
  "searchMode": "byCity",
  "cities": [
    "sao paulo, sp"
  ],
  "transactionType": "for_sale",
  "orderBy": "rankB",
  "maxResults": 100
}
```

# Actor output Schema

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

Clean structured Loft listings (JSON/CSV/Excel).

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/loft-property-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/loft-property-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 '{}' |
apify call sian.agency/loft-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/loft-property-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/szTTni4ufU1EZb769/builds/1cNqQY16pcheBGuGJ/openapi.json