Chaves na Mão Scraper — Brazil Real-Estate Listings & Filters

Collect Chaves na Mão property listings across Brazil for sale and rent. Compare prices, understand local inventory, and export structured real-estate data for research, pricing, and lead generation.

SEO keywords: Chaves na Mão scraper, Brazil real-estate listings, property data, sale and rent listings, Apify actor.

🤖 What does Chaves na Mão Scraper do?

• Collect public property listings across Brazil.
• Search by a friendly city, zone, neighborhood, or street name.
• Use latitude and longitude to find the nearest city automatically.
• Filter by price, area, bedrooms, bathrooms, parking spaces, amenities, property type, new developments, nearby places, and advertiser.
• Choose listings for sale or rent and export a clean dataset as JSON, CSV, or Excel.

Great for: market research, rental and sale comparisons, price monitoring, inventory analysis, and real-estate lead generation.

💡 Why use Chaves na Mão?

• 📈 Track price trends — compare asking prices and property sizes across Brazilian locations.
• 🏘️ Understand inventory — segment listings by operation, property type, rooms, and amenities.
• 🎯 Build useful datasets — combine location and listing details for research or outreach.

🚀 Quick start in Apify

1. Open the actor in Apify Console and choose Try for free.
2. Choose For sale or For rent.
3. Set Maximum listings, then add a location or any filters you need.
4. Click Start and open the Dataset tab to view or export JSON, CSV, or Excel results.

📝 Input parameters

Parameter	Type	Required	Description
operation	enum	Yes	sale for properties for sale or rent for properties to rent.
maxItems	integer	Yes	Maximum listings to collect. Set to 0 to request all available listings within the actor's result limit.
fetchDetails	boolean	No	Fetch the full structured details page for each listing and add it under _details. Uses one additional request per listing and may increase run time and cost.
location	string	No	Friendly city, zone, neighborhood, or street name. Example: São Paulo. When omitted, the search covers Brazil.
locationType	enum	No	Restrict matching to city, zone, neighborhood, or street. Leave empty for automatic matching.
minPrice / maxPrice	integer	No	Minimum and maximum price in Brazilian reais.
minArea / maxArea	integer	No	Minimum and maximum area in square metres.
bedrooms	integer	No	Minimum number of bedrooms.
bathrooms	integer	No	Minimum number of bathrooms.
garages	integer	No	Minimum number of parking spaces.
amenities	enum list	No	Selected amenities, such as pool, elevator, air-conditioning, furnished, garden, or balcony.
propertyTypes	enum list	No	Selected categories, such as apartment, house, condominium, land, or studio.
launchOnly	boolean	No	Limit results to new developments.
nearbyPlaces	enum list	No	Nearby subway, parks, or shopping places; the platform uses a fixed distance of up to 1 km.
advertiser	enum	No	all, owner, or agency.
latitude / longitude	number	No	Coordinate pair used to resolve the nearest city. Provide both values; coordinates take precedence over location.

Example inputs

Brazil-wide sale search

{
  "operation": "sale",
  "maxItems": 100
}

Filtered São Paulo rental search

{
  "operation": "rent",
  "location": "São Paulo",
  "locationType": "city",
  "minPrice": 1800,
  "maxPrice": 5000,
  "bedrooms": 2,
  "amenities": ["pool", "elevator"],
  "propertyTypes": ["apartment"],
  "nearbyPlaces": ["subway"],
  "advertiser": "agency",
  "fetchDetails": true,
  "maxItems": 50
}

🧭 Tips and recipes

• Review a small sample first: start with maxItems between 25 and 100.
• Collect the full available set: set maxItems to 0; the actor's result limit still applies.
• Search all of Brazil: omit both location and coordinates.
• Disambiguate a place name: use locationType when a name could refer to more than one area.
• Use coordinate search: provide both latitude and longitude; no radius setting is required.
• Include full listing details: set fetchDetails to true; detail data is stored under _details and includes descriptions, photos, prices, publisher data, amenities, and timestamps when supplied by the listing.
• Keep filters focused: omitted filters are not applied, so add only the criteria you need.

📊 Output fields

• id, url, title — Listing identity and headline content.
• transaction — The listing transaction type returned by the site.
• prices — Price values and fees when supplied.
• area, bedrooms, bathrooms, garages — Property dimensions and room counts.
• pictures — Photos when supplied.
• location — Structured street, neighborhood, city, and state information when available.
• publisher — Advertiser name, verification status, and phone data when supplied.
• _details — Included only when fetchDetails is enabled; contains the additional structured detail object returned for the listing.

{
  "id": 26582605,
  "url": "https://www.chavesnamao.com.br/imovel/terreno-a-venda-sp-sao-paulo-jardim-claudia-889m2-RS2000000/id-26582605/",
  "title": "Terreno à venda, 889 m² por R$ 2.000.000,00 - Jardim Cláudia - São Paulo/SP",
  "transaction": "SELL",
  "prices": {"main": "R$ 2.000.000,00", "rawPrice": 2000000},
  "area": {"useful": "889", "total": "889"},
  "bedrooms": 0,
  "bathrooms": 0,
  "garages": 0,
  "pictures": {"featured": "https://www.chavesnamao.com.br/imn/1200x0800/N/70/imoveis/611560/26582605/sp-sao-paulo-jardim-claudia-rua-pixinguinha-terreno-a-venda-673c06a4-1.jpg"},
  "location": {"street": {"name": "Rua Pixinguinha"}, "city": {"name": "São Paulo"}, "state": {"acronym": "SP"}},
  "publisher": {"name": "Imobiliária Exemplo"}
}

❓ FAQ

Can I collect every available listing?

Yes. Set maxItems to 0; the actor's result limit still applies. For a first run, a smaller limit is useful for checking the output shape.

Can I provide a location name instead of coordinates?

Yes. Add location with a city, zone, neighborhood, or street name. The actor chooses the best matching area; use locationType to narrow the match when needed.

What happens when I omit location and coordinates?

The actor searches across Brazil while preserving the selected operation and filters.

Can I export the results?

Yes. Apify Dataset supports JSON, CSV, Excel, and other standard export formats.

Does every listing include every field?

No. Native fields vary by listing. Price, photos, location, and room counts are included when the site supplies them; _details appears only when detail fetching is enabled.

⚖️ Legal and ethical considerations

• Follow Chaves na Mão’s terms and applicable Brazilian law.
• Collect and use public data responsibly, respecting privacy and data-protection requirements.
• Keep request rates reasonable and avoid unnecessary repeated runs.
• Do not misrepresent your identity or use collected data for abusive contact.
• This independent Actor is not affiliated with, endorsed by, or sponsored by Chaves na Mão.

🛟 Support

Need help with the actor? Contact igolaizola.com/#contact.