Chaves na Mão Property Scraper: Extract Brazilian Real Estate Listings

---

What Is Chaves na Mão?

Chaves na Mão (Keys in Hand) is Brazil's leading online real estate marketplace, featuring thousands of residential and commercial properties across the country. The platform aggregates listings from private sellers, brokers, and agencies, making it a valuable source for market intelligence. However, manually extracting and analyzing property data across pagination and search results is impractical — the Chaves na Mão Property Scraper automates this workflow, delivering structured datasets of Brazilian real estate inventory.

---

Overview

The Chaves na Mão Property Scraper extracts property listing pages from the platform, transforming unstructured HTML into clean, machine-readable records. It is built for:

• Real estate investors analyzing market trends and pricing patterns
• Property aggregators building multi-source real estate databases
• Market researchers studying Brazilian property supply and demand
• Data analysts benchmarking property features against pricing
• Brokers and agencies monitoring competitor listings

The scraper handles pagination efficiently, respects max_items_per_url limits, and includes error handling to continue processing even if individual URLs fail.

---

Input Configuration

The scraper accepts a JSON configuration object with three primary parameters:

{
  "urls": [
    "https://www.chavesnamao.com.br/imoveis/brasil/?pg=8"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Parameter	Type	Description
urls	Array	List of property listing page URLs from Chaves na Mão. Include full URLs with search filters, regions, and page numbers as needed.
ignore_url_failures	Boolean	If true, the scraper continues processing remaining URLs even if some fail. Set to false to halt on first error.
max_items_per_url	Integer	Maximum number of property records to extract per URL (e.g., 200). Useful for controlling data volume and API costs.

Example workflow:

1. Navigate to Chaves na Mão and apply filters (region, price range, property type)
2. Capture the resulting list page URL (e.g., /?pg=1, /?pg=2)
3. Paste URLs into the urls array
4. Set max_items_per_url based on your needs (20–500 items typical)
5. Run the scraper

Tip: Use filtered URLs (e.g., São Paulo apartments, Rio de Janeiro commercial) to target specific market segments.

---

Output Fields Explained

Example Output Record

{
  "id": 37914793,
  "title": "Ponto comercial à venda em Pinheiros, São Paulo ",
  "breadcrumb": [
    {
      "title": "Home",
      "url": "/"
    },
    {
      "title": "Brasil",
      "url": "/ponto-comercial-a-venda/brasil/"
    },
    {
      "title": "SP",
      "url": "/ponto-comercial-a-venda/sp/"
    },
    {
      "title": "São Paulo",
      "url": "/ponto-comercial-a-venda/sp-sao-paulo/"
    },
    {
      "title": "Zona Oeste",
      "url": "/ponto-comercial-a-venda/sp-sao-paulo/zona-oeste/"
    },
    {
      "title": "Pinheiros",
      "url": "/ponto-comercial-a-venda/sp-sao-paulo/pinheiros/"
    }
  ],
  "reference": "AC0008",
  "active": true,
  "accept_trade": true,
  "pet_friendly": false,
  "leads_config": {
    "leasing": true,
    "schedule_virtual": true,
    "schedule_irl": true,
    "message": true,
    "whatsapp": true,
    "phones": true
  },
  "media": {
    "video_url": null,
    "tour360": null
  },
  "segment": "REALTY",
  "description": "O Edifício Parque dos Pinheiros está estrategicamente localizado a aproximadamente 300 metros da Marginal Pinheiros e a 700 metros do Shopping Eldorado, além de estar a cerca de 250 metros da Estação Pinheiros, ponto de integração da Linha 4 – Amarela do Metrô com a Linha 9 – Esmeralda da CPTM, oferecendo excelente mobilidade e fácil acesso às principais regiões da cidade. Inserido em uma área consolidada e valorizada, o empreendimento conta com infraestrutura completa de serviços e conveniências no entorno, com destaque para a proximidade imediata do Shopping Eldorado e da Estação Pinheiros, facilitando o dia a dia corporativo de colaboradores e clientes. O imóvel possui 517 m² de área útil interna, desconsideradas as vagas de garagem, e apresenta planta funcional e eficiente, com forro termoacústico em gesso, sistema de ar-condicionado tipo split, banheiros, copa e shaft de dados com infraestrutura de CPD e cabeamento já instalados, permitindo ocupação imediata e adequação às necessidades corporativas. A garagem dispõe de seis vagas no subsolo e uma vaga no piso térreo destinada a visitantes ou funcionários. O edifício é composto por seis andares e oferece portaria com sistema de segurança, dois elevadores sociais, escadas de emergência e completo sistema de combate a incêndio, com sprinklers, hidrantes, alarme endereçável e detecção de fumaça. Conta ainda com gerador de energia atendendo as áreas comuns e os elevadores, garantindo maior segurança e continuidade operacional. 06/06/2026",
  "description_raw": "O Edifício Parque dos Pinheiros está estrategicamente localizado a aproximadamente 300 metros da Marginal Pinheiros e a 700 metros do Shopping Eldorado, além de estar a cerca de 250 metros da Estação Pinheiros, ponto de integração da Linha 4 – Amarela do Metrô com a Linha 9 – Esmeralda da CPTM, oferecendo excelente mobilidade e fácil acesso às principais regiões da cidade. Inserido em uma área consolidada e valorizada, o empreendimento conta com infraestrutura completa de serviços e conveniências no entorno, com destaque para a proximidade imediata do Shopping Eldorado e da Estação Pinheiros, facilitando o dia a dia corporativo de colaboradores e clientes. O imóvel possui 517 m² de área útil interna, desconsideradas as vagas de garagem, e apresenta planta funcional e eficiente, com forro termoacústico em gesso, sistema de ar-condicionado tipo split, banheiros, copa e shaft de dados com infraestrutura de CPD e cabeamento já instalados, permitindo ocupação imediata e adequação às necessidades corporativas. A garagem dispõe de seis vagas no subsolo e uma vaga no piso térreo destinada a visitantes ou funcionários. O edifício é composto por seis andares e oferece portaria com sistema de segurança, dois elevadores sociais, escadas de emergência e completo sistema de combate a incêndio, com sprinklers, hidrantes, alarme endereçável e detecção de fumaça. Conta ainda com gerador de energia atendendo as áreas comuns e os elevadores, garantindo maior segurança e continuidade operacional. 06/06/2026",
  "area": {
    "total": "20",
    "useful": "517"
  },
  "publisher": {
    "logo": "2443941667993983.png",
    "name": "VERANO NEGÓCIOS IMOBILIÁRIOS - SÃO PAULO",
    "url": "/imobiliaria/verano-negocios-imobiliarios-sao-paulo/id-477706/",
    "type": "PJ",
    "id": 477706,
    "category": 0,
    "contract_date": null,
    "creci": "24618",
    "phones": {
      "cellphone": {
        "number": "(11) 3796-3707",
        "whatsapp": true
      },
      "landline": {
        "number": null,
        "whatsapp": false
      },
      "commercial": {
        "number": null,
        "whatsapp": false
      },
      "whatsapp": [
        "(11) 3796-3707"
      ],
      "public": true
    },
    "address": {
      "city": {
        "name": "Guarujá",
        "id": 0
      },
      "neighborhood": {
        "name": "Enseada",
        "id": 0
      },
      "state": {
        "acronym": "SP",
        "name": "SP",
        "id": 0
      },
      "address_comp": "",
      "public_address": false,
      "street": {
        "name": "Avenida Venezuela",
        "id": 0,
        "address_number": "371"
      },
      "zip_code": "11441-240"
    }
  },
  "category": "commercial",
  "highlighted": false,
  "url": "/imovel/ponto-comercial-a-venda-com-garagem-sp-sao-paulo-pinheiros-20m2-RS8000000/id-37914793/",
  "prices": {
    "main": "R$ 8.000.000",
    "condominium_fee": "R$ 11.890",
    "raw_price": 8000000,
    "iptu_value": "R$ 5.687"
  },
  "show_condominium": true,
  "pictures": {
    "count": 10,
    "featured": "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a16e110-1.jpg",
    "list": [
      "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a16e110-1.jpg",
      "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a12ea51-2.jpg",
      "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a12ea51-3.jpg",
      "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a12ea51-5.jpg",
      "477706/37914793/sp-sao-paulo-pinheiros-rua-eugenio-de-medeiros-a-venda-6a12ea51-6.jpg"
    ]
  },
  "realty_type": {
    "name": "Loja / Comércio",
    "title_name": "Loja / Comércios",
    "id": 14,
    "url": "ponto-comercial",
    "prefix": "desta"
  },
  "transaction": "SELL",
  "commercial_rooms": {
    "count": null,
    "max": null
  },
  "show_details_characteristics": true,
  "bedrooms": {
    "count": null,
    "max": null
  },
  "bathrooms": {
    "count": 6,
    "max": null
  },
  "suites": {
    "count": null,
    "max": null
  },
  "garages": {
    "count": 6,
    "max": null
  },
  "location": {
    "zip_code": "",
    "street": {
      "id": "",
      "name": "",
      "url": "",
      "address_number": "--"
    },
    "neighborhood": {
      "id": 54990,
      "name": "Pinheiros",
      "url": "pinheiros",
      "geoposition": {
        "lat": "-23.5635787",
        "lon": "-46.6916068"
      },
      "prefix": "em"
    },
    "city": {
      "id": 9668,
      "name": "São Paulo",
      "url": "sp-sao-paulo",
      "geoposition": {
        "lat": "-23.567387",
        "lon": "-46.570381"
      },
      "prefix": "em"
    },
    "state": {
      "id": 26,
      "name": "São Paulo",
      "url": "sp",
      "acronym": "SP"
    },
    "address_comp": "",
    "public_address": false
  },
  "distance": null,
  "updated_at": "2026-06-06 18:25:07",
  "created_at": "2025-12-18T12:03:19.000Z",
  "proximities": {
    "bus_stops": [
      {
        "distance": 100,
        "name": "Rua Amaro Cavalheiro, 418"
      },
      {
        "distance": 130,
        "name": "Rua Eugênio de Medeiros, 96"
      },
      {
        "distance": 270,
        "name": "Parada Carlos Reis"
      },
      {
        "distance": 290,
        "name": "Pinheiros"
      },
      {
        "distance": 330,
        "name": "São Manuel"
      },
      {
        "distance": 350,
        "name": "Terminal Pinheiros"
      },
      {
        "distance": 350,
        "name": "Rua Paes Leme, 79"
      },
      {
        "distance": 400,
        "name": "Avenida Magalhães de Castro, 1282-1298"
      },
      {
        "distance": 440,
        "name": "Shopping Eldorado"
      },
      {
        "distance": 490,
        "name": "Parada 2 - Ferreira De Araújo"
      }
    ],
    "hospitals": [
      {
        "distance": 600,
        "name": "Centro de Saúde Doutor Victor Araujo H Mello Pinheiros"
      },
      {
        "distance": 1130,
        "name": "Prevent Senior Londres - Núcleo de Medicina Avançada e Diagnóstica"
      },
      {
        "distance": 1290,
        "name": "Hospital Luz Butantã"
      },
      {
        "distance": 1430,
        "name": "Hospital Jardins"
      },
      {
        "distance": 1690,
        "name": "Prevent Senior"
      }
    ],
    "parks": [
      {
        "distance": 250,
        "name": "Praça Antônio Sabino"
      },
      {
        "distance": 350,
        "name": "Praça Eugene Boudin"
      },
      {
        "distance": 370,
        "name": "Bosque da Batata"
      },
      {
        "distance": 390,
        "name": "Praça Filippo Brunelleschi"
      },
      {
        "distance": 400,
        "name": "Praça Oliveira Penteado"
      },
      {
        "distance": 420,
        "name": "Praça Erik Bryggman"
      },
      {
        "distance": 530,
        "name": "Largo dos Pinheiros"
      },
      {
        "distance": 540,
        "name": "Praça Jorge de Lima"
      },
      {
        "distance": 580,
        "name": "Praça Victor Civita"
      },
      {
        "distance": 610,
        "name": "Largo da Batata"
      }
    ],
    "malls": [
      {
        "distance": 580,
        "name": "Shopping Eldorado"
      },
      {
        "distance": 1200,
        "name": "Galeria 36"
      },
      {
        "distance": 1210,
        "name": "Shopping Vitrine Iguatemi"
      },
      {
        "distance": 1520,
        "name": "Shopping Iguatemi"
      }
    ],
    "schools": [
      {
        "distance": 270,
        "name": "Unicid Curso de Medicina"
      },
      {
        "distance": 530,
        "name": "Colégio Objetivo"
      },
      {
        "distance": 550,
        "name": "Teatro Escola Macunaíma - Unidade Butantã"
      },
      {
        "distance": 590,
        "name": "Universidade Paulista"
      },
      {
        "distance": 650,
        "name": "Escola Estadual Alfredo Bresser"
      },
      {
        "distance": 740,
        "name": "Saint Nicholas School"
      },
      {
        "distance": 740,
        "name": "Colegio 24 de Março"
      },
      {
        "distance": 800,
        "name": "Escola Tecnica Estadual Guaracy Silveira"
      },
      {
        "distance": 1100,
        "name": "Wizard"
      },
      {
        "distance": 1110,
        "name": "Colegio Palmares"
      }
    ],
    "gyms": [
      {
        "distance": 840,
        "name": "Lu Couto"
      },
      {
        "distance": 920,
        "name": "Canto do Corpo"
      },
      {
        "distance": 1280,
        "name": "Smart Fit"
      },
      {
        "distance": 1300,
        "name": "Academia Pinheiros"
      },
      {
        "distance": 1400,
        "name": "Academia de Polícia"
      },
      {
        "distance": 1400,
        "name": "Movemento"
      },
      {
        "distance": 1560,
        "name": "Oficina de Saúde"
      },
      {
        "distance": 1740,
        "name": "Integra"
      },
      {
        "distance": 1860,
        "name": "Fabrica Escalada"
      }
    ],
    "restaurants": [
      {
        "distance": 130,
        "name": "Erva Doçe Bar e Restaurante"
      },
      {
        "distance": 140,
        "name": "Restaurante Paes Leme"
      },
      {
        "distance": 180,
        "name": "Grão Expresso"
      },
      {
        "distance": 190,
        "name": "Lanchonete Estrela de Pinheiros"
      },
      {
        "distance": 200,
        "name": "Café e Restaurante Estação Pinheiros"
      },
      {
        "distance": 200,
        "name": "Dona Shopia"
      },
      {
        "distance": 210,
        "name": "Cubo Smoked BBQ"
      },
      {
        "distance": 210,
        "name": "Aro 27 - Bike Café"
      },
      {
        "distance": 220,
        "name": "Restaurante Mercado Natural"
      },
      {
        "distance": 220,
        "name": "Lu & Leo"
      }
    ],
    "supermarkets": [
      {
        "distance": 260,
        "name": "Mareloi"
      },
      {
        "distance": 270,
        "name": "Casa das Fitas"
      },
      {
        "distance": 500,
        "name": "BR Mania"
      },
      {
        "distance": 520,
        "name": "Carrefour Express"
      },
      {
        "distance": 580,
        "name": "Padrão"
      },
      {
        "distance": 620,
        "name": "Americana Express"
      },
      {
        "distance": 760,
        "name": "OXXO"
      },
      {
        "distance": 810,
        "name": "Futurama"
      },
      {
        "distance": 830,
        "name": "Oxxo"
      },
      {
        "distance": 850,
        "name": "Blue Point"
      }
    ],
    "pharmacies": [
      {
        "distance": 510,
        "name": "Drogasil"
      },
      {
        "distance": 520,
        "name": "Farmacia Ubiratan"
      },
      {
        "distance": 620,
        "name": "Drogaria e Perfumaria Akyali"
      },
      {
        "distance": 730,
        "name": "Drogaria São Paulo"
      },
      {
        "distance": 740,
        "name": "Pague Menos"
      },
      {
        "distance": 750,
        "name": "Center Fórmula"
      },
      {
        "distance": 850,
        "name": "Drogaria Central do Butantã"
      },
      {
        "distance": 950,
        "name": "Farmais"
      },
      {
        "distance": 960,
        "name": "Drogaria ultra"
      },
      {
        "distance": 980,
        "name": "Ultrafarma"
      }
    ],
    "metros": [
      {
        "distance": 290,
        "name": "Pinheiros"
      },
      {
        "distance": 660,
        "name": "Faria Lima"
      },
      {
        "distance": 860,
        "name": "Butantã"
      },
      {
        "distance": 1650,
        "name": "Fradique Coutinho Oeste"
      },
      {
        "distance": 1660,
        "name": "Fradique Coutinho Leste"
      },
      {
        "distance": 1670,
        "name": "Fradique Coutinho"
      }
    ]
  },
  "status": "",
  "revision": false,
  "score": 0,
  "accept_trades": true,
  "from_url": "https://www.chavesnamao.com.br/imoveis/brasil/"
}

Each property record includes 37 data fields covering identification, pricing, physical characteristics, and metadata:

Property Identification

Field	Meaning
ID	Unique internal identifier for the property listing
Title	Property headline (e.g., "3 Bedroom Apartment in Copacabana")
Reference	Listing reference number used by the broker or agency
URL	Direct link to the full property detail page
Breadcrumb	Hierarchical navigation path on the site

Listing Status & Flags

Field	Meaning
Active	Boolean indicating if the listing is currently active
Status	Current state of the property (active, sold, unavailable)
Highlighted	Whether the listing has premium/featured placement
Accept Trade	Whether the seller accepts property trade-ins
Pet Friendly	Whether pets are allowed in the property

Pricing & Financial

Field	Meaning
Prices	Purchase price, rental price, or both (in BRL)
Accept Trades	Trade-in value or alternative payment options

Property Details & Characteristics

Field	Meaning
Bedrooms	Number of bedrooms (integer or range)
Bathrooms	Number of bathrooms
Suites	Number of en-suite bedrooms
Garages	Number of parking spaces
Commercial Rooms	Rooms suitable for office or commercial use
Area	Total floor area in square meters (m²)
Realty Type	Property category (apartment, house, commercial, land, etc.)
Category	Subcategory or specific property classification
Transaction	Type of transaction (buy, rent, lease)
Show Condominium	Condominium/HOA fees displayed separately
Show Details Characteristics	Flag for detailed feature availability

Location & Geography

Field	Meaning
Location	Full address or neighborhood name
Distance	Distance from a reference point (usually city center)
Proximities	Nearby landmarks, metro stations, or amenities

Content & Media

Field	Meaning
Description	Formatted description of the property (HTML)
Description Raw	Plain-text version of the description
Pictures	URLs or count of property photos
Media	All media assets (photos, videos, virtual tours)
Segment	Market segment (luxury, budget, mid-range)

Publisher & Admin Data

Field	Meaning
Publisher	Name of the listing agent or agency
Leads Config	Configuration for lead capture (email, phone, form)
Created At	Timestamp when the listing was first posted
Updated At	Last modification timestamp
Revision	Version number of the listing
Score	Internal quality or relevance score

---

How to Use

1. Select target URLs — Search Chaves na Mão for properties matching your criteria (region, price, type). Copy the resulting page URL.

2. Configure parameters:

   • Paste URLs (one or multiple pages) into urls
   • Set max_items_per_url based on total target volume
   • Enable ignore_url_failures: true for robust multi-URL runs

3. Start the scraper — Initiate the run and monitor the execution logs for success/failure counts.

4. Export and process — Download results in JSON, CSV, or Excel format. Use the structured fields for analysis, filtering, or integration into your database.

Best practices:

• Use region-specific URLs to organize data by state (e.g., São Paulo, Minas Gerais)
• Set max_items_per_url: 200 for balanced runs covering ~10 pages per URL
• Filter by property type beforehand (apartments, commercial, land) to ensure data relevance

---

Real-World Applications

• Investment analytics: Track price trends, rental yields, and appreciation across Brazilian regions
• Market reports: Build monthly dashboards of new listings, avg prices, and days-on-market
• Competitor monitoring: Capture competitor agency listings and portfolio positioning
• Real estate aggregation: Feed Chaves na Mão data into your own multi-platform property portal
• Academic research: Analyze Brazilian housing markets, affordability, and gentrification patterns

The scraper delivers clean, timestamped data across 37 fields, eliminating manual data entry and enabling data-driven decision-making in Brazilian real estate.

---

Conclusion

The Chaves na Mão Property Scraper provides efficient, reliable access to Brazil's largest real estate marketplace. Whether you're an investor, researcher, or aggregator, this scraper transforms property listings into actionable intelligence. Start scraping today and unlock insights into pricing, market supply, and regional trends across Brazil.