Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link: My profile

Introduction (English version)

Introduction

Brazil's real estate market represents one of the most dynamic property sectors in Latin America, and Imovelweb.com.br stands as a cornerstone platform in this landscape. Founded in 1999 and currently controlled by Navent, Imovelweb has established itself as one of Brazil's top five real estate websites, hosting over 1.5 million property listings across the country. For real estate professionals, investors, market analysts, and data researchers, accessing this vast repository of property information efficiently can be challenging without the right tools.

The Imovelweb Property Search Scraper addresses this critical need by providing automated data extraction capabilities that transform hours of manual browsing into minutes of structured data collection. Whether you're conducting market research, tracking property trends, analyzing pricing patterns, or building real estate applications, this scraper enables you to harness the full potential of Imovelweb's comprehensive database.

Comprehensive Scraper Overview

The Imovelweb Property Search Scraper is a sophisticated data extraction tool designed specifically for Brazil's leading real estate portal. This scraper efficiently navigates through property listing pages, extracting detailed information about apartments, houses, and commercial properties available for sale and rent across Brazilian markets.

Built with robust error handling and proxy support, the scraper ensures reliable data collection while respecting website limitations. The tool incorporates intelligent retry mechanisms and configurable limits to optimize performance while maintaining ethical scraping practices. Its architecture is designed to handle the dynamic nature of real estate listings, adapting to various property types and listing formats found on Imovelweb.

The scraper is particularly valuable for real estate professionals, market researchers, property investors, data analysts, and PropTech companies who need systematic access to Brazilian property market data. Its ability to process multiple URLs simultaneously and extract standardized data formats makes it an essential tool for anyone working with Brazilian real estate information at scale.

Input and Output Specifications

Example url 1: https://www.imovelweb.com.br/apartamentos-venda.html

Example url 2: https://www.imovelweb.com.br/apartamentos-venda-higienopolis-sao-paulo.html

Example url 3: https://www.imovelweb.com.br/apartamentos-venda-casa-branca-sp.html

Example Screenshot of property list by query page:

Input Format

The scraper accepts configuration through a JSON object with several key parameters:

Scrape with URLs:

{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each URL if the scrape is detected as a bot or the page fails to load.
  "proxy": { // Proxy configuration to avoid bot detection during the data collection process.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "BR" // You should choose a country that matches your target data location (Brazil for imovelweb.com.br)
  },
  "max_items_per_url": 20, // Limit the number of items per URL you want to scrape
  "urls": [ // List of property list page URLs that you want to scrape.
    "https://www.imovelweb.com.br/apartamentos-venda.html",
    "https://www.imovelweb.com.br/apartamentos-venda-higienopolis-sao-paulo.html",
    "https://www.imovelweb.com.br/apartamentos-venda-casa-branca-sp.html"
  ],
  "ignore_url_failures": true // If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached.
}

The urls parameter: Add the URLs of the property list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

The ignore_url_failures parameter: If set to true, the scraper will continue running even if some URLs fail to be scraped after reaching the maximum number of retries. This ensures that one problematic URL doesn't stop your entire scraping job.

When you provide a list of URLs for scraping, all options in the "Scrape with search filters" section will be disabled. The system will only collect data from the URLs you specified.

Scrape with Search Filters:

{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each search filter if the scrape is detected as a bot or the page fails to load.
  "proxy": { // Proxy configuration to avoid bot detection during the data collection process.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "BR" // Choose a country that matches your target data location (Brazil for imovelweb.com.br)
  },
  "max_items_per_url": 20, // Limit the number of items per search filters you want to scrape
  "keyword": "sao paulo", // Search keyword to find properties
  "property_type": "apartamentos", // Filter by property type
  "operation_type": "venda", // Filter by operation type (rent/buy/temporal rent/new/auction)
  "published_date": "na-ultima-semana", // Filter by published date
  "sort_by": "precio-menor", // Sort properties by specific criteria
  "page": 1 // Starting page number for search results
}

The keyword parameter: Enter the keyword to search for properties (e.g., "sao paulo", "rio de janeiro", "brasilia", "belo horizonte", "curitiba").

The property_type parameter: Filter properties by type:

• "apartamentos" - Apartamento (Apartment)
• "casas" - Casa (House)
• "terrenos" - Terreno (Land)
• "comerciais" - Comercial (Commercial)
• "rurais" - Rural (Rural)
• "condominios-de-casas" - Condomínio de casas (House condominium)
• "condominios-de-edificios" - Condomínio de edifícios (Building condominium)
• "edificios" - Edifício (Building)
• "lancamentos-comerciais" - Imóvel novo comercial (New commercial property)
• "lancamentos-horizontais" - Imóvel novo horizontal (New horizontal property)
• "lancamentos-horizontais-verticais" - Imóvel novo horizontal-vertical (New horizontal-vertical property)
• "lancamentos-na-praia" - Imóvel novo na praia (New beachfront property)
• "lancamentos-no-campo" - Imóvel novo no campo (New countryside property)
• "lancamentos-verticais" - Imóvel novo vertical (New vertical property)
• "lotes" - Lote (Lot)

The operation_type parameter: Filter properties by operation type:

• "aluguel" - Rent
• "venda" - Buy
• "alquiler-temporal" - Temporal Rent
• "lancamento" - New
• "leilao" - Auction

The published_date parameter: Filter properties by published date:

