ChavesNaMão Scraper 🇧🇷 — Brazil Property Data & Real Estate API 🏠

🎉 Turn ChavesNaMão listings into clean structured data — sale & rent, every Brazilian state, no API key

Built for real-estate analysts, proptech teams, investors and lead-gen agencies who need Brazil property data at scale

---

📋 Overview

Scrape ChavesNaMão — one of Brazil's largest property marketplaces — into ready-to-use datasets. Pull thousands of listings with price, condo fees, IPTU, size, bedrooms, suites, garages, full address, GPS coordinates, neighbourhood, amenities, agent contact and photos — as JSON, CSV or Excel.

Why proptech teams and investors choose us:

• ✅ Complete listings: up to 44 fields per property — price, condo, IPTU, area, beds, baths, suites, parking, GPS, ZIP, agent CRECI & phone, amenities, photos
• ⚡ Fast & affordable Overview mode: pull the search list straight from the page in seconds — the cheapest way to harvest volume
• 🎯 Both contracts: sale (à venda) and rent (para alugar), in São Paulo, Rio, Curitiba and every other city
• 💸 Pay-per-result: only pay for listings you actually extract — generous FREE tier, no credit card to start
• 💎 Detail mode with everything: GPS, ZIP/CEP, condo/IPTU split, suites, garages, agent phone & CRECI, descriptions and full amenity lists — each detail row is also enriched with the overview fields, so you always get a complete record
• ✨ Investor KPIs built in: automatic price-per-m² (R$/m²) and a thumbnail-first row for instant gallery views

---

✨ Features

• 🏠 Sale & rent listings: à venda and para alugar in one actor
• 📍 Search by place, URL or listing URL: type a location slug, paste a search URL, or feed exact listing URLs
• 💵 Full pricing breakdown: price, formatted price, condo fee, IPTU
• 📐 Rich specs: total & useful area (m²), bedrooms, bathrooms, suites, parking/garages
• 🧭 Geo data: full street address, neighbourhood, city, state, ZIP/CEP, latitude & longitude
• 🧑‍💼 Agent contact: agent/agency name, phone, CRECI registration, profile URL
• 📸 Full photo gallery: every listing image URL, plus a cover thumbnail
• 🗂️ Amenities: separate in-unit and building/condominium feature lists; trade-in & pet-friendly flags
• 📊 Computed KPIs: price-per-m² in BRL, ready for comparables and yield models
• 🔢 Filters & sorting: narrow by price, bedrooms and parking, order by price/area/newest; cap each run with Max results
• 📤 Clean exports: JSON, CSV and Excel directly from the dataset

---

🎬 Quick Start

Pick a mode (Overview for speed, Detail for full data), tell it where to look (a place slug, a search URL, or listing URLs), and run. Results stream into your dataset as clean rows you can export to JSON, CSV or Excel.

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

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your mode

Pick Overview (fast & cheap — the search-list fields) or Detail (full fields per listing).

Step 2: Tell it where to look

Type one or more ChavesNaMão location slugs (e.g. sp-sao-paulo), paste a search URL, or — in Detail mode — paste listing URLs. Choose Sale or Rent.

Step 3: Run it

Click Start (or call the API). Listings stream into your dataset in real time.

That's it! In under a minute, you'll have:

• A clean table of ChavesNaMão listings with prices and specs
• GPS, ZIP, agent contact and full amenities (Detail mode)
• A JSON / CSV / Excel export ready for your model or CRM

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (fast & cheap) or detail (full fields). Default overview.
searchMode	string	No	byPlace, bySearchUrl, or byListingUrl (detail only).
places	array	No	ChavesNaMão location slugs, e.g. sp-sao-paulo, rj-rio-de-janeiro.
contract	string	No	sale (à venda) or rent (para alugar). Default sale.
typeSlug	string	No	Property-type slug (default imoveis; e.g. apartamentos, casas).
sort	string	No	relevance, price_asc, price_desc, area_asc, area_desc, newest.
searchUrls	array	No	chavesnamao.com.br search-results URLs.
listingUrls	array	No	Detail mode: full chavesnamao.com.br listing URLs.
maxResults	integer	No	Cap listings per run. FREE: 25. PAID: unlimited.
maxPages	integer	No	Max search pages per place (15 listings each). Default 20.
minPrice / maxPrice	integer	No	Price filters (R$).
minBedrooms / minGarages	integer	No	Minimum bedrooms / parking spaces.
proxyCountry	string	No	Empty = direct (default). BR routes through a Brazilian residential proxy for very large runs.

Example — by place:

{
  "scrapeMode": "overview",
  "searchMode": "byPlace",
  "places": ["sp-sao-paulo", "rj-rio-de-janeiro"],
  "contract": "sale",
  "sort": "newest",
  "maxResults": 200
}

Example — detail by listing URL:

{
  "scrapeMode": "detail",
  "searchMode": "byListingUrl",
  "listingUrls": ["https://www.chavesnamao.com.br/imovel/apartamento-a-venda-sp-sao-paulo/id-42593585/"]
}

---

📤 Output

Results are saved to the Apify dataset with 44 fields including:

Field	Type	Description
listingId	integer	ChavesNaMão listing identifier
url	string	Canonical listing URL
propertyTitle	string	Listing title
transaction	string	SELL or RENT
property_type	string	Apartamento, Casa, Cobertura, Terreno, etc.
price	integer	Listing price (R$)
condo_fee	string	Monthly condominium fee
iptu	string	Property tax (IPTU)
price_per_sqm_brl	integer	Computed price per m² (R$)
area_total / area_useful	integer	Area (m²)
bedrooms / bathrooms / suites / garages	integer	Property specs
neighborhood / city / state / zip_code	string	Location
latitude / longitude	number	GPS coordinates (Detail mode)
agent_name / agent_phone / agent_creci	string	Agent / agency contact (Detail mode)
amenities_unit / amenities_building	array	In-unit and building features
images	array	Full-resolution image URLs
thumbnail	string	Cover image

