# Wimoveis Property Listings Scraper (`ecomscrape/wimoveis-property-listings-scraper`) Actor
Automated Wimoveis scraper extracts comprehensive Brazil property data including prices, locations, specifications, seller contacts & market analytics. Bulk processing thousands of listings with advanced proxy support. API-ready JSON output for seamless real estate CRM integration.
- **URL**: https://apify.com/ecomscrape/wimoveis-property-listings-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Real estate, Automation, Integrations
- **Stats:** 8 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## Contact
If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)
## Guide (English version)
### What does Wimoveis Property Search Scraper do?
### Introduction
Wimoveis.com.br stands as one of Brazil's pioneering real estate portals, founded in 1999 as the first property advertisement website in the country, serving millions of Brazilians in their property search journey. The platform specializes in properties for sale and rent across Distrito Federal and Goiás, offering comprehensive listings for houses and apartments throughout Brazil. For real estate professionals, investors, and market analysts, accessing this wealth of property data efficiently becomes crucial for making informed decisions, conducting market research, and identifying investment opportunities in Brazil's dynamic real estate landscape.
The Wimoveis Property Search Scraper addresses the critical need for automated data extraction from this extensive property database, eliminating the time-consuming manual process of browsing through thousands of listings to gather market intelligence.
### Scraper Overview
The Wimoveis Property Search Scraper is a sophisticated data extraction tool designed specifically for collecting comprehensive property information from Wimoveis.com.br's vast database. This scraper excels at processing apartment and flat listings, capturing detailed property characteristics, pricing information, publisher details, and market positioning data that would typically require hours of manual collection.
The tool's primary strength lies in its ability to extract over 25 distinct data fields per property listing, providing users with a complete property profile that includes everything from basic information like price and location to advanced market indicators such as premier status, slot positioning, and publication metrics. This comprehensive approach makes it invaluable for real estate professionals conducting competitive analysis, investors seeking market opportunities, and researchers analyzing Brazilian property trends.
Target users include real estate agencies, property investors, market researchers, appraisers, and business intelligence teams who require systematic access to Brazilian property market data for strategic decision-making and analysis purposes.
### Input and Output Details
Example url 1: https://www.wimoveis.com.br/venda/apartamentos/flat
Example url 2: https://www.wimoveis.com.br/aluguel/apartamentos/df/brasilia/setor-habitacional-jardim-botanico
Example url 3: https://www.wimoveis.com.br/venda/casas/go/goiania/setor-marista
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:
```json
{
"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 wimoveis.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.wimoveis.com.br/venda/apartamentos/flat",
"https://www.wimoveis.com.br/aluguel/apartamentos/df/brasilia/setor-habitacional-jardim-botanico",
"https://www.wimoveis.com.br/venda/casas/go/goiania/setor-marista"
],
"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:
```json
{
"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 wimoveis.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": "7", // Filter by published date
"sort_by": "low_price", // 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
- `"1"` - Lasts 1 days
- `"0"` - Today
- `"7"` - Lasts 1 week
- `"15-"` - Lasts 15 days
- `"30"` - Lasts 1 month
- `"45"` - Lasts 45 days
**The `sort_by` parameter**: Sort properties by various criteria:
- `""` (empty string) - Relevance
- `"low_price"` - Price (low to high)
- `"more_recent"` - Date (newest first)
- `"high_price"` - Price (high to low)
- `"most_visit"` - Views (high to low)
- `"most_lowered_price"` - 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 wimoveis.com.br).
#### Output Format
You get the output from the Wimoveis Property Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.
```json
[ // List of property information
{
"posting_id": "3006376096",
"url": "/propriedades/excelente-flat-com-34m-19-andar-mobiliado-e-3006376096.html",
"posting_code": "FL0106",
"title": "Excelente Flat com 34m², 19º andar, Mobiliado e Reformado - Ed Saint Moritz - SHN",
"price_operation_types": [
{
"low_price_percentage": null,
"operation_type": {
"name": "Venda",
"operation_type_id": "1"
},
"prices": [
{
"currency_id": "3",
"amount": 550000,
"formatted_amount": "550.000",
"currency": "R$"
}
]
}
],
"expenses": {
"currency_id": null,
"amount": 1045,
"formatted_amount": "1.045",
"currency": "R$"
},
"main_features": {
"c_f_t100": {
"feature_id": "CFT100",
"label": "Área total",
"measure": "m²",
"value": "34",
"icon": null,
"feature_category_id": "CFC2"
},
"c_f_t101": {
"feature_id": "CFT101",
"label": "Área útil",
"measure": "m²",
"value": "34",
"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_t3": {
"feature_id": "CFT3",
"label": "Banheiro",
"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": "10317822",
"name": "Futura Negócios imobiliários ",
"url": "/imobiliarias/futura-negocios-imobiliarios_10317822-imoveis.html",
"slot_filter_url": null,
"url_logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/10/31/78/22/130x70/logo_futura-negocios-imobiliarios_1629112143927.jpg",
"publisher_type_id": "2",
"url_chat": null,
"license": null,
"publisher_tags": [],
"parent_publisher": null,
"amount_posting_active": null,
"partial_phone": null,
"created_year": null,
"premier": true,
"slug": "Futura Negocios Imobiliarios",
"publisher_statistics": null,
"approved": false,
"main_phone": null,
"created_date": 1470974400000,
"id_portal": "103",
"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": "Futura negócios imobiliários disponibiliza para venda:
Excelente Flat com 34m², 19º andar - reformado E mobiliado - Localizado no Ed Sainto Motriz - shn
Composto por:
- Sala com varanda;
- Cozinha com máquina de lavar;
- Quarto com armários;
- 1 Banheiro
Não perca tempo, agende já sua visita
Contato
(61)
Veja outras opções em nosso site www. futuraimob. com. br
*Lembrando que o preço e disponibilidade pode sofrer alteração!
.
Futura Negócios Imobiliários
cj/df:
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Visite nosso site e conheça outras opções na, sqs 103, sqnw 309, sqs 415, sqs 412, sqs 407, sqn 403, sqn 406, sqn 405, sqs 205, sqn 316, sqsw 104, sqn 104, shcgn 705, sqn 105, sqn 305, sqn 115, sqs 106, sqn 211, sqs 106, sqn 211, sqs 214, sqn 308, sqn 212, sqs 302, sqn 313, sqs 303, sqn 212, sqn 115, sqn 206, sqs 106, sqs 109, sqsw 103, sqsw304, sqsw 303, sqsw 104, sqsw 101, sqnw 307, sqnw 109, sqsw 305 shcgn, sclrn, qrsws, ccsw, sqsw, aos, ca, guara, asa norte, asa sul, sudoeste, noroeste, lago norte, lago sul, Lago Norte; shin, Lago Sul ; shin, Águas Claras, Sobradinho, Cruzeiro - 03/07/2025",
"posting_location": {
"address": {
"name": "Quadra SHN Quadra 1 Bloco B 0",
"visibility": "EXACT"
},
"location": {
"location_id": "V1-D-499976",
"name": "Asa Norte",
"label": "ZONA",
"depth": 3,
"parent": {
"location_id": "V1-C-99998",
"name": "Brasília",
"label": "CIUDAD",
"depth": 2,
"parent": {
"location_id": "V1-B-247",
"name": "Distrito Federal",
"label": "PROVINCIA",
"depth": 1,
"parent": {
"location_id": "V1-A-2",
"name": "Brasil",
"label": "PAIS",
"depth": 0,
"parent": null,
"acronym": null
},
"acronym": "DF"
},
"acronym": null
},
"acronym": null
},
"posting_geolocation": {
"geolocation": {
"latitude": -15.7895417,
"longitude": -47.8872821
},
"url_static_map": "//maps.google.com/maps/api/staticmap?center=-15.7895416999999991247705111163668334484100341796875,-47.88728210000000018453647498972713947296142578125&zoom=16&key=AIzaSyB_oTDQAy22B6JrYEfHrUvNcrzA2RjTAeU&size=780x456&sensor=true&scale=2&signature=kX9RKNxK7KrhYXby5YDcyfT4xUQ=&channel=rplis-wi",
"visibility": null
}
},
"visible_pictures": {
"pictures": [
{
"multimedia_type_id": "2",
"order": 0,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595473.jpg?isFirstImage=true",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595473.jpg?isFirstImage=true",
"url130x70": null,
"title": "7e301021313e2457e4c1eaab6b1da02db91b6403 · Excelente Flat com 34m², 19º andar, Mobiliado e Reformado - Ed Saint Moritz - SHN"
},
{
"multimedia_type_id": "2",
"order": 1,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595735.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595735.jpg",
"url130x70": null,
"title": "31165ca15b01bb6719ff3dd519ecf8074d728e37"
},
{
"multimedia_type_id": "2",
"order": 2,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595479.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595479.jpg",
"url130x70": null,
"title": "3e9c242fbfe57364b5225a1ef6aa621f7096eea4"
},
{
"multimedia_type_id": "2",
"order": 3,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595887.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595887.jpg",
"url130x70": null,
"title": "d866938439829f44585bc6e5519a438f9d626ebf"
},
{
"multimedia_type_id": "2",
"order": 4,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595799.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595799.jpg",
"url130x70": null,
"title": "c58482a2ec72ba7c05304cd217d5174f58e81f4e"
},
{
"multimedia_type_id": "2",
"order": 5,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870596431.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870596431.jpg",
"url130x70": null,
"title": "aa0df5fee71d4d0a77fd7031480e5050fe86e9c2"
},
{
"multimedia_type_id": "2",
"order": 6,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870596088.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870596088.jpg",
"url130x70": null,
"title": "7738a1f96b208676d4d44d477542e56a4e314502"
},
{
"multimedia_type_id": "2",
"order": 7,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595857.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595857.jpg",
"url130x70": null,
"title": "cac1a2ee23a8548634b427dda858aaf92cadd697"
}
],
"additional_pictures_count": 2
},
"status": "ONLINE",
"posting_type": "PROPERTY",
"whatsapp": "55 61994009405",
"modified_date": "2025-07-04T11:24:30-0400",
"from_url": "https://www.wimoveis.com.br/venda/apartamentos/flat"
}, // ... Many other property details
]
```
The scraper returns comprehensive property data with 25+ fields per listing, each serving specific analytical purposes:
**Core Identification Fields:**
- **Posting ID**: Unique internal identifier for cross-referencing and database management
- **URL**: Direct link to the property listing for verification and follow-up analysis
- **Posting Code**: Wimoveis-specific reference number for customer service and inquiries
- **Title**: Complete property description as it appears on the platform
**Financial Information:**
- **Price Operation Types**: Distinguishes between sale, rent, or lease arrangements, crucial for market segmentation
- **Expenses**: Additional costs beyond base price, including maintenance fees and taxes that affect total investment
**Property Characteristics:**
- **Main Features**: Core attributes like bedrooms, bathrooms, and square footage for comparison analysis
- **General Features**: Standard amenities and property characteristics for market positioning
- **Development Features**: New construction or development-specific attributes for investment analysis
- **Highlighted Features**: Premium amenities that command higher market values
- **Flags Features**: Special indicators such as "new listing," "price reduced," or "featured property"
**Market Intelligence Fields:**
- **Antiquity**: Property age, critical for depreciation calculations and renovation planning
- **Premier**: Premium listing status indicating additional marketing investment by sellers
- **Slot/Slot Color**: Advertisement positioning data revealing marketing strategy and competition levels
- **Status**: Current availability and transaction stage for timing investment decisions
**Publisher and Contact Information:**
- **Publisher**: Real estate agency or individual seller information for direct communication
- **URL Logo**: Visual branding elements for publisher identification and credibility assessment
- **Whatsapp**: Direct contact method reflecting modern communication preferences in Brazilian market
**Enhanced Data Fields:**
- **Real Estate Type**: Detailed property categorization beyond basic apartment/house classifications
- **Units**: For multi-unit properties, essential for rental yield calculations
- **House Info**: Specific residential features and conditions
- **Description Normalized**: Cleaned and standardized property descriptions for text analysis
- **Posting Location**: Precise geographic data for location-based market analysis
- **Visible Pictures**: Image count indicating listing quality and marketing effort
- **Publication/Modified Date**: Timing data for market velocity analysis and listing freshness
This comprehensive output structure enables users to conduct sophisticated market analysis, from basic price comparisons to advanced predictive modeling and investment opportunity identification.
### Usage Guide
#### Method 1: Scraping with URLs
**Step-by-Step Implementation:**
1. **URL Preparation**: Navigate to Wimoveis.com.br and construct your target URLs using their search filters for specific property types, locations, or price ranges. You can paste URLs one by one or use the Bulk edit section to add a prepared list.
2. **Configuration Setup**: Adjust the JSON input parameters based on your data requirements and processing constraints. Enable `ignore_url_failures` to ensure your scraping job continues even if some URLs fail after reaching the maximum retry limit.
3. **Proxy Selection**: Ensure your proxy country matches your target market (Brazil/BR) to avoid geo-blocking and ensure optimal performance when accessing Wimoveis.com.br.
4. **Execution Monitoring**: Track the scraping progress and handle any rate limiting or access restrictions. When providing URLs for scraping, all options in the "Scrape with search filters" section will be automatically disabled.
5. **Data Validation**: Review extracted data for completeness and accuracy before analysis.
#### Method 2: Scraping with Search Filters
**Step 1: Configure Search Parameters**
Instead of providing specific URLs, configure your search by setting a keyword and optional filters. Leave the `urls` field empty when using this method.
Enter a `keyword` to search for properties in specific locations (e.g., "sao paulo", "rio de janeiro", "brasilia", "belo horizonte", "curitiba").
**Step 2: Set Property and Operation Filters**
Choose the property type you want to scrape:
- Select from various options like Apartamento (Apartment), Casa (House), Terreno (Land), Comercial (Commercial), Rural, Condomínio de casas, Lote, etc.
- Specify the operation type: Rent (Aluguel), Buy (Venda), Temporal Rent, New (Lançamento), or Auction (Leilão)
**Step 3: Set Date and Sorting Options**
Filter by published date:
- Choose from options like "Today", "Lasts 1 days", "Lasts 1 week", "Lasts 1 month", etc. to get recent listings
Sort results by:
- Price (low to high or high to low)
- Date (newest first)
- Views (high to low)
- Variation (high to low)
- Relevance (default)
**Step 4: Specify Starting Page**
Set the `page` parameter to specify which page number to start scraping from. This is useful for continuing interrupted scrapes or targeting specific result ranges.
**Step 5: Configure Proxy and Execute**
Set proxy configuration with Brazil (BR) as the country for optimal performance. Run the scraper with your search configuration. The tool will automatically search based on your filters and extract matching property listings.
#### Best Practices:
- **For URL-based scraping**: Limit concurrent requests to respect website resources and avoid IP blocking
- **For search-based scraping**: Use specific location keywords and appropriate filters to narrow down results and improve data quality
- Use residential proxies for better success rates with Brazilian property sites
- Implement proper data storage and backup procedures for valuable market intelligence
- Regular monitoring ensures continued compatibility with website updates
- Start with a small `max_items_per_url` value to test your configuration before running large-scale extractions
- Enable `ignore_url_failures` to ensure partial data collection even when some URLs encounter issues
- Use published date filters to focus on recent listings and avoid outdated properties
- Ensure Brazil (BR) proxy location is used for optimal access to Wimoveis.com.br
#### Common Error Handling:
- **Connection timeouts**: Increase retry delays and reduce concurrent requests
- **Missing data fields**: Verify URL formats and property page structures haven't changed
- **IP restrictions**: Rotate proxy servers with Brazil (BR) location and implement proper request spacing
- **No search results**: Ensure the `urls` field is empty when using search filters, and verify keyword and filter combinations are valid
- **Empty results**: Check that property_type, operation_type, and other filters match available listings on Wimoveis
- **Access blocked**: Verify that Brazil (BR) proxies are properly configured and residential proxy groups are enabled
### Benefits and Applications
The Wimoveis scraper delivers significant time savings by automating what would typically require days of manual research into hours of automated data collection. Real estate professionals gain competitive advantages through systematic market monitoring, while investors can identify undervalued properties and emerging market trends through comprehensive data analysis.
Practical applications include market report generation, competitive pricing analysis, investment portfolio optimization, and client consultation services enhanced by real-time market intelligence. The scraped data supports business intelligence initiatives, enabling users to make data-driven decisions in Brazil's dynamic property market.
### Conclusion
The Wimoveis Property Search Scraper provides essential market intelligence capabilities for anyone serious about Brazilian real estate analysis. By automating comprehensive data extraction from one of Brazil's leading property platforms, it transforms time-intensive research into efficient, systematic market intelligence gathering.
Ready to gain competitive advantage in Brazilian real estate markets? Start extracting valuable property data today and transform your market analysis capabilities.
## Introdução (Versão em português do Brasil)
### O que faz o Scraper de Busca de Imóveis do Wimoveis?
### Introdução
O Wimoveis.com.br se destaca como um dos portais imobiliários pioneiros no Brasil, fundado em 1999 como o primeiro site de anúncios de imóveis do país, servindo milhões de brasileiros em sua busca por propriedades. A plataforma é especializada em imóveis para venda e locação no Distrito Federal e Goiás, oferecendo anúncios abrangentes de casas e apartamentos em todo o Brasil. Para profissionais do setor imobiliário, investidores e analistas de mercado, acessar de forma eficiente essa riqueza de dados imobiliários torna-se crucial para decisões informadas, pesquisas de mercado e identificação de oportunidades de investimento no dinâmico cenário imobiliário brasileiro.
O Scraper de Busca de Imóveis do Wimoveis atende à necessidade crítica de extração automatizada de dados dessa extensa base de imóveis, eliminando o processo manual e demorado de navegar por milhares de anúncios para obter inteligência de mercado.
### Visão Geral do Scraper
O Scraper de Busca de Imóveis do Wimoveis é uma ferramenta sofisticada de extração de dados, projetada especificamente para coletar informações imobiliárias abrangentes do vasto banco de dados do Wimoveis.com.br. Este scraper se destaca ao processar anúncios de apartamentos e flats, capturando características detalhadas dos imóveis, informações de preços, dados do anunciante e métricas de posicionamento de mercado que normalmente exigiriam horas de coleta manual.
O principal diferencial da ferramenta está na capacidade de extrair mais de 25 campos de dados distintos por anúncio de imóvel, proporcionando aos usuários um perfil completo do imóvel, que vai desde informações básicas como preço e localização até indicadores de mercado avançados, como status de destaque, posicionamento na página e métricas de publicação. Essa abordagem abrangente o torna inestimável para profissionais do setor na realização de análise competitiva, investidores em busca de oportunidades de mercado e pesquisadores que analisam tendências do mercado imobiliário brasileiro.
Os usuários-alvo incluem imobiliárias, investidores, pesquisadores de mercado, avaliadores e equipes de inteligência de negócios que necessitam de acesso sistemático aos dados do mercado imobiliário brasileiro para tomadas de decisão estratégica e fins analíticos.
### Detalhes de Entrada e Saída
Exemplo de url 1: https://www.wimoveis.com.br/venda/apartamentos/flat
Exemplo de url 2: https://www.wimoveis.com.br/aluguel/apartamentos/df/brasilia/setor-habitacional-jardim-botanico
Exemplo de url 3: https://www.wimoveis.com.br/venda/casas/go/goiania/setor-marista
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:
```json
{
"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 wimoveis.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.wimoveis.com.br/venda/apartamentos/flat",
"https://www.wimoveis.com.br/aluguel/apartamentos/df/brasilia/setor-habitacional-jardim-botanico",
"https://www.wimoveis.com.br/venda/casas/go/goiania/setor-marista"
],
"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:
```json
{
"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 wimoveis.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": "7", // Filtrar por data de publicação
"sort_by": "low_price", // 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
- `"1"` - Últimos 1 dias
- `"0"` - Hoje
- `"7"` - Última 1 semana
- `"15-"` - Últimos 15 dias
- `"30"` - Último 1 mês
- `"45"` - Últimos 45 dias
**O parâmetro `sort_by`**: Ordene imóveis por vários critérios:
- `""` (string vazia) - Relevância
- `"low_price"` - Preço (do menor para o maior)
- `"more_recent"` - Data (mais recentes primeiro)
- `"high_price"` - Preço (do maior para o menor)
- `"most_visit"` - Visitas (do maior para o menor)
- `"most_lowered_price"` - 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 wimoveis.com.br).
#### Formato de Saída
Você receberá a saída do Scraper de Busca de Imóveis do Wimoveis armazenada em uma aba. A seguir está um exemplo dos Campos de Informação coletados após a execução do Ator.
```json
[ // List of property information
{
"posting_id": "3006376096",
"url": "/propriedades/excelente-flat-com-34m-19-andar-mobiliado-e-3006376096.html",
"posting_code": "FL0106",
"title": "Excelente Flat com 34m², 19º andar, Mobiliado e Reformado - Ed Saint Moritz - SHN",
"price_operation_types": [
{
"low_price_percentage": null,
"operation_type": {
"name": "Venda",
"operation_type_id": "1"
},
"prices": [
{
"currency_id": "3",
"amount": 550000,
"formatted_amount": "550.000",
"currency": "R$"
}
]
}
],
"expenses": {
"currency_id": null,
"amount": 1045,
"formatted_amount": "1.045",
"currency": "R$"
},
"main_features": {
"c_f_t100": {
"feature_id": "CFT100",
"label": "Área total",
"measure": "m²",
"value": "34",
"icon": null,
"feature_category_id": "CFC2"
},
"c_f_t101": {
"feature_id": "CFT101",
"label": "Área útil",
"measure": "m²",
"value": "34",
"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_t3": {
"feature_id": "CFT3",
"label": "Banheiro",
"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": "10317822",
"name": "Futura Negócios imobiliários ",
"url": "/imobiliarias/futura-negocios-imobiliarios_10317822-imoveis.html",
"slot_filter_url": null,
"url_logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/10/31/78/22/130x70/logo_futura-negocios-imobiliarios_1629112143927.jpg",
"publisher_type_id": "2",
"url_chat": null,
"license": null,
"publisher_tags": [],
"parent_publisher": null,
"amount_posting_active": null,
"partial_phone": null,
"created_year": null,
"premier": true,
"slug": "Futura Negocios Imobiliarios",
"publisher_statistics": null,
"approved": false,
"main_phone": null,
"created_date": 1470974400000,
"id_portal": "103",
"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": "Futura negócios imobiliários disponibiliza para venda:
Excelente Flat com 34m², 19º andar - reformado E mobiliado - Localizado no Ed Sainto Motriz - shn
Composto por:
- Sala com varanda;
- Cozinha com máquina de lavar;
- Quarto com armários;
- 1 Banheiro
Não perca tempo, agende já sua visita
Contato
(61)
Veja outras opções em nosso site www. futuraimob. com. br
*Lembrando que o preço e disponibilidade pode sofrer alteração!
.
Futura Negócios Imobiliários
cj/df:
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Visite nosso site e conheça outras opções na, sqs 103, sqnw 309, sqs 415, sqs 412, sqs 407, sqn 403, sqn 406, sqn 405, sqs 205, sqn 316, sqsw 104, sqn 104, shcgn 705, sqn 105, sqn 305, sqn 115, sqs 106, sqn 211, sqs 106, sqn 211, sqs 214, sqn 308, sqn 212, sqs 302, sqn 313, sqs 303, sqn 212, sqn 115, sqn 206, sqs 106, sqs 109, sqsw 103, sqsw304, sqsw 303, sqsw 104, sqsw 101, sqnw 307, sqnw 109, sqsw 305 shcgn, sclrn, qrsws, ccsw, sqsw, aos, ca, guara, asa norte, asa sul, sudoeste, noroeste, lago norte, lago sul, Lago Norte; shin, Lago Sul ; shin, Águas Claras, Sobradinho, Cruzeiro - 03/07/2025",
"posting_location": {
"address": {
"name": "Quadra SHN Quadra 1 Bloco B 0",
"visibility": "EXACT"
},
"location": {
"location_id": "V1-D-499976",
"name": "Asa Norte",
"label": "ZONA",
"depth": 3,
"parent": {
"location_id": "V1-C-99998",
"name": "Brasília",
"label": "CIUDAD",
"depth": 2,
"parent": {
"location_id": "V1-B-247",
"name": "Distrito Federal",
"label": "PROVINCIA",
"depth": 1,
"parent": {
"location_id": "V1-A-2",
"name": "Brasil",
"label": "PAIS",
"depth": 0,
"parent": null,
"acronym": null
},
"acronym": "DF"
},
"acronym": null
},
"acronym": null
},
"posting_geolocation": {
"geolocation": {
"latitude": -15.7895417,
"longitude": -47.8872821
},
"url_static_map": "//maps.google.com/maps/api/staticmap?center=-15.7895416999999991247705111163668334484100341796875,-47.88728210000000018453647498972713947296142578125&zoom=16&key=AIzaSyB_oTDQAy22B6JrYEfHrUvNcrzA2RjTAeU&size=780x456&sensor=true&scale=2&signature=kX9RKNxK7KrhYXby5YDcyfT4xUQ=&channel=rplis-wi",
"visibility": null
}
},
"visible_pictures": {
"pictures": [
{
"multimedia_type_id": "2",
"order": 0,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595473.jpg?isFirstImage=true",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595473.jpg?isFirstImage=true",
"url130x70": null,
"title": "7e301021313e2457e4c1eaab6b1da02db91b6403 · Excelente Flat com 34m², 19º andar, Mobiliado e Reformado - Ed Saint Moritz - SHN"
},
{
"multimedia_type_id": "2",
"order": 1,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595735.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595735.jpg",
"url130x70": null,
"title": "31165ca15b01bb6719ff3dd519ecf8074d728e37"
},
{
"multimedia_type_id": "2",
"order": 2,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595479.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595479.jpg",
"url130x70": null,
"title": "3e9c242fbfe57364b5225a1ef6aa621f7096eea4"
},
{
"multimedia_type_id": "2",
"order": 3,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595887.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595887.jpg",
"url130x70": null,
"title": "d866938439829f44585bc6e5519a438f9d626ebf"
},
{
"multimedia_type_id": "2",
"order": 4,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595799.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595799.jpg",
"url130x70": null,
"title": "c58482a2ec72ba7c05304cd217d5174f58e81f4e"
},
{
"multimedia_type_id": "2",
"order": 5,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870596431.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870596431.jpg",
"url130x70": null,
"title": "aa0df5fee71d4d0a77fd7031480e5050fe86e9c2"
},
{
"multimedia_type_id": "2",
"order": 6,
"height": 1080,
"width": 1440,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870596088.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870596088.jpg",
"url130x70": null,
"title": "7738a1f96b208676d4d44d477542e56a4e314502"
},
{
"multimedia_type_id": "2",
"order": 7,
"height": 1080,
"width": 810,
"url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/720x532/4870595857.jpg",
"url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/06/37/60/96/360x266/4870595857.jpg",
"url130x70": null,
"title": "cac1a2ee23a8548634b427dda858aaf92cadd697"
}
],
"additional_pictures_count": 2
},
"status": "ONLINE",
"posting_type": "PROPERTY",
"whatsapp": "55 61994009405",
"modified_date": "2025-07-04T11:24:30-0400",
"from_url": "https://www.wimoveis.com.br/venda/apartamentos/flat"
}, // ... Many other property details
]
```
O scraper retorna dados completos de imóveis com mais de 25 campos por anúncio, cada um servindo a propósitos analíticos específicos:
**Campos de Identificação Principal:**
- **ID do Anúncio**: Identificador interno único para cruzamento e gestão de banco de dados
- **URL**: Link direto para o anúncio do imóvel, facilitando verificação e análise posterior
- **Código do Anúncio**: Número de referência específico do Wimoveis para atendimento ao cliente e consultas
- **Título**: Descrição completa do imóvel conforme aparece na plataforma
**Informações Financeiras:**
- **Tipos de Operação de Preço**: Distingue entre venda, aluguel ou arrendamento, crucial para segmentação de mercado
- **Despesas**: Custos adicionais além do preço base, incluindo taxas de manutenção e impostos que impactam o investimento total
**Características do Imóvel:**
- **Características Principais**: Atributos essenciais como quartos, banheiros e metragem para análise comparativa
- **Características Gerais**: Amenidades padrão e características do imóvel para posicionamento de mercado
- **Características do Empreendimento**: Atributos específicos de lançamentos ou empreendimentos para análise de investimento
- **Características em Destaque**: Amenidades premium que agregam valor ao imóvel
- **Características de Selo**: Indicadores especiais como "novo anúncio", "preço reduzido" ou "imóvel em destaque"
**Campos de Inteligência de Mercado:**
- **Antiguidade**: Idade do imóvel, importante para cálculos de depreciação e planejamento de reforma
- **Premier**: Status de anúncio premium que indica investimento adicional em marketing pelo vendedor
- **Slot/Cor do Slot**: Dados de posicionamento do anúncio, revelando estratégia de marketing e nível de concorrência
- **Status**: Disponibilidade atual e estágio da transação, útil para decisões de investimento no tempo certo
**Informações do Anunciante e Contato:**
- **Publicador**: Informações da imobiliária ou vendedor para contato direto
- **URL do Logo**: Elementos visuais de branding para identificação e avaliação de credibilidade do publicador
- **Whatsapp**: Método de contato direto, refletindo preferências modernas de comunicação no mercado brasileiro
**Campos de Dados Avançados:**
- **Tipo de Imóvel**: Categorização detalhada além das classificações básicas de casa/apartamento
- **Unidades**: Para propriedades de múltiplas unidades, essencial para cálculos de rentabilidade
- **Informações da Casa**: Recursos e condições específicas de imóveis residenciais
- **Descrição Normalizada**: Descrições de imóveis limpas e padronizadas para análise textual
- **Localização do Anúncio**: Dados geográficos precisos para análise de mercado baseada em localização
- **Fotos Visíveis**: Contagem de imagens que indica qualidade do anúncio e esforço de marketing
- **Data de Publicação/Modificação**: Dados temporais para análise de velocidade de mercado e atualização do anúncio
Essa estrutura abrangente de saída permite aos usuários realizar análises de mercado sofisticadas, desde comparações básicas de preço até modelagem preditiva avançada e identificação de oportunidades de investimento.
### Guia de Uso
#### Método 1: Extração com URLs
**Implementação Passo a Passo:**
1. **Preparação de URLs**: Navegue pelo Wimoveis.com.br e construa suas URLs alvo usando os filtros de busca para tipos específicos de imóveis, localizações ou faixas de preço. Você pode colar URLs uma por uma ou usar a seção de Edição em massa para adicionar uma lista preparada.
2. **Configuração**: Ajuste os parâmetros de entrada JSON com base em seus requisitos de dados e restrições de processamento. Habilite `ignore_url_failures` para garantir que seu trabalho de extração continue mesmo se algumas URLs falharem após atingir o limite máximo de reintentos.
3. **Seleção de Proxy**: Certifique-se de que o país do seu proxy corresponda ao seu mercado-alvo (Brasil/BR) para evitar bloqueio geográfico e garantir desempenho ideal ao acessar o Wimoveis.com.br.
4. **Monitoramento da Execução**: Acompanhe o progresso da extração e lide com quaisquer limitações de taxa ou restrições de acesso. Ao fornecer URLs para extração, todas as opções na seção "Extrair com filtros de busca" serão desabilitadas automaticamente.
5. **Validação de Dados**: Revise os dados extraídos quanto à completude e precisão antes da análise.
#### Método 2: Extração com Filtros de Busca
**Passo 1: Configurar Parâmetros de Busca**
Em vez de fornecer URLs específicas, configure sua busca definindo uma palavra-chave e filtros opcionais. Deixe o campo `urls` vazio ao usar este método.
Digite uma `keyword` para buscar imóveis em localizações específicas (por exemplo, "sao paulo", "rio de janeiro", "brasilia", "belo horizonte", "curitiba").
**Passo 2: Configurar Filtros de Imóvel e Operação**
Escolha o tipo de imóvel que você quer extrair:
- Selecione entre várias opções como Apartamento, Casa, Terreno, Comercial, Rural, Condomínio de casas, Lote, etc.
- Especifique o tipo de operação: Aluguel, Venda, Aluguel Temporário, Lançamento ou Leilão
**Passo 3: Configurar Opções de Data e Ordenação**
Filtre por data de publicação:
- Escolha entre opções como "Hoje", "Últimos 1 dias", "Última 1 semana", "Último 1 mês", etc. para obter listagens recentes
Ordene os resultados por:
- Preço (do menor para o maior ou do maior para o menor)
- Data (mais recentes primeiro)
- Visitas (do maior para o menor)
- Variação (do maior para o menor)
- Relevância (padrão)
**Passo 4: Especificar Página Inicial**
Configure o parâmetro `page` para especificar de qual número de página começar a extração. Isso é útil para continuar extrações interrompidas ou segmentar intervalos de resultados específicos.
**Passo 5: Configurar Proxy e Executar**
Configure o proxy com Brasil (BR) como país para desempenho ideal. Execute o extrator com sua configuração de busca. A ferramenta buscará automaticamente com base em seus filtros e extrairá as listagens de imóveis correspondentes.
#### Melhores Práticas:
- **Para extração baseada em URLs**: Limite requisições simultâneas para respeitar os recursos do site e evitar bloqueio de IP
- **Para extração baseada em busca**: Use palavras-chave de localização específicas e filtros apropriados para refinar resultados e melhorar a qualidade dos dados
- Use proxies residenciais para melhores taxas de sucesso com sites de imóveis brasileiros
- Implemente procedimentos adequados de armazenamento e backup de dados para inteligência de mercado valiosa
- Monitoramento regular garante compatibilidade contínua com atualizações do site
- Comece com um valor pequeno de `max_items_per_url` para testar sua configuração antes de executar extrações em grande escala
- Habilite `ignore_url_failures` para garantir coleta parcial de dados mesmo quando algumas URLs encontrarem problemas
- Use filtros de data de publicação para focar em listagens recentes e evitar imóveis desatualizados
- Certifique-se de que a localização do proxy Brasil (BR) seja usada para acesso ideal ao Wimoveis.com.br
#### Tratamento de Erros Comuns:
- **Timeouts de conexão**: Aumente os atrasos de reintento e reduza requisições simultâneas
- **Campos de dados ausentes**: Verifique os formatos de URL e se as estruturas das páginas de imóveis não mudaram
- **Restrições de IP**: Alterne servidores proxy com localização Brasil (BR) e implemente espaçamento adequado de requisições
- **Sem resultados de busca**: Certifique-se de que o campo `urls` esteja vazio ao usar filtros de busca, e verifique se as combinações de palavras-chave e filtros são válidas
- **Resultados vazios**: Verifique se property_type, operation_type e outros filtros correspondem às listagens disponíveis no Wimoveis
- **Acesso bloqueado**: Verifique se os proxies do Brasil (BR) estão configurados corretamente e se os grupos de proxy residenciais estão habilitados
### Benefícios e Aplicações
O scraper do Wimoveis proporciona significativa economia de tempo, automatizando tarefas que normalmente demandariam dias de pesquisa manual em apenas algumas horas de coleta automatizada. Profissionais do setor imobiliário ganham vantagem competitiva ao monitorar sistematicamente o mercado, enquanto investidores identificam imóveis subvalorizados e tendências emergentes por meio de análise de dados abrangente.
Aplicações práticas incluem geração de relatórios de mercado, análise competitiva de preços, otimização de portfólios de investimento e consultorias para clientes baseadas em inteligência de mercado em tempo real. Os dados extraídos sustentam iniciativas de business intelligence, possibilitando decisões orientadas a dados no dinâmico mercado imobiliário brasileiro.
### Conclusão
O Scraper de Busca de Imóveis do Wimoveis oferece capacidades essenciais de inteligência de mercado para quem leva a sério a análise imobiliária no Brasil. Ao automatizar a extração de dados abrangentes de uma das principais plataformas do país, transforma pesquisas demoradas em obtenção eficiente e sistemática de inteligência de mercado.
Pronto para ganhar vantagem competitiva no mercado imobiliário brasileiro? Comece agora a extrair dados valiosos e transforme sua capacidade de análise de mercado.
## Related Actors
- [**Imovelweb Property Search Scraper**](ecomscrape/imovelweb-property-search-scraper): Your comprehensive tool for extracting valuable property information from Imovelweb extensive directory platform.
- [**Inmuebles24 Property Search Scraper**](https://apify.com/ecomscrape/inmuebles24-property-search-scraper): Your comprehensive tool for extracting valuable property information from Inmuebles24 extensive directory platform.
### Your feedback
We are always working to improve Actors' performance. So, if you have any technical feedback about Wimoveis Property Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.
# Actor input Schema
## `urls` (type: `array`):
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.
## `ignore_url_failures` (type: `boolean`):
If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached.
## `keyword` (type: `string`):
Enter the keyword to search for items
## `property_type` (type: `string`):
Filter items by Property Type
## `operation_type` (type: `string`):
Filter items by Operation Type
## `published_date` (type: `string`):
Filter items by Published Date
## `sort_by` (type: `string`):
Sort items by (e.g., precio-ascendente, publicado-descendente, precio-descendente, visitas-descendente, variacionporcentual-descendente)
## `page` (type: `integer`):
Specify the page number to start scraping from
## `max_items_per_url` (type: `integer`):
Limit the number of items per URL or search filters you want to scrape
## `max_retries_per_url` (type: `integer`):
Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load
## `proxy` (type: `object`):
Select proxies to be used by your scraper.
## Actor input object example
```json
{
"urls": [
"https://www.wimoveis.com.br/venda/apartamentos/flat"
],
"ignore_url_failures": true,
"max_items_per_url": 20,
"max_retries_per_url": 2,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "BR"
}
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://www.wimoveis.com.br/venda/apartamentos/flat"
],
"ignore_url_failures": true,
"max_items_per_url": 20,
"max_retries_per_url": 2,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "BR"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/wimoveis-property-listings-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"urls": ["https://www.wimoveis.com.br/venda/apartamentos/flat"],
"ignore_url_failures": True,
"max_items_per_url": 20,
"max_retries_per_url": 2,
"proxy": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "BR",
},
}
# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/wimoveis-property-listings-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"urls": [
"https://www.wimoveis.com.br/venda/apartamentos/flat"
],
"ignore_url_failures": true,
"max_items_per_url": 20,
"max_retries_per_url": 2,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "BR"
}
}' |
apify call ecomscrape/wimoveis-property-listings-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/wimoveis-property-listings-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/5VqNtoFSKr1XWNXgn/builds/rUNNyJ9jXMtgmmBKa/openapi.json