• "" (empty string) - Any
• "nos-ultimos-2-dias" - Lasts 2 days
• "no-ultimo-dia" - Lasts 1 day
• "na-ultima-semana" - Lasts 1 week
• "nos-ultimos-15-dias" - Lasts 15 days
• "no-ultimo-mes" - Lasts 1 month
• "nos-ultimos-45-dias" - Lasts 45 days

The sort_by parameter: Sort properties by various criteria:

• "" (empty string) - Relevance
• "precio-menor" - Price (low to high)
• "publicado-maior" - Date (newest first)
• "precio-maior" - Price (high to low)
• "visitas-maior" - Views (high to low)
• "variacionporcentual-maior" - Variation (high to low)

The page parameter: Specify the page number to start scraping from, useful for continuing interrupted scrapes or targeting specific result ranges.

When using search filters for scraping, you need to leave the urls field empty (or set it to null) in the "Scrape with URLs" configuration.

General Options:

The max_items_per_url parameter: Limits the number of properties extracted from each property list page or search results page. The default value is 20, providing a manageable batch size while allowing for comprehensive data collection.

The max_retries_per_url parameter: Sets the maximum number of retry attempts for each URL or search filters if the scrape is detected as a bot or the page fails to load. The default value is 2, providing a good balance between thoroughness and efficiency.

The proxy parameter: Proxy configuration is essential for maintaining anonymity and avoiding detection. The residential proxy option ensures that your scraping activities appear as legitimate browsing, reducing the risk of being blocked or rate-limited. You should choose a country that matches the location of the website you're scraping (e.g., Brazil/BR for imovelweb.com.br).

Output Format and Data Fields

You get the output from the Imovelweb Property Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

