ChavesNaMão Property Scraper

Collect public residential and commercial property listings from Chaves na Mão, a Brazilian property marketplace. Search-page records include the listing ID and URL, title, transaction type, property type, advertised price, area, address, city/state, and the listing image when those values are present. Optional detail fetching adds labelled useful and total areas, bedroom, suite, bathroom and garage counts, condominium fee, IPTU, description, and property gallery.

The Actor reads server-rendered listing pages and does not require an account. It omits fields that are not present on a listing instead of filling them with empty values. The maxResults setting caps the total number of records stored across the supplied URLs.

Input

• searchUrls: one or more Chaves na Mão search-result URLs. The prefilled example searches properties for sale in São Paulo.
• listingUrls: optional full listing URLs. If supplied, the Actor fetches those detail pages instead of search pages.
• maxResults: maximum records to store; defaults to 50.
• includeDetails: fetch each search result detail page and add the fields available there; defaults to false.
• proxyConfiguration: optional Apify proxy configuration. Requests go directly to the site when the proxy is disabled or omitted.

Example input:

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

Example output

This sample is taken from a public detail page:

{
  "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 / Sobrado",
  "price": 3700000,
  "area_m2": 1200,
  "area_useful": 1200,
  "area_total": 1200,
  "bedrooms": 3,
  "suites": 1,
  "bathrooms": 4,
  "garages": 12,
  "address": "Rua Manuel De Arzão, 300, Vila Albertina, São Paulo / SP",
  "city": "São Paulo",
  "state": "SP",
  "iptu": 1145
}

Price per result

Apify bills one dataset item for each property record the Actor stores. The current USD rate per result is the pay-per-result rate configured for this Actor in Apify Console; this code does not add a separate actor charge.