Chaves na Mão Property Listings

Chaves na Mão Property Listings Scraper

Scrape public property listing cards from Chaves na Mão for Brazilian locations, covering sale, rent, or both. Billing is pay per event; see Pricing below.

• Extract listing IDs, URLs, titles, prices, locations, and property details shown on each result card.
• Compare sale, rental, or combined inventory by location.
• Build property datasets for market research, listing discovery, or inventory monitoring.
• Keep optional card fields omitted when Chaves na Mão does not display them.
• Run with your Apify account without a buyer-owned source login or API-key input.

What you get

The Actor searches a selected location, follows the source result pages, removes repeated listing IDs, and saves up to the requested maximum. Each record contains card-visible values only. id, url, and title are included for emitted listings; the other fields are optional and can be omitted when the card does not show them.

Field	Type	Description	Availability
id	string	Source listing identifier, taken from the listing card's rc- element id (the listing URL is only a fallback).	Included
url	string	Chaves na Mão listing URL.	Included
title	string	Listing title.	Included
deal_type	string	Transaction type, such as sale or rent.	Optional
property_type	string	Property type, such as Casa or Apartamento.	Optional
location	string	Location displayed on the card.	Optional
price_brl	number	Numeric price in Brazilian reais.	Optional
price_text	string	Price text displayed on the card.	Optional
area_m2	number	Property area in square metres.	Optional
bedrooms	integer	Number of bedrooms or dormitories shown.	Optional
bathrooms	integer	Number of bathrooms shown.	Optional
parking_spaces	integer	Number of parking spaces or garages shown.	Optional
image_url	string	Card image URL when an image is present.	Optional

Sample output

{
  "id": "28942505",
  "url": "https://www.chavesnamao.com.br/imovel/casa-a-venda-2-quartos-com-garagem-sp-sao-paulo-chacara-california-60m2-RS420000/id-28942505/",
  "title": "Casa com 2 dormitórios à venda por R$ 420.000,00 - Chácara Califórnia - São Paulo/SP",
  "deal_type": "sale",
  "property_type": "Casa",
  "location": "Chácara Califórnia, São Paulo/SP",
  "area_m2": 60,
  "bedrooms": 2,
  "bathrooms": 2,
  "parking_spaces": 1,
  "price_text": "R$ 420.000",
  "price_brl": 420000,
  "image_url": "https://www.chavesnamao.com.br/imn/0400X0262/N/60/imoveis/770893/28942505/sp-sao-paulo-chacara-california-rua-francisco-machado-de-campos-casa-sobrado-a-venda-2-quartos-67cbb054-1.jpg"
}

Pricing

This Actor uses pay-per-event billing. On the Free plan the events are:

Event	What it represents	Price on Free
apify-default-dataset-item	One scraped result with all fields available on that card.	$0.0015 per event on the Free plan
apify-actor-start	The Actor starting a run (one event per GB of Actor memory, minimum one).	$0.00005 per event on the Free plan

Worked examples on the Free plan, dataset items only: 1,000 x $0.0015 = $1.50 on Free, and 10,000 x $0.0015 = $15 on Free. Each run also pays the Actor Start event at $0.00005 on Free.

The Free plan includes $5 per month of platform usage credit. That covers about 3,333 dataset items on Free: $5 credit ÷ $0.0015 per item ≈ 3,333 items.

Compute, Apify Proxy traffic (including residential) and storage are paid by the Actor developer out of these event prices. The buyer is not charged separately for them.

How to use

1. Open the Chaves na Mão Property Listings Actor in Apify.
2. Set deal_type to sale, rent, or all (default sale).
3. Enter location as a city with its two-letter state code, a state code, or Brasil (default São Paulo, SP).
4. Set maxResults, the maximum number of records to save, from 1 to 1000 (default 50).
5. Configure proxyConfiguration if needed. With useApifyProxy: true the Actor creates an Apify proxy configuration; omit it or set useApifyProxy to false for a direct connection.
6. Run the Actor and inspect the dataset. Repeat through Apify Schedules if you want regular collection.

Example input:

{
  "deal_type": "sale",
  "location": "São Paulo, SP",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

Input parameters

Parameter	Values	Default
deal_type	sale, rent, all	sale
location	City with state code, state code, or Brasil	São Paulo, SP
maxResults	Integer from 1 to 1000	50
proxyConfiguration	Optional Apify proxy settings	Apify proxy in the schema; direct connection if omitted

Limits and edge cases

Condition	What the buyer sees	What to do
maxResults is above 1000	The Actor itself does not check the upper bound; only the Apify input form enforces the 1 to 1000 range.	Use an integer from 1 through 1000.
maxResults is 0 or less	The Actor logs that no records were requested and ends without saving records.	Set maxResults to a positive integer.
The first fetched page contains no listing cards	The run raises an error stating that the response contained no listing cards.	Check the location format and try the search again.
A page request fails	The request is attempted up to three times. If all attempts fail, the run raises a runtime error.	Check the location and proxy configuration, then retry the run.
A later page fails after earlier records were saved	Records pushed before the failure remain in the dataset, but the run does not continue to later records.	Review the partial dataset and retry if more results are needed.
The search has more than 100 result pages	The Actor stops after 100 pages to avoid an unbounded run.	Narrow the location or run a separate search if the requested inventory is larger.
The same listing ID appears more than once across result pages	The repeated listing is saved only once.	Use id as the listing identifier when deduplicating downstream data.

FAQ

How much does it cost to scrape Chaves na Mão property listings?

See the Pricing section above for event prices and worked examples.

What happens if the Actor returns an empty result?

If the first fetched page contains no listing cards, the run raises an error and recommends checking the location. Verify the city and state format, transaction type, and spelling, then run the search again.

What should I do if a run is not working?

A failed page request is retried up to three times. If the request still fails, check the location and proxy configuration and retry the run. If a later page fails, records already pushed before that point can remain available in the dataset.

Why are some fields missing from a listing?

The Actor extracts values visible on the search result card. Since card details vary, fields such as price, area, bathrooms, parking spaces, or the image URL are omitted when they are not shown.

Is scraping this public data legal or allowed?

The Actor collects public listing-card data from Chaves na Mão. Source terms and applicable law depend on the buyer’s use case, so review the relevant terms and legal requirements before using the data.