[ // List of property information
  {
    "posting_id": "2998979014",
    "url": "/propriedades/vila-mariana-apartamento-a-venda-37m-com-vaga-de-2998979014.html",
    "posting_code": "43CD8R4",
    "title": "Vila Mariana - Apartamento À Venda, 37m² Com Vaga De Garagem ",
    "price_operation_types": [
      {
        "low_price_percentage": null,
        "operation_type": {
          "name": "Venda",
          "operation_type_id": "1"
        },
        "prices": [
          {
            "currency_id": "3",
            "amount": 599000,
            "formatted_amount": "599.000",
            "currency": "R$"
          }
        ]
      }
    ],
    "expenses": {
      "currency_id": null,
      "amount": 500,
      "formatted_amount": "500",
      "currency": "R$"
    },
    "main_features": {
      "c_f_t100": {
        "feature_id": "CFT100",
        "label": "Área total",
        "measure": "m²",
        "value": "37",
        "icon": null,
        "feature_category_id": "CFC2"
      },
      "c_f_t101": {
        "feature_id": "CFT101",
        "label": "Área útil",
        "measure": "m²",
        "value": "37",
        "icon": null,
        "feature_category_id": "CFC2"
      },
      "c_f_t2": {
        "feature_id": "CFT2",
        "label": "Quarto",
        "measure": null,
        "value": "1",
        "icon": null,
        "feature_category_id": "CFC1"
      },
      "c_f_t7": {
        "feature_id": "CFT7",
        "label": "Vaga",
        "measure": null,
        "value": "1",
        "icon": null,
        "feature_category_id": "CFC1"
      },
      "c_f_t4": {
        "feature_id": "CFT4",
        "label": "Suíte",
        "measure": null,
        "value": "1",
        "icon": null,
        "feature_category_id": "CFC1"
      }
    },
    "general_features": {},
    "development_features": {},
    "highlighted_features": [],
    "flags_features": [],
    "antiquity": null,
    "publisher": {
      "publisher_id": "47288778",
      "name": "Glauco Atafin",
      "url": "/imobiliarias/glauco-atafin_47288778-imoveis.html",
      "slot_filter_url": null,
      "url_logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/28/87/78/130x70/logo_glauco-atafin_1731970411423.jpg",
      "publisher_type_id": "2",
      "url_chat": null,
      "license": "180.682",
      "publisher_tags": [],
      "parent_publisher": null,
      "amount_posting_active": null,
      "partial_phone": null,
      "created_year": null,
      "premier": true,
      "slug": "",
      "publisher_statistics": null,
      "approved": false,
      "main_phone": null,
      "created_date": 1561435200000,
      "id_portal": "101",
      "quantity_posting_by_operation_type": null
    },
    "url_logo": null,
    "real_estate_type": {
      "name": "Apartamentos",
      "real_estate_type_id": "2"
    },
    "units": [],
    "publication": null,
    "premier": true,
    "slot": null,
    "slot_color": null,
    "house_info": null,
    "description_normalized": "O Essence Vila Mariana é um condomínio de localização privilegiada que oferece o essencial para simplificar o seu dia a dia. Sua torre única de 22 andares possui diferenciais como lavanderia, ar-condicionado entregue em todas as áreas comuns, fitness externo com pista de cooper, ponto de recarga para carro elétrico, bicicletário e mais. A área de lazer é entregue totalmente equipada e decorada, com espaços de convívio integrados que facilitam os momentos de descanso do morador, incluindo piscinas, salão de festas, churrasqueiras com forno de pizza, uma praça arborizada e brinquedoteca. O Essence Vila Mariana possui apartamentos studios com metragem de 37 m², além de 61 m² a 66 m², todas as tipologias com direito a uma vaga de garagem. As unidades possuem ponto para filtro de água de geladeira, água quente nos metais da cozinha e banheiros, piso nivelado entre a sala e terraço, persiana de enrolar nos dormitórios e previsão para ar-condicionado. Residências equipadas que oferecem para a sua família toda a essência de viver bem! Fico a disposição para mais informações e também para agendarmos uma visita; Corretor Atafin - 11. <span class='descripcionDatosAnunciante'><button class='btn btn-link js-verDatos' href='#'>Ver dados</button></span> - WhatsApp. . Creci 180. 682. ",
    "posting_location": {
      "address": {
        "name": "Rua Paula Ney, 494",
        "visibility": "EXACT"
      },
      "location": {
        "location_id": "V1-D-526858",
        "name": "Vila Mariana",
        "label": "ZONA",
        "depth": 3,
        "parent": {
          "location_id": "V1-C-109668",
          "name": "São Paulo",
          "label": "CIUDAD",
          "depth": 2,
          "parent": {
            "location_id": "V1-B-265",
            "name": "São Paulo",
            "label": "PROVINCIA",
            "depth": 1,
            "parent": {
              "location_id": "V1-A-2",
              "name": "Brasil",
              "label": "PAIS",
              "depth": 0,
              "parent": null,
              "acronym": null
            },
            "acronym": "SP"
          },
          "acronym": null
        },
        "acronym": null
      },
      "posting_geolocation": {
        "geolocation": {
          "latitude": -23.5797142,
          "longitude": -46.634647
        },
        "url_static_map": "//maps.google.com/maps/api/staticmap?center=-23.579714200000001511625669081695377826690673828125,-46.634647000000001071384758688509464263916015625&zoom=16&key=AIzaSyB_oTDQAy22B6JrYEfHrUvNcrzA2RjTAeU&size=780x456&sensor=true&scale=2&signature=vF0D-jPnK7s1lEorChN5welSjBQ=&channel=rplis-iw",
        "visibility": null
      }
    },
    "visible_pictures": {
      "pictures": [
        {
          "multimedia_type_id": "2",
          "order": 1,
          "height": 576,
          "width": 1024,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053466.jpg?isFirstImage=true",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053466.jpg?isFirstImage=true",
          "url130x70": null,
          "title": "Apartamento de 1 quarto, São Paulo · Vila Mariana - Apartamento À Venda, 37m² Com Vaga De Garagem "
        },
        {
          "multimedia_type_id": "2",
          "order": 2,
          "height": 1447,
          "width": 955,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053475.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053475.jpg",
          "url130x70": null,
          "title": "Apartamento en Venda de 1 quarto Vila Mariana"
        },
        {
          "multimedia_type_id": "2",
          "order": 3,
          "height": 682,
          "width": 1024,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053467.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053467.jpg",
          "url130x70": null,
          "title": "O Essence Vila Mariana é um condomínio de localização privilegiada que oferece o"
        },
        {
          "multimedia_type_id": "2",
          "order": 4,
          "height": 899,
          "width": 1024,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053472.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053472.jpg",
          "url130x70": null,
          "title": "Apartamento Venda 37m² de 1 quarto"
        },
        {
          "multimedia_type_id": "2",
          "order": 5,
          "height": 768,
          "width": 1024,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053464.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053464.jpg",
          "url130x70": null,
          "title": "Apartamento 37m² Venda Vila Mariana"
        },
        {
          "multimedia_type_id": "2",
          "order": 6,
          "height": 640,
          "width": 960,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053474.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053474.jpg",
          "url130x70": null,
          "title": "Apartamento 37m² Venda Vila Mariana"
        },
        {
          "multimedia_type_id": "2",
          "order": 7,
          "height": 640,
          "width": 853,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053463.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053463.jpg",
          "url130x70": null,
          "title": "Apartamento de 1 quarto Venda R$ 599.000"
        },
        {
          "multimedia_type_id": "2",
          "order": 8,
          "height": 405,
          "width": 1024,
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/720x532/4470053470.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/98/97/90/14/360x266/4470053470.jpg",
          "url130x70": null,
          "title": "Apartamento · 37m² · 1 Quarto · 1 Vaga - Glauco Atafin"
        }
      ],
      "additional_pictures_count": 8
    },
    "status": "ONLINE",
    "posting_type": "PROPERTY",
    "whatsapp": "55 11910713445",
    "modified_date": "2025-06-12T23:19:40-0400",
    "from_url": "https://www.imovelweb.com.br/apartamentos-venda.html"
  }, // ... Many other property details
]

The scraper returns comprehensive property data in a structured format, with each field serving specific analytical and business purposes:

Identification Fields:

• Posting ID: Unique internal identifier for each property listing, essential for database management and avoiding duplicates
• URL: Direct link to the individual property page, crucial for verification and additional manual review
• Posting Code: Imovelweb's internal reference code, useful for cross-referencing with the platform's own systems

Property Details:

• Title: Property headline as displayed on the platform, providing quick property overview
• Price Operation Types: Specifies whether the property is for sale, rent, or both, critical for market segmentation
• Expenses: Additional costs beyond the base price (condominium fees, taxes), essential for total cost analysis

Property Features:

• Main Features: Core property characteristics like number of bedrooms, bathrooms, and square footage
• General Features: Additional amenities such as parking, balcony, or furnished status
• Development Features: Building-specific amenities like pool, gym, or security systems
• Highlighted Features: Premium amenities or unique selling points emphasized by the seller
• Flags Features: Special markers like "new construction," "price reduced," or "urgent sale"

Property Information:

• Antiquity: Age of the property, important for valuation and maintenance considerations
• Real Estate Type: Specific property category (apartment, house, commercial), crucial for market analysis
• Units: Number of available units (relevant for multi-unit developments)
• House Info: Detailed structural information specific to house-type properties

Business Data:

• Publisher: Information about the listing agent or agency, valuable for lead generation
• URL Logo: Agency or developer logo URL, useful for brand recognition and verification
• Publication: Original publication date of the listing
• Premier: Premium listing status, indicating paid promotional placement
• Slot and Slot Color: Display position and visual treatment information

Content and Media:

• Description Normalized: Standardized property description text, ideal for natural language processing
• Visible Pictures: Count or URLs of property images, important for listing quality assessment
• Posting Location: Detailed address and neighborhood information, critical for location-based analysis

Contact and Status:

• Whatsapp: WhatsApp contact information for direct communication
• Status: Current listing status (active, sold, rented)
• Posting Type: Classification of listing type within Imovelweb's system
• Modified Date: Last update timestamp, useful for tracking listing freshness and market velocity

This comprehensive data structure enables various applications from market analysis and price prediction to lead generation and competitive intelligence.

Step-by-Step Usage Guide

Getting started with the Imovelweb Property Search Scraper requires careful preparation and configuration for optimal results.

Step 1: Choose Your Scraping Approach

Option A - URL Preparation: Begin by identifying the specific Imovelweb search pages you want to scrape. Navigate to Imovelweb.com.br and use their search and filtering features to narrow down properties by location, price range, property type, or other criteria. Copy the complete URLs of these filtered search result pages. For best results, focus on search pages rather than individual property pages.

Option B - Use Search Filters: Define your search criteria using the built-in filters:

• Set keyword for specific locations or property characteristics (e.g., "São Paulo", "Rio de Janeiro", "Belo Horizonte")
• Select property_type to filter by property category (apartamentos, casas, terrenos, comerciais, etc.)
• Choose operation_type to filter by transaction type (aluguel, venda, lançamento, leilão, aluguel temporal)
• Set published_date to filter by listing recency (2 dias, 1 semana, 1 mês, etc.)
• Select sort_by to organize results (preço, data, visitas, variação)
• Set page to start from a specific results page

Step 2: Configuration Setup Configure your JSON input with appropriate settings. Set max_retries_per_url to 2-3 for reliable data collection. Enable proxy settings and choose Brazil (BR) as proxy country for optimal access. Set max_items_per_url based on your needs – lower numbers (10-20) for quick sampling, higher numbers (50-100) for comprehensive data collection. Enable ignore_url_failures for robust scraping.

Step 3: Execution and Monitoring Launch the scraper and monitor its progress. The tool will systematically process each URL or search filter, extracting property data while respecting rate limits and retry configurations. Watch for any error messages or unusual patterns that might indicate blocked requests or changed website structure.

Best Practices:

Method Selection:

• Use URL-based scraping for specific filtered searches or complex category combinations
• Use filter-based scraping for keyword searches with standard filtering options
• Combine both approaches: use filters for property discovery, then URLs for targeted extraction

Scraping Strategy:

• Use Brazilian (BR) residential proxies when possible for better success rates
• Avoid scraping during peak Brazilian hours (business hours BRT) to reduce server load
• Start with smaller batches to test configuration before large-scale extraction
• Regularly verify that scraped data matches current website content
• Implement data validation checks to ensure quality and completeness

Filter Optimization:

Property Type Strategy:

• Use property_type to target specific categories:
  • "apartamentos" for apartments
  • "casas" for houses
  • "terrenos" for land
  • "comerciais" for commercial properties
  • "lancamentos-" options for new developments

Operation Type Strategy:

• Use "aluguel" for rental properties
• Use "venda" for properties for sale
• Use "lancamento" for new launches/pre-construction
• Use "leilao" for auction properties
• Use "alquiler-temporal" for temporary/vacation rentals

Date Filtering Strategy:

• Use "no-ultimo-dia" for properties listed in last 24 hours
• Use "na-ultima-semana" for weekly monitoring
• Use "no-ultimo-mes" for monthly market analysis
• Leave empty for all listings regardless of date

Sorting Strategy:

• Use "precio-menor" (price low to high) for budget property research
• Use "precio-maior" (price high to low) for premium property analysis
• Use "publicado-maior" (newest first) for latest listings
• Use "visitas-maior" (views high to low) for popular properties
• Use "variacionporcentual-maior" (variation high to low) for price change analysis

Advanced Filter Combinations:

• Budget apartments: keyword: "São Paulo", property_type: "apartamentos", operation_type: "venda", sort_by: "precio-menor"
• New listings: keyword: "Rio de Janeiro", property_type: "casas", operation_type: "venda", published_date: "na-ultima-semana", sort_by: "publicado-maior"
• Investment properties: keyword: "Belo Horizonte", property_type: "comerciais", operation_type: "venda", sort_by: "precio-menor"
• Luxury properties: keyword: "São Paulo", property_type: "apartamentos", sort_by: "precio-maior"

Error Handling:

Common issues include rate limiting, proxy failures, and page structure changes. The scraper's retry mechanism addresses temporary failures, but persistent issues may require configuration adjustments or different proxy settings.

Rate Limiting:

• Reduce max_items_per_url to lower request frequency
• Increase delays between batch runs
• Enable ignore_url_failures to continue despite some failures