Example:

{
  "listingId": 42593585,
  "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-5-quartos-sp-sao-paulo/id-42593585/",
  "source": "detail",
  "propertyTitle": "Cobertura Duplex na Chácara Klabin - ACEITA PERMUTA EM ALPHAVILLE!",
  "transaction": "SELL",
  "property_type": "Apartamento",
  "category": "residential",
  "price": 4540000,
  "price_formatted": "R$ 4.540.000",
  "condo_fee": "R$ 4.880",
  "iptu": "R$ 205",
  "price_per_sqm_brl": 12611,
  "area_total": 360,
  "bedrooms": 5,
  "bathrooms": 5,
  "suites": 3,
  "garages": 5,
  "city": "São Paulo",
  "state": "SP",
  "neighborhood": "Vila Mariana",
  "zip_code": "04116-250",
  "latitude": -23.59185,
  "longitude": -46.62391,
  "agent_name": "VIA VITRINE IMOVEIS ALPHAVILLE",
  "agent_phone": "(11) 94402-0093",
  "agent_creci": "197254-F",
  "accept_trade": true,
  "image_count": 30,
  "currency": "BRL"
}

---

💼 Use Cases & Examples

1. Rental Yield & Investment Analysis

Investors and proptech analysts modelling returns across São Paulo, Rio and Curitiba.

Input: A list of neighbourhood/city slugs, contract = rent and sale. Output: Price, condo, IPTU and computed R$/m² per listing. Use: Build gross-yield and price-to-rent models for whole cities.

2. Price & Rent Comparables (CMA)

Brokers and appraisers needing fast comparables.

Input: A search URL for a specific area and property type. Output: Comparable listings with price, area and R$/m². Use: Produce a comparative market analysis in minutes, not hours.

3. Agent & Lead Generation

Agencies sourcing seller and landlord inventory plus agent contacts.

Input: By-place searches across target cities (Detail mode). Output: Listings with location, specs and agent name, phone & CRECI. Use: Feed a CRM with fresh, qualified property and agent leads.

4. Market Research & Trend Dashboards

Data teams tracking Brazil's housing market.

Input: Scheduled daily runs across multiple cities. Output: A time series of prices, inventory and condo costs. Use: Power BI / Looker dashboards on supply and pricing trends.

5. Powering a Real-Estate Data API

Proptech startups building products on Brazil listings.

Input: Programmatic API calls per region. Output: Structured JSON ready to ingest. Use: Back a search app or valuation API with live ChavesNaMão data.

6. Relocation & Site-Selection Tools

Relocation services and corporate housing teams.

Input: Rent searches filtered by bedrooms and budget. Output: Options with amenities and GPS. Use: Shortlist properties for employees moving to Brazil.

---

🔗 Integration Examples

JavaScript/Node.js

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

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

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

Python

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

run = client.actor('sian.agency/chavesnamao-property-scraper').call(
    run_input={
        'scrapeMode': 'overview',
        'searchMode': 'byPlace',
        'places': ['sp-sao-paulo'],
        'contract': 'sale',
        'maxResults': 100,
    }
)

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

cURL

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

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule (e.g. daily) or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, push to a CRM, or send an alert

---

📊 Performance & Pricing

FREE Tier (Try It Now)

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

PAID Tier (Production Ready)

• Unlimited listings per run
• Pay-per-result: only charged for listings successfully extracted
• Ideal for dashboards, comparables and data APIs

💰 Transparent pay-per-result pricing — the fast Overview event is the cheapest way to harvest Brazil property data at volume; upgrade to Detail only when you need GPS, ZIP, agent contact and the full feature list.

🔗 View current pricing

---

❓ Frequently Asked Questions

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

Q: Does it cover both sale and rent? A: Yes — set contract to sale (à venda) or rent (para alugar).

Q: What is the difference between Overview and Detail? A: Overview is the fast, cheap search-list view. Detail fetches each property page for GPS, ZIP, condo/IPTU split, suites, garages, agent phone & CRECI, full descriptions and the complete amenity lists — and is also enriched with the overview fields so each row is complete.

Q: Why do detail URLs need the full link? A: ChavesNaMão detail pages use a full SEO slug, so paste the listing URL from a search result rather than a bare numeric ID.

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

Q: Do I need a ChavesNaMão account or API key? A: No. The actor works straight out of the box.

Q: What currency are prices in? A: Brazilian Real (BRL), as published on ChavesNaMão.

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

---

🐛 Troubleshooting

No results returned

• Check your location slug — open the search on chavesnamao.com.br and copy the slug from the URL (the <uf>-<cidade> part, e.g. /imoveis-a-venda/sp-sao-paulo/).
• Make sure contract matches what's available in that area (sale vs rent).

A specific listing URL was skipped

• Sold or removed listings return a stub page with no data and are skipped automatically. Try a currently-live listing, and always paste the full SEO URL.

Fewer rows than expected in Overview

• Each search page returns 15 listings. Add more place slugs or raise Max pages to gather more properties.

Large runs slowing down

• Set proxyCountry to BR to route through a Brazilian residential proxy and avoid IP rate-limits at scale.

---

⚖️ 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 the user has chosen to share 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.

Disclaimer: This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by ChavesNaMão. "ChavesNaMão" and related marks are trademarks of their respective owners. Use this actor in compliance with ChavesNaMão's terms and all applicable laws.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools