# Lugarcerto Property Search Scraper (`alexist/lugarcerto-property-search-scraper`) Actor

Scrape thousands of property listings from LugarCerto.com.br instantly. Extract prices, locations, specifications, and images for every listing — ideal for real estate analysts, investors, and market researchers tracking the Brazilian property market.

- **URL**: https://apify.com/alexist/lugarcerto-property-search-scraper.md
- **Developed by:** [Alex](https://apify.com/alexist) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 2 total users, 1 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?

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

## LugarCerto Property Search Scraper: Automate Brazilian Real Estate Data Collection

***

### What Is LugarCerto.com.br?

LugarCerto.com.br is Brazil's leading online real estate marketplace, aggregating residential and commercial property listings across multiple states and municipalities. The platform hosts hundreds of thousands of active postings updated daily. For real estate professionals, investors, and data analysts, manually collecting property data is inefficient — the **LugarCerto Property Search Scraper** automates extraction of structured property records at scale.

***

### Overview

The **LugarCerto Property Search Scraper** extracts detailed property listings from LugarCerto search results pages, transforming unstructured HTML into clean, machine-readable records. It is designed for:

- **Real estate investors** building market intelligence datasets
- **Property analysts** tracking price trends and market dynamics
- **Real estate platforms** aggregating listings from multiple sources
- **Market researchers** studying Brazilian residential and commercial sectors
- **Data professionals** feeding property data into CRMs and analytics tools

Key strengths include configurable item limits per search page, flexible URL handling with failure tolerance, and comprehensive field extraction covering pricing, location, specifications, and visual assets.

***

### Input Format

The scraper accepts a JSON configuration object:

```json
{
    "urls": [
        "https://estadodeminas.lugarcerto.com.br/busca",
        "https://region2.lugarcerto.com.br/busca"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Field | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to LugarCerto search result pages. Supports regional and state-level search URLs. Add one or multiple URLs to scrape. |
| `max_items_per_url` | Integer | Maximum number of property listings extracted per search page. Range: 1–200 (default: 100). Higher values capture more listings per URL. |
| `ignore_url_failures` | Boolean | If `true`, continues scraping remaining URLs if some fail. If `false`, stops on first failure. Recommended: `true` for bulk runs. |

> **Tip:** Regional URLs like `estadodeminas.lugarcerto.com.br/busca` narrow results to specific states (e.g., Minas Gerais), useful for targeted market research.

***

### Output Format

**Sample output**

```json
{
  "area": 3940,
  "bairro": "Passárgada",
  "codigoanunciante": "ppc_coa_39860",
  "descricao": "Casa em Condomínio, 4 Quartos, 4 Vagas, 1 Suite",
  "descricaoanuncio": "Casa em Condomínio, 4 Quartos, 4 Vagas, 1 Suite",
  "endereco": "Alameda do Encantado",
  "idanuncio": "341997722",
  "local": "Nova Lima - MG",
  "logradouro": "",
  "numbanheiros": 3,
  "numquartos": 4,
  "numvagas": 4,
  "prazoentrega": null,
  "preco": "2500000.0",
  "preco_fmt": "2.500.000,00",
  "secao": "Compra e Venda",
  "urldestino": "//estadodeminas.lugarcerto.com.br/imovel/casa-em-condominio-4-quartos-passargada-nova-lima-com-garagem-3940m2-compra-e-venda-rs2500000-id-341997722",
  "urlthumbgrande": "https://i.lugarcerto.com.br/Py7ireXdNVAHyzB4uEmoEfRDj20=/fit-in/295x258/imgs.carteira.lugarcerto.com.br/anuncio/lugarcerto/3/6/2/362df1669dbbcdca2a60837088a971dc/341997722_247587252_g.jpg",
  "from_url": "https://estadodeminas.lugarcerto.com.br/busca"
}
```

Each property returns a record with 17 fields covering location, pricing, specifications, and media:

#### Property Identification & Pricing

| Field | Portuguese Name | Meaning |
|---|---|---|
| `ID Anuncio` | ID do anúncio | Unique identifier for the property listing in LugarCerto system |
| `Codigo Anunciante` | Código anunciante | Advertiser/broker code linking the listing to a real estate agent or agency |
| `Preco` | Preço | Numeric property price (raw value, e.g., `450000`) in Brazilian Real (BRL) |
| `Preco Formatado` | Preço formatado | Human-readable price with currency formatting (e.g., "R$ 450.000,00") |

#### Location & Address

| Field | Portuguese Name | Meaning |
|---|---|---|
| `Endereco` | Endereço | Full street address of the property |
| `Logradouro` | Logradouro | Street name or thoroughfare designation |
| `Local` | Local | Specific neighborhood or locality identifier |
| `Bairro` | Bairro | District/neighborhood name (e.g., "Funcionários", "Savassi") |
| `Secao` | Seção | Administrative section or zone within the city |

#### Property Specifications

| Field | Portuguese Name | Meaning |
|---|---|---|
| `Numero Quartos` | Número quartos | Number of bedrooms (integer value) |
| `Numero Banheiros` | Número banheiros | Number of bathrooms (integer value) |
| `Numero Vagas` | Número vagas | Number of parking spaces or garage spots available |
| `Area` | Área | Total property area in square meters (m²) |

#### Descriptions & Details

| Field | Portuguese Name | Meaning |
|---|---|---|
| `Descricao` | Descrição | Short property type or category (e.g., "Apartamento", "Casa", "Comercial") |
| `Descricao Anuncio` | Descrição anúncio | Full property description provided by the listing owner/agent; includes details, amenities, and special features |
| `Prazo Entrega` | Prazo entrega | Delivery timeline (for new constructions); typically a date or status like "Pronto" (ready) or "Em construção" (under construction) |

#### Media & Links

| Field | Portuguese Name | Meaning |
|---|---|---|
| `URL Destino` | URL destino | Direct link to the full property listing page on LugarCerto |
| `URL Thumb Grande` | URL thumb grande | URL of the main/featured property image thumbnail for display purposes |

***

### How to Use

1. **Find search URLs** — Go to LugarCerto.com.br, filter by state or region, and copy the search results page URL.
2. **Prepare configuration** — Add URLs to the `urls` array. Set `max_items_per_url` to control volume (e.g., 50 for light runs, 200 for comprehensive scrapes).
3. **Enable failure tolerance** — Set `ignore_url_failures: true` to skip broken or blocked URLs without interrupting the run.
4. **Execute the scraper** — Start the actor and monitor progress via the run logs.
5. **Export & analyze** — Download results as JSON, CSV, or Excel for further analysis, CRM import, or database storage.

**Common tips:**

- Regional URLs extract listings from specific states; combine multiple URLs for nationwide coverage.
- Images (via `URL Thumb Grande`) useful for building property galleries or visual analysis.
- `Descricao Anuncio` often contains crucial details like "aceita financiamento" (accepts financing) — parse for investment criteria.
- `Preco Formatado` is display-ready; use `Preco` for numerical calculations.

***

### Use Cases & Business Value

- **Market analysis:** Track average prices, price per m², and trends across neighborhoods and regions
- **Investment scouting:** Filter properties by specs, price range, and delivery status for acquisition opportunities
- **Comparative market analysis (CMA):** Build datasets to benchmark asking prices for similar properties
- **Real estate aggregators:** Populate multi-source property platforms with LugarCerto listings
- **Lead generation:** Identify new listings for buyer/investor outreach
- **Academic research:** Study Brazilian real estate market dynamics, affordability trends, and urban development patterns

The LugarCerto Property Search Scraper transforms hours of manual browsing into minutes of automated data collection, enabling faster decisions and deeper market insights.

***

### Conclusion

The **LugarCerto Property Search Scraper** is the essential tool for anyone operating in Brazil's real estate market. Whether tracking investments, analyzing neighborhoods, or building an aggregator platform, this scraper delivers accurate, comprehensive property data in structured format. Combine multiple search URLs, scale to hundreds of listings per run, and unlock market intelligence that manual work simply cannot match.

# Actor input Schema

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

Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://estadodeminas.lugarcerto.com.br/busca"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}
```

# 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://estadodeminas.lugarcerto.com.br/busca"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/lugarcerto-property-search-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://estadodeminas.lugarcerto.com.br/busca"],
    "ignore_url_failures": True,
    "max_items_per_url": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/lugarcerto-property-search-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://estadodeminas.lugarcerto.com.br/busca"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}' |
apify call alexist/lugarcerto-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexist/lugarcerto-property-search-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/qChGHPNQ4PIJ7M66z/builds/swxwi27CcgKuztuXL/openapi.json