Proxy Failures:

• Ensure using Brazilian (BR) residential proxies
• Rotate proxy settings if one location is blocked
• Increase max_retries_per_url to 3-5 for better reliability

Empty Results:

• For filter-based: Verify keyword is in Portuguese
• Try broader property_type or operation_type selections
• Check if property category exists in the specified location
• Test with different published_date ranges

Configuration Issues:

• Verify property_type codes match enum values
• Ensure operation_type values are correct
• Check published_date and sort_by format

Monitor success rates and adjust parameters accordingly. Track extraction quality and implement data validation to ensure completeness.

Business Benefits and Applications

The Imovelweb Property Search Scraper delivers significant time savings and business value across multiple real estate applications. Manual data collection from Imovelweb would require hundreds of hours for comprehensive market analysis, while the scraper completes the same task in minutes.

Market Research and Analysis: Real estate professionals can track pricing trends, identify emerging markets, and analyze property feature preferences across different Brazilian regions. The structured data enables sophisticated analytics and market intelligence that would be impossible to gather manually.

Investment Decision Support: Property investors can monitor market conditions, identify undervalued properties, and analyze rental yields across different areas. The scraper's ability to collect historical data through repeated runs enables trend analysis and investment timing optimization.

Competitive Intelligence: Real estate agencies can monitor competitor listings, pricing strategies, and market positioning. This intelligence helps optimize their own listings and identify market opportunities.

PropTech Applications: Technology companies building real estate platforms can use the scraped data to populate property databases, train machine learning models, or provide market insights to their users. The standardized data format facilitates integration with existing systems and applications.

Conclusion

The Imovelweb Property Search Scraper represents an essential tool for anyone working with Brazilian real estate data. By automating the extraction of comprehensive property information from one of Brazil's leading real estate platforms, it enables data-driven decision making and sophisticated market analysis that would otherwise require extensive manual effort.

Whether you're a real estate professional seeking market insights, an investor analyzing opportunities, or a technology company building PropTech solutions, this scraper provides the foundation for accessing Brazil's dynamic property market data efficiently and systematically.

Ready to transform your real estate data collection process? Start leveraging the power of automated property data extraction from Imovelweb today.

Introdução (versão brasileira)

Introdução

O mercado imobiliário brasileiro representa um dos setores de propriedades mais dinâmicos da América Latina, e o Imovelweb.com.br se destaca como uma plataforma fundamental nesse cenário. Fundado em 1999 e atualmente controlado pela Navent, o Imovelweb consolidou-se como um dos cinco principais sites imobiliários do Brasil, hospedando mais de 1,5 milhão de anúncios de imóveis em todo o país. Para profissionais do setor imobiliário, investidores, analistas de mercado e pesquisadores de dados, acessar esse vasto repositório de informações de imóveis de forma eficiente pode ser um desafio sem as ferramentas adequadas.

O Scraper de Busca de Imóveis do Imovelweb atende a essa necessidade crítica ao fornecer capacidades de extração automatizada de dados, transformando horas de navegação manual em minutos de coleta estruturada de informações. Seja para realizar pesquisas de mercado, acompanhar tendências imobiliárias, analisar padrões de preços ou desenvolver aplicações para o setor, este scraper permite explorar todo o potencial do banco de dados abrangente do Imovelweb.

Visão Geral Abrangente do Scraper

O Scraper de Busca de Imóveis do Imovelweb é uma ferramenta de extração de dados sofisticada, projetada especificamente para o principal portal imobiliário do Brasil. Este scraper navega de forma eficiente pelas páginas de anúncios de imóveis, extraindo informações detalhadas sobre apartamentos, casas e propriedades comerciais disponíveis para venda e locação nos mercados brasileiros.

Construído com tratativa robusta de erros e suporte a proxy, o scraper garante uma coleta de dados confiável, respeitando as limitações do site. A ferramenta incorpora mecanismos inteligentes de repetição e limites configuráveis para otimizar o desempenho enquanto mantém práticas de scraping éticas. Sua arquitetura foi pensada para lidar com a natureza dinâmica dos anúncios imobiliários, adaptando-se a diferentes tipos e formatos de propriedades encontrados no Imovelweb.

O scraper é especialmente valioso para profissionais do ramo, pesquisadores de mercado, investidores, analistas de dados e empresas de PropTech que necessitam de acesso sistemático aos dados do mercado imobiliário brasileiro. Sua capacidade de processar múltiplas URLs simultaneamente e extrair informações em formatos padronizados torna-o uma ferramenta essencial para quem trabalha com informações imobiliárias em larga escala.

Especificações de Entrada e Saída

Exemplo de url 1: https://www.imovelweb.com.br/apartamentos-venda.html

Exemplo de url 2: https://www.imovelweb.com.br/apartamentos-venda-higienopolis-sao-paulo.html

Exemplo de url 3: https://www.imovelweb.com.br/apartamentos-venda-casa-branca-sp.html

Exemplo de captura de tela da lista de imóveis por página de consulta:

Formato de Entrada

O extrator aceita configuração através de um objeto JSON com vários parâmetros principais:

Extrair com URLs:

