Zap Imóveis Cheerio Crawler

Overview

This Apify Actor efficiently scrapes real estate listing data from Zap Imóveis (zapimoveis.com.br), a major property portal in Brazil. It extracts detailed information about properties listed for sale (venda) or rent (aluguel) directly from search result pages.

The Actor uses Crawlee with the Cheerio scraper, making it faster and lighter than browser-based solutions, suitable for extracting data embedded in the initial HTML source (specifically the #__NEXT_DATA__ script).

Features

• Extracts comprehensive listing details (price, address, specs, description, images, advertiser info, etc.).
• Handles pagination automatically up to a specified limit per search location.
• Supports searching entire cities or specific neighborhoods.
• Configurable for 'Sale' (venda) or 'Rent' (aluguel) listings.
• Requires and integrates with Apify Proxies (Residential recommended).
• Outputs structured data (JSON object per listing) to the Apify Dataset.

How to Use

1. Input Configuration

Configure the Actor's behavior using the Input tab in the Apify Console (either via the UI form or by providing JSON).

Required Inputs:

• state (String): The 2-letter state abbreviation (lowercase). Default: rj
  • Example: sp, mg, rj
• city (String): The city name formatted for the Zap Imóveis URL. Default: rio-de-janeiro
  • Example: sao-paulo, belo-horizonte
• business (String): Transaction type. Default: venda
  • Options: venda (Sale), aluguel (Rent)
• searchType (String): Search scope. Default: neighborhood
  • city: Scrapes the entire specified city.
  • neighborhood: Scrapes only the listed neighborhoods.
• maxPagesPerLocation (Integer): Max number of pages to scrape per city or neighborhood search initiated. Default: 100

Conditional Input:

• neighborhoods (Array of Strings): List of neighborhood names. Required only if searchType is neighborhood.
  • Important: Format must match the URL. If Zap uses zone prefixes (like zona-sul), include them here.
  • Example (Rio): ["zona-sul+copacabana", "zona-sul+ipanema"]
  • Example (Other): ["pinheiros", "vila-madalena"]

Optional Input:

• maxRequestsPerCrawl (Integer): A global safety limit on the total number of pages fetched across all locations in the run. Default: 10000

Example JSON Inputs:

• Neighborhood Search (Sale in Ipanema, Rio):

  1{
  2  "state": "rj",
  3  "city": "rio-de-janeiro",
  4  "business": "venda",
  5  "searchType": "neighborhood",
  6  "neighborhoods": ["zona-sul+ipanema"],
  7  "maxPagesPerLocation": 5
  8}
  

• City Search (Rent in São Paulo):

  1{
  2  "state": "sp",
  3  "city": "sao-paulo",
  4  "business": "aluguel",
  5  "searchType": "city",
  6  "maxPagesPerLocation": 50
  7}
  

2. Proxy Configuration

Apify Proxies are required for this Actor to work reliably. Zap Imóveis frequently blocks non-residential IPs.

• Go to the Actor's Settings tab -> Proxy and security.
• Select Apify Proxy.
• Strongly Recommended: Choose a Residential proxy group (groups: ["RESIDENTIAL"] in JSON).
• Set the Proxy country to Brazil (BR).
• Using Datacenter proxies will likely result in blocks and failure.

3. Running the Actor & Getting Data

• Click the Start button.
• Once the run finishes successfully, go to the Dataset tab of the run.
• You can preview the data or download it in formats like JSON, CSV, Excel, etc.

Output Data

The Actor outputs data to the Apify Dataset. Each item is a JSON object representing a single scraped listing, containing fields like:

• id, externalId, href, business
• price_mainValue, price_condominium, price_iptu
• address_street, address_neighborhood, address_city, address_stateAcronym, address_lat, address_lon
• amenities_usableAreas, amenities_bedrooms, amenities_bathrooms, amenities_parkingSpaces
• imageList (Stringified JSON array)
• description
• advertiser_id, advertiser_name, advertiser_url
• scrapedAt, sourceUrl, pageNumber
• ... and many other fields extracted from the flattened data structure.

(Note: The availability of specific fields depends on the information present on the Zap Imóveis listing page).

Disclaimer

• this scrapper only use public avaiable data from zap imoveis
• Terms of Service: You are responsible for ensuring your use of this Actor complies with the Zap Imóveis terms of service and any relevant data privacy regulations. Use responsibly.