ChavesNaMão Property Scraper

Chaves na Mão Property Scraper

Extract public residential and commercial listings from Chaves na Mão with IDs, URLs, prices, areas, addresses, and available images and detail fields. It needs no Chaves na Mão login (you still run it on your Apify account) and stores at most 50 records by default.

• Extract listing records for property inventories or market research.
• Collect advertised prices, areas, addresses, cities, states, transaction types, and property types when present.
• Enrich results with room counts, areas, fees, IPTU, descriptions, and images.
• Fetch specific properties by full listing URL with listingUrls.

What you get

The Actor omits fields absent from a listing instead of adding empty values, so treat fields as optional. Search cards supply the basic fields; detail pages add the fields a card lacks when includeDetails is on or listingUrls is used.

Field	Type	What it contains	Availability
listingId	integer	Chaves na Mão listing identifier	Required for stored records
url	string	Listing URL on chavesnamao.com.br	Required for stored records
propertyTitle	string	Title shown on the search card or detail page	Required for stored records
transaction	string	SELL or RENT when specified by the URL or title	When present
property_type	string	Property type shown by the URL, card, or detail page	When present
price	number	Advertised price in Brazilian reais	When present
area_m2	number	Area in square metres from a card; on a detail page, the useful area, or the total area when no useful area is labelled	When present
area_useful	number	Labelled useful area in square metres	Detail page
area_total	number	Labelled total area in square metres	Detail page
bedrooms	integer	Bedroom count	When an exact count is available
suites	integer	Suite count, from the card or detail page	When labelled
bathrooms	integer	Bathroom count, from the card or detail page	When labelled
garages	integer	Garage or parking count, from the card or detail page	When labelled
address	string	Address text displayed on the card or detail page	When present
city	string	City parsed from the displayed address	When present
state	string	Brazilian state code parsed from the displayed address	When present
condo_fee	number	Condominium fee in Brazilian reais, from the card or detail page	When a numeric amount is shown
iptu	number	IPTU property tax in Brazilian reais, from the card or detail page	When a numeric amount is shown
description	string	Listing description from the detail page	Detail page
images	array of strings	Image URLs belonging to the listing	When images are available
thumbnail	string	First listing image URL	When an image is available

Sample output

The sample below is one record from a run with includeDetails set to false; images and thumbnail were omitted for brevity. Only area_useful, area_total and description come exclusively from detail pages, which also add room counts and fees when the card lacks them.

{
  "listingId": 44952122,
  "url": "https://www.chavesnamao.com.br/imovel/casa-a-venda-3-quartos-com-garagem-sp-sao-paulo-vila-albertina-1200m2-RS3700000/id-44952122/",
  "propertyTitle": "Casa com 3 quartos à venda na Rua Manuel de Arzão, Vila Albertina, São Paulo",
  "transaction": "SELL",
  "property_type": "Casa",
  "price": 3700000,
  "area_m2": 1200,
  "bedrooms": 3,
  "iptu": 1145,
  "address": "Vila Albertina, São Paulo/SP",
  "city": "São Paulo",
  "state": "SP"
}

Pricing

Apify charges the following events on the Free plan:

• apify-default-dataset-item: $0.008 per dataset item on the Free plan. One event represents one scraped result with all fields.
• apify-actor-start: $0.00005 per Actor Start event on the Free plan. This event is charged once per GB of run memory, with a minimum of one event.

On the Free plan, 1,000 dataset items cost $8.00 and 10,000 dataset items cost $80.00; the Actor Start event is charged in addition.

The $5 monthly credit on the Apify Free plan covers 1 full run of up to 624 dataset items ($4.99205 including one Actor Start event). That count needs enough search URLs, because each search URL yields only the cards on its one page. You pay only for the events listed above. This Actor does not use the Pay per event + usage option, so the platform usage of your runs (compute, proxy traffic and storage) is not billed to you separately.

How to use

1. Choose Chaves na Mão search-result URLs, or full listing URLs.
2. Enter search URLs in searchUrls for search-page collection. If listingUrls is supplied, the Actor fetches those listings instead of processing search pages.
3. Set maxResults to cap the total number of property records stored across the supplied URLs.
4. Enable includeDetails to enrich each search result from its detail page.
5. Optionally change proxyConfiguration; by default requests use Apify Proxy with the RESIDENTIAL group.
6. Run the Actor. Results land in the Apify dataset, which you can export as JSON or CSV. A maxResults of zero or less stores nothing.
7. Use Apify Schedules (daily is a good start) for repeated collection.

Example input:

{
  "searchUrls": [
    "https://www.chavesnamao.com.br/imoveis-a-venda/sp-sao-paulo/"
  ],
  "maxResults": 50,
  "includeDetails": true
}

Input parameters

Parameter	What it does	Default
searchUrls	Array of Chaves na Mão property-search URLs. Used when listingUrls is not supplied.	["https://www.chavesnamao.com.br/imoveis-a-venda/sp-sao-paulo/"]
listingUrls	Optional array of full Chaves na Mão listing URLs. When supplied, these are fetched instead of search pages.	Not set
maxResults	Maximum records stored across all URLs.	50
includeDetails	In search mode, fetches each listing detail page and adds available areas, room counts, taxes, description, and gallery images.	false
proxyConfiguration	Apify proxy settings.	Apify Proxy, RESIDENTIAL group

Limits and edge cases

Condition	What you see	What to do
Neither searchUrls nor listingUrls is supplied, or both are	With neither, the Actor uses the São Paulo search URL; with both, only listingUrls are processed	Supply your own URLs; use listingUrls for specific properties and searchUrls for searches
maxResults is reached	No more records are stored, including from later URLs	Raise maxResults only if the pages hold more cards; each search URL is fetched once with no pagination, so add more search URLs to get more records
A search URL has fewer cards than maxResults	Only the cards on that one page are stored	Supply more search URLs
The same listing ID appears more than once	Only the first occurrence is stored	Review your URLs
A URL is outside chavesnamao.com.br, is an unsupported listing path, or cannot be fetched	The URL is skipped with a warning; other URLs still run. If only a detail page fails under includeDetails, the search record is stored without detail fields	Check the URL and try again
A page has no recognized listing cards or listing record	No record is stored for that URL	Check that it is a search page or listing page with available listings

FAQ

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

See Pricing for per-item rates, examples and the monthly credit.

Why is my result empty?

No recognized listing cards, or a skipped URL. See Limits and edge cases.

What happens if the Actor is not working?

Fetch errors are logged as warnings and the URL is skipped.

Is scraping public Chaves na Mão data legal or allowed?

The Actor reads public, server-rendered pages. Source terms and applicable law depend on your use case; this is not a legal guarantee.

Related actors

• Portalinmobiliario Scraper — Chile Property Data & API — related property-listing data for Chile.
• Property24 Scraper | South Africa — related property-listing data for South Africa.
• At Home Japan Rental Listings — related rental-listing data for Japan.