{
  "max_retries_per_url": 2, // Número máximo de tentativas de reintento para cada URL se a extração for detectada como bot ou a página falhar ao carregar.
  "proxy": { // Configuração de proxy para evitar a detecção de bots durante o processo de coleta de dados.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "BR" // Você deve escolher um país que corresponda à localização dos seus dados alvo (Brasil para imovelweb.com.br)
  },
  "max_items_per_url": 20, // Limitar a quantidade de itens por URL que você quer extrair
  "urls": [ // Lista de URLs de páginas de listagem de imóveis que você quer extrair.
    "https://www.imovelweb.com.br/apartamentos-venda.html",
    "https://www.imovelweb.com.br/apartamentos-venda-higienopolis-sao-paulo.html",
    "https://www.imovelweb.com.br/apartamentos-venda-casa-branca-sp.html"
  ],
  "ignore_url_failures": true // Se verdadeiro, o extrator continuará executando mesmo se algumas URLs falharem ao serem extraídas após atingir o número máximo de reintentos.
}

O parâmetro urls: Adicione as URLs das páginas de listagem de imóveis que você quer extrair. Você pode colar URLs uma por uma, ou usar a seção de Edição em massa para adicionar uma lista preparada.

O parâmetro ignore_url_failures: Se definido como true, o extrator continuará executando mesmo se algumas URLs falharem ao serem extraídas após atingir o número máximo de reintentos. Isso garante que uma URL problemática não pare todo o seu trabalho de extração.

Quando você fornece uma lista de URLs para extração, todas as opções na seção "Extrair com filtros de busca" serão desabilitadas. O sistema coletará apenas dados das URLs que você especificou.

Extrair com Filtros de Busca:

{
  "max_retries_per_url": 2, // Número máximo de tentativas de reintento para cada filtro de busca se a extração for detectada como bot ou a página falhar ao carregar.
  "proxy": { // Configuração de proxy para evitar a detecção de bots durante o processo de coleta de dados.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "BR" // Escolha um país que corresponda à localização dos seus dados alvo (Brasil para imovelweb.com.br)
  },
  "max_items_per_url": 20, // Limitar a quantidade de itens por filtros de busca que você quer extrair
  "keyword": "sao paulo", // Palavra-chave de busca para encontrar imóveis
  "property_type": "apartamentos", // Filtrar por tipo de imóvel
  "operation_type": "venda", // Filtrar por tipo de operação (aluguel/venda/aluguel temporário/lançamento/leilão)
  "published_date": "na-ultima-semana", // Filtrar por data de publicação
  "sort_by": "precio-menor", // Ordenar imóveis por critérios específicos
  "page": 1 // Número da página inicial para resultados de busca
}

O parâmetro keyword: Digite a palavra-chave para buscar imóveis (por exemplo, "sao paulo", "rio de janeiro", "brasilia", "belo horizonte", "curitiba").

O parâmetro property_type: Filtre imóveis por tipo:

• "apartamentos" - Apartamento
• "casas" - Casa
• "terrenos" - Terreno
• "comerciais" - Comercial
• "rurais" - Rural
• "condominios-de-casas" - Condomínio de casas
• "condominios-de-edificios" - Condomínio de edifícios
• "edificios" - Edifício
• "lancamentos-comerciais" - Imóvel novo comercial
• "lancamentos-horizontais" - Imóvel novo horizontal
• "lancamentos-horizontais-verticais" - Imóvel novo horizontal-vertical
• "lancamentos-na-praia" - Imóvel novo na praia
• "lancamentos-no-campo" - Imóvel novo no campo
• "lancamentos-verticais" - Imóvel novo vertical
• "lotes" - Lote

O parâmetro operation_type: Filtre imóveis por tipo de operação:

• "aluguel" - Aluguel
• "venda" - Venda
• "alquiler-temporal" - Aluguel Temporário
• "lancamento" - Lançamento
• "leilao" - Leilão

O parâmetro published_date: Filtre imóveis por data de publicação:

• "" (string vazia) - Qualquer
• "nos-ultimos-2-dias" - Últimos 2 dias
• "no-ultimo-dia" - Último 1 dia
• "na-ultima-semana" - Última 1 semana
• "nos-ultimos-15-dias" - Últimos 15 dias
• "no-ultimo-mes" - Último 1 mês
• "nos-ultimos-45-dias" - Últimos 45 dias

O parâmetro sort_by: Ordene imóveis por vários critérios:

• "" (string vazia) - Relevância
• "precio-menor" - Preço (do menor para o maior)
• "publicado-maior" - Data (mais recentes primeiro)
• "precio-maior" - Preço (do maior para o menor)
• "visitas-maior" - Visitas (do maior para o menor)
• "variacionporcentual-maior" - Variação (do maior para o menor)

O parâmetro page: Especifique o número da página de onde começar a extração, útil para continuar extrações interrompidas ou segmentar intervalos de resultados específicos.

Ao usar filtros de busca para extração, você precisa deixar o campo urls vazio (ou defini-lo como null) na configuração "Extrair com URLs".

Opções Gerais:

O parâmetro max_items_per_url: Limita o número de imóveis extraídos de cada página de listagem de imóveis ou página de resultados de busca. O valor padrão é 20, fornecendo um tamanho de lote gerenciável enquanto permite coleta de dados abrangente.

O parâmetro max_retries_per_url: Define o número máximo de tentativas de reintento para cada URL ou filtros de busca se a extração for detectada como bot ou a página falhar ao carregar. O valor padrão é 2, fornecendo um bom equilíbrio entre minuciosidade e eficiência.

O parâmetro proxy: A configuração de proxy é essencial para manter o anonimato e evitar detecção. A opção de proxy residencial garante que suas atividades de extração apareçam como navegação legítima, reduzindo o risco de ser bloqueado ou ter a taxa limitada. Você deve escolher um país que corresponda à localização do site que está extraindo (por exemplo, Brasil/BR para imovelweb.com.br).

O scraper retorna dados imobiliários abrangentes em formato estruturado, com cada campo servindo a propósitos analíticos e de negócios específicos:

Campos de Identificação:

• ID do Anúncio: Identificador interno único para cada anúncio de imóvel, essencial para gerenciamento de banco de dados e evitar duplicidades
• URL: Link direto para a página individual do imóvel, crucial para verificação e revisão manual adicional
• Código do Anúncio: Código de referência interno do Imovelweb, útil para cruzamento com os sistemas próprios da plataforma

Detalhes do Imóvel:

• Título: Cabeçalho do imóvel exibido na plataforma, oferecendo uma visão rápida do imóvel
• Tipos de Operação de Preço: Especifica se o imóvel está à venda, para locação ou ambos, fundamental para segmentação de mercado
• Despesas: Custos adicionais além do preço base (condomínio, impostos), essenciais para análise do custo total

Características do Imóvel:

• Características Principais: Características principais como número de quartos, banheiros e metragem
• Características Gerais: Amenidades adicionais como vaga de garagem, varanda ou imóvel mobiliado
• Características do Condomínio: Facilidades do prédio, como piscina, academia ou sistemas de segurança
• Características em Destaque: Amenidades premium ou diferenciais destacados pelo anunciante
• Características de Selo: Marcadores especiais como "lançamento", "preço reduzido" ou "venda urgente"

Informações do Imóvel:

• Antiguidade: Idade do imóvel, importante para avaliação e manutenção
• Tipo de Imóvel: Categoria específica do imóvel (apartamento, casa, comercial), crucial para análise de mercado
• Unidades: Número de unidades disponíveis (relevante para empreendimentos multiunidades)
• Informações da Casa: Detalhamento estrutural específico para imóveis do tipo casa

Dados Comerciais:

• Publicador: Informações sobre o corretor ou imobiliária anunciante, valioso para geração de leads
• URL do Logo: URL do logo da imobiliária ou construtora, útil para reconhecimento de marca e verificação
• Data de Publicação: Data original de publicação do anúncio
• Premier: Status de anúncio premium, indicando destaque pago
• Slot e Cor do Slot: Informação sobre a posição de exibição e destaque visual

Conteúdo e Mídia:

• Descrição Normalizada: Texto padronizado da descrição do imóvel, ideal para processamento de linguagem natural
• Fotos Visíveis: Contagem ou URLs das imagens do imóvel, importante para avaliação da qualidade do anúncio
• Localização do Imóvel: Endereço detalhado e informações de bairro, crítico para análise por localização

Contato e Status:

• Whatsapp: Contato via WhatsApp para comunicação direta
• Status: Situação atual do anúncio (ativo, vendido, alugado)
• Tipo de Anúncio: Classificação do tipo de anúncio dentro do sistema do Imovelweb
• Data de Modificação: Data/hora da última atualização, útil para acompanhamento da atualidade e velocidade do mercado

Essa estrutura de dados abrangente viabiliza aplicações desde análise de mercado e previsão de preços até geração de leads e inteligência competitiva.

Guia Passo a Passo

Começar com o Imovelweb Property Search Scraper requer preparação e configuração cuidadosas para resultados ideais.

Passo 1: Escolha Sua Abordagem de Scraping

Opção A - Preparação de URLs: Comece identificando as páginas de busca específicas do Imovelweb que você deseja extrair. Navegue até Imovelweb.com.br e use os recursos de busca e filtragem para restringir imóveis por localização, faixa de preço, tipo de imóvel ou outros critérios. Copie as URLs completas dessas páginas de resultados de busca filtradas. Para melhores resultados, concentre-se em páginas de busca em vez de páginas individuais de imóveis.

Opção B - Use Filtros de Busca: Defina seus critérios de busca usando os filtros integrados:

• Defina keyword para localizações específicas ou características de imóveis (ex., "São Paulo", "Rio de Janeiro", "Belo Horizonte")
• Selecione property_type para filtrar por categoria de imóvel (apartamentos, casas, terrenos, comerciais, etc.)
• Escolha operation_type para filtrar por tipo de transação (aluguel, venda, lançamento, leilão, aluguel temporal)
• Defina published_date para filtrar por recência do anúncio (2 dias, 1 semana, 1 mês, etc.)
• Selecione sort_by para organizar resultados (preço, data, visitas, variação)
• Defina page para começar de uma página de resultados específica

Passo 2: Configuração Configure sua entrada JSON com as configurações apropriadas. Defina max_retries_per_url para 2-3 para coleta de dados confiável. Ative as configurações de proxy e escolha Brasil (BR) como país do proxy para acesso ideal. Defina max_items_per_url com base em suas necessidades – números menores (10-20) para amostragem rápida, números maiores (50-100) para coleta de dados abrangente. Ative ignore_url_failures para scraping robusto.

Passo 3: Execução e Monitoramento Inicie o scraper e monitore seu progresso. A ferramenta processará sistematicamente cada URL ou filtro de busca, extraindo dados de imóveis respeitando limites de taxa e configurações de reintento. Fique atento a mensagens de erro ou padrões incomuns que possam indicar solicitações bloqueadas ou mudanças na estrutura do site.

Melhores Práticas:

Seleção de Método:

• Use scraping baseado em URLs para buscas filtradas específicas ou combinações de categorias complexas
• Use scraping baseado em filtros para buscas por palavra-chave com opções de filtragem padrão
• Combine ambas as abordagens: use filtros para descoberta de imóveis, depois URLs para extração direcionada

Estratégia de Scraping:

• Use proxies residenciais brasileiros (BR) quando possível para melhores taxas de sucesso
• Evite scraping durante horários de pico brasileiro (horário comercial BRT) para reduzir carga no servidor
• Comece com lotes menores para testar a configuração antes da extração em grande escala
• Verifique regularmente se os dados extraídos correspondem ao conteúdo atual do site
• Implemente verificações de validação de dados para garantir qualidade e completude

Otimização de Filtros:

Estratégia de Tipo de Imóvel:

• Use property_type para segmentar categorias específicas:
  • "apartamentos" para apartamentos
  • "casas" para casas
  • "terrenos" para terrenos
  • "comerciais" para imóveis comerciais
  • Opções "lancamentos-" para novos empreendimentos

Estratégia de Tipo de Operação:

• Use "aluguel" para imóveis para alugar
• Use "venda" para imóveis à venda
• Use "lancamento" para lançamentos/pré-construção
• Use "leilao" para imóveis em leilão
• Use "alquiler-temporal" para aluguéis temporários/temporada

Estratégia de Filtragem por Data:

• Use "no-ultimo-dia" para imóveis listados nas últimas 24 horas
• Use "na-ultima-semana" para monitoramento semanal
• Use "no-ultimo-mes" para análise de mercado mensal
• Deixe vazio para todos os anúncios independente da data

Estratégia de Ordenação:

• Use "precio-menor" (preço menor para maior) para pesquisa de imóveis econômicos
• Use "precio-maior" (preço maior para menor) para análise de imóveis premium
• Use "publicado-maior" (mais recentes primeiro) para anúncios mais recentes
• Use "visitas-maior" (visitas de maior para menor) para imóveis populares
• Use "variacionporcentual-maior" (variação de maior para menor) para análise de mudança de preço

Combinações Avançadas de Filtros:

• Apartamentos econômicos: keyword: "São Paulo", property_type: "apartamentos", operation_type: "venda", sort_by: "precio-menor"
• Novos anúncios: keyword: "Rio de Janeiro", property_type: "casas", operation_type: "venda", published_date: "na-ultima-semana", sort_by: "publicado-maior"
• Imóveis para investimento: keyword: "Belo Horizonte", property_type: "comerciais", operation_type: "venda", sort_by: "precio-menor"
• Imóveis de luxo: keyword: "São Paulo", property_type: "apartamentos", sort_by: "precio-maior"

Tratamento de Erros:

Problemas comuns incluem limitação de taxa, falhas de proxy e mudanças na estrutura da página. O mecanismo de reintento do scraper aborda falhas temporárias, mas problemas persistentes podem exigir ajustes de configuração ou configurações de proxy diferentes.

Limitação de Taxa:

• Reduza max_items_per_url para diminuir a frequência de solicitações
• Aumente os atrasos entre execuções de lote
• Ative ignore_url_failures para continuar apesar de algumas falhas

Falhas de Proxy:

• Certifique-se de usar proxies residenciais brasileiros (BR)
• Rotacione as configurações de proxy se uma localização estiver bloqueada
• Aumente max_retries_per_url para 3-5 para melhor confiabilidade

Resultados Vazios:

• Para baseado em filtros: Verifique se a palavra-chave está em português
• Tente seleções mais amplas de property_type ou operation_type
• Verifique se a categoria de imóvel existe na localização especificada
• Teste com diferentes intervalos de published_date

Problemas de Configuração:

• Verifique se os códigos de property_type correspondem aos valores enum
• Certifique-se de que os valores de operation_type estejam corretos
• Verifique o formato de published_date e sort_by

Monitore as taxas de sucesso e ajuste os parâmetros adequadamente. Acompanhe a qualidade da extração e implemente validação de dados para garantir completude.

Benefícios de Negócio e Aplicações

O Scraper de Busca de Imóveis do Imovelweb oferece significativa economia de tempo e valor comercial em múltiplas aplicações imobiliárias. Coletar manualmente os dados do Imovelweb exigiria centenas de horas para uma análise de mercado completa, enquanto o scraper realiza a mesma tarefa em minutos.

Pesquisa e Análise de Mercado:
Profissionais do setor podem acompanhar tendências de preços, identificar mercados emergentes e analisar preferências de características de imóveis em diferentes regiões do Brasil. Os dados estruturados possibilitam análises sofisticadas e inteligência de mercado que seriam impossíveis manualmente.

Apoio à Decisão de Investimento:
Investidores imobiliários podem monitorar condições de mercado, identificar imóveis subvalorizados e analisar retorno de aluguel em diferentes áreas. A coleta histórica, repetida periodicamente, permite análise de tendências e otimização do momento de investimento.

Inteligência Competitiva:
Imobiliárias podem vigiar anúncios da concorrência, estratégias de preços e posicionamento no mercado. Essa inteligência auxilia a otimizar seus próprios anúncios e identificar oportunidades no mercado.

Aplicações PropTech:
Empresas de tecnologia do setor imobiliário podem usar os dados para preencher seus bancos de dados, treinar modelos de

Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Imovelweb Property Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.