# Bradesco Imóveis: Brazil Property Auction Scraper (`getascraper/bradesco-imoveis-scraper`) Actor Scrape Bradesco Imóveis (Vitrine Bradesco) property auctions in Brazil. Filter leilão de imóveis by state, city, property type, auction house, price, discount, and auction date. Export auction stages, prices, images, due-diligence signals, and links for research, lead generation, and automation. - **URL**: https://apify.com/getascraper/bradesco-imoveis-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.31 / 1,000 auction listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🏘️ Bradesco Imóveis Scraper: Brazilian auctions
Screen Brazilian property auctions with the price and due-diligence details you need.
Collect structured real-estate auction listings from Vitrine Bradesco's public catalog. Filter imóveis by UF, cidade, bairro, auction house, price, discount, or auction deadline, then choose the listing details you need.
📍 Focus the search
Filter by UF, cidade, bairro, property type, auction method, and auction house. 		💸 Compare auction stages
Review first, second, and final values beside an effective price and discount. 		🧾 Enrich when needed
Choose descriptions, images, auction-house details, and original source fields. 		🔎 Keep provenance
Retain source links, source page details, and the extraction timestamp for each row.
Use this Actor to turn Vitrine Bradesco auction listings into a consistent dataset for screening, research, lead generation, and market monitoring. It collects public property-auction data and omits fields the source does not provide. ### 📌 Why use this Actor? - **I am a property investor** screening leilões de imóveis across Brazil to compare auction stages, discounts, dates, and location before deeper due diligence. - **I am a real-estate research analyst** building a repeatable view of Bradesco auction inventory by UF, cidade, bairro, category, and auction modality. - **I am an acquisitions team member** collecting direct listing and auctioneer links so I can route promising properties into an internal review process. ### 🚀 How it works
STEP 1
Set your scope
Choose a saved search or set states, location, property type, and auction criteria. 		STEP 2
Choose detail depth
Keep the helpful listing details, images, and auction-house information you need. 		STEP 3
Review structured rows
Use price, auction, property, and due-diligence fields to prioritize the next review.
### 🎛️ Input | Field | Type | Required | Description | | ---------------------- | ---------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array of URLs | No | Optional saved Vitrine Bradesco auction-results URL. Leave empty to build a search with the filters below. | | `states` | array of options | No | States to include, such as `SP` or `RJ`. Leave empty to search across Brazil. | | `city` | string | No | Exact city name to include, such as `São Paulo`. Leave empty to include every city in the selected states. | | `neighborhood` | string | No | Exact neighborhood name to include, as reported by the listing. | | `searchTerm` | string | No | Optional keyword to find in the listing title, description, city, or neighborhood. | | `propertyCategory` | string | No | Property type such as Casa, Apartamento, Terreno, or Sítio. Leave empty to include every type. | | `auctionType` | string | No | Auction modality, such as alienação fiduciária or convencional. Leave empty for all modalities. | | `auctioneer` | string | No | Auction-house name, such as ZUK or Mega Leilões. Leave empty to include every auction house. | | `minPriceBrl` | number | No | Minimum auction value in Brazilian reais. The Actor uses the best available auction value for this comparison. | | `maxPriceBrl` | number | No | Maximum auction value in Brazilian reais. Listings without a usable value are excluded. | | `minDiscountPercent` | number | No | Minimum discount versus the first auction value. The comparison uses the final or second-stage value when available. | | `auctionEndBefore` | string | No | Latest auction date to include. Listings after this date are excluded. | | `onlyWithoutDebts` | boolean | No | Keep only listings marked by the source as having no debts. This does not replace legal due diligence. | | `onlyWithVisitAllowed` | boolean | No | Keep only listings marked by the source as allowing property visits. | | `onlyWithLegalActions` | boolean | No | Keep only listings with information returned by the source legal-action filter. | | `proxyConfiguration` | object | No | Use a direct connection by default for this public catalog. Turn on Apify Proxy for repeated runs from different network locations. | | `includeDetails` | boolean | No | Optional paid enrichment for address, direct auction link, update time, and auction location. A separate event applies only to successful detail records. Defaults to false. | | `includeDescription` | boolean | No | Include the original listing description, which may contain areas, registry, occupancy, and legal notes. Defaults to true. | | `includeImages` | boolean | No | Include source image URLs and the primary image URL when available. Defaults to true. | | `includeAuctioneer` | boolean | No | Include auction-house name, website, logo, and available source information. Defaults to true. | | `includeRawSource` | boolean | No | Keep the original source record for advanced workflows. Defaults to false. | | `maxItems` | integer | No | Maximum matching listing rows to return. Set `0` only for an intentional unlimited run within the page limit. Defaults to 10. | | `maxPages` | integer | No | Maximum result pages to check. Each page contains up to 30 listings. Set `0` only for an intentional unlimited run. Defaults to 2. | | `requestDelayMs` | integer | No | Pause between source requests in milliseconds. Defaults to 150. | | `maxRetries` | integer | No | Number of retries for temporary source or connection failures. Defaults to 3. | ### 🧭 Example input ```json { "states": ["SP"], "city": "São Paulo", "propertyCategory": "Casa", "maxPriceBrl": 500000, "minDiscountPercent": 10, "maxItems": 25 } ``` Leave `states` empty to include all of Brazil. Leave optional location, price, discount, and auction filters blank when you want a broader collection. ### 📦 Data table Every row represents one source auction listing. Optional fields are omitted when the source does not provide them or when the matching enrichment option is off. | Field | Type | Description | | --------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------- | | `property_id` | string | Stable source GUID for deduplication and change tracking. | | `title` | string | Source auction listing name. | | `property_type` | string | Source property category. | | `auction_type` | string | Source real-estate auction modality. | | `city` | string | City reported by the source. | | `state` | string | Brazilian state abbreviation reported by the source. | | `neighborhood` | string | Neighborhood reported by the source. | | `address` | string | Structured address returned by the detail record when available. | | `listing_url` | string | Canonical Vitrine Bradesco listing URL. | | `external_listing_url` | string | Direct auctioneer listing URL returned by the detail record. | | `source_api_url` | string | Source listing page used for this row. | | `source_type` | string | Listing source category. | | `page_number` | integer | Source page containing the listing. | | `total_pages` | integer | Total pages reported for the selected query. | | `available_listing_count` | integer | Total listings reported for the selected query. | | `scraped_at` | string | ISO 8601 extraction timestamp. | | `last_updated_at` | string | Source detail update timestamp when available. | | `auction_status` | string | Status derived from the latest available auction date. | | `auction_location` | string | Auction location or online participation note. | | `listed_price_brl` | number | Raw listed price from the source. Some source records use zero when unavailable. | | `effective_price_brl` | number | Best available auction value, prioritizing final, second-stage, first-stage, then positive listed price. | | `effective_price_basis` | string | Auction stage used for the effective price. | | `currency` | string | Currency code when supplied by the source. | | `first_auction_value_brl` | number | First auction value from the source. | | `second_auction_value_brl` | number | Second auction value from the source. | | `final_auction_value_brl` | number | Final auction value from the source when recorded. | | `discount_from_first_bid_percent` | number | Reduction from the first auction value to the final or second-stage value. | | `auction_date` | string | Primary auction date from the source. | | `first_auction_date` | string | First auction date from the source. | | `second_auction_date` | string | Second auction date from the source. | | `final_auction_date` | string | Final auction date from the source when recorded. | | `created_at` | string | Source record creation timestamp. | | `occupancy_status` | string | Occupancy statement extracted from the source description when present. | | `private_area_sqm` | number | Private or useful area parsed from the source description when explicitly stated. | | `built_area_sqm` | number | Built or constructed area parsed from the source description when explicitly stated. | | `land_area_sqm` | number | Land or terrain area parsed from the source description when explicitly stated. | | `total_area_sqm` | number | Total area parsed from the source description when explicitly stated. | | `registry_numbers` | array of strings | Property registry numbers found in the source description. | | `legal_case_numbers` | array of strings | Legal process numbers found in the source description. | | `detail_enrichment_status` | string | Whether full listing details were fetched successfully. | | `primary_image_url` | string | First source property image URL. | | `image_urls` | array of strings | All source property image URLs. | | `description` | string | Full source listing description when enabled. | | `auctioneer_id` | string | Source auctioneer GUID. | | `auctioneer_name` | string | Auctioneer name. | | `auctioneer_website` | string | Auctioneer website. | | `auctioneer_logo_url` | string | Auctioneer profile image URL. | | `auctioneer_owner_names` | string | Auctioneer owner names from the source. | | `auctioneer_sync_status` | string | Source synchronization status. | | `auctioneer_last_sync_at` | string | Last auctioneer synchronization timestamp. | | `auctioneer_crawl_token` | string | Source auction-house identifier useful for repeat filtering. | | `raw_source` | object | Merged listing and detail object when raw output is enabled. | ### 🧩 Example record This is a real normalized row returned during a live validation run. Source availability varies by property. ```json { "property_id": "40f48c4c-3534-45d4-b452-86d27e4ba55a", "title": "Casa - José Bonifácio/SP - Rua das Araras 496 - Casa (Lote nº 27 da Quadra F)", "property_type": "Casa", "auction_type": "alienacao-fiduciaria", "city": "José Bonifácio", "state": "SP", "neighborhood": "Loteamento Nova Iorque", "address": "Rua das Araras 496 - Casa (Lote nº 27 da Quadra F) - Loteamento Nova Iorque", "listing_url": "https://vitrinebradesco.com.br/auctions/casa-jose-bonifaciosp-rua-das-araras-496-casa-lote-n-27-da-quadra-f-11", "external_listing_url": "https://www.portalzuk.com.br/imovel/sp/jose-bonifacio/loteamento-nova-iorque/rua-das-araras-496/36956-230527?utm_source=site_bradesco&utm_medium=site_externo", "source_api_url": "https://api.vitrinebradesco.com.br/v1/auctions?page=1&type=realstate&ufs=SP", "scraped_at": "2026-08-14T15:41:42.043Z", "auction_status": "past_or_closed", "listed_price_brl": 0, "effective_price_brl": 2085483, "effective_price_basis": "final_auction_value", "first_auction_value_brl": 2353828, "second_auction_value_brl": 2085483, "final_auction_value_brl": 2085483, "discount_from_first_bid_percent": 11.4, "first_auction_date": "2026-08-12T11:00:00.000Z", "second_auction_date": "2026-08-14T11:00:00.000Z", "final_auction_date": "2026-08-14T11:00:00.000Z", "occupancy_status": "ocupado", "land_area_sqm": 700, "built_area_sqm": 406.52, "registry_numbers": ["16.789"], "detail_enrichment_status": "complete", "primary_image_url": "https://images.vitrinebradesco.com.br/zukerman_leiloes/471112/1784624794285", "auctioneer_name": "ZUK", "auctioneer_website": "https://www.zukerman.com.br/" } ``` ### 💰 Pricing Pricing uses pay per event. Each saved listing row uses the base listing event. If `includeDetails` is enabled, a separate detail-enrichment event applies only when the full detail record is fetched successfully; failed detail requests still return the base row without that add-on charge. Empty runs cost nothing, and there are no subscriptions. ### ⭐ Enjoying Bradesco Imóveis Scraper?
⭐ ⭐ ⭐ ⭐ ⭐
Found a property-auction workflow worth repeating?
A rating helps other property investors and research teams find this Actor. Your feedback also guides future improvements.
★  Rate this Actor on Apify
### ❓ FAQ #### 🔐 Does this Actor require a Vitrine Bradesco login? No. The Actor collects supported listings and full details from Vitrine Bradesco's public catalog. It has no login input. #### 🧾 What do full listing details add? When enabled, full listing details can add the address, direct auction link, source update time, and auction location. This is an optional paid enrichment event billed only for successful detail records. Descriptions, images, and auction-house fields have separate controls. #### 🎯 Which leilões de imóveis can I filter? You can filter Vitrine Bradesco real-estate listings by state, city, neighborhood, keyword, property type, auction modality, auction house, price, discount, and auction date. A saved Vitrine Bradesco search can also start the collection. #### ⚖️ How should I use the due-diligence fields? Use values, dates, occupancy statements, areas, registry numbers, legal case numbers, and source links to prioritize review. These fields appear only when provided and should support, not replace, your own due diligence. ### 🔗 Other actors - [Yandex Realty Scraper: Яндекс Недвижимость](https://apify.com/getascraper/yandex-realty-scraper) ↗ - Collect real-estate listings from Yandex Realty. - [OpenSooq Scraper](https://apify.com/getascraper/opensooq-scraper) ↗ - Extract listings from the OpenSooq marketplace. - [Etagi Real Estate Scraper: Парсер Этажи](https://apify.com/getascraper/etagi-property-scraper) ↗ - Collect property listings from Etagi. - [AuctionNinja Scraper: Estate Sales & Online Auctions](https://apify.com/getascraper/auctionninja-scraper) ↗ - Extract estate-sale and online-auction listings from AuctionNinja. # Actor input Schema ## `startUrls` (type: `array`): Optional Vitrine Bradesco auction-results URL. Use a saved search or leave this empty to build a search with the filters below. ## `states` (type: `array`): Select one or more Brazilian states. Leave empty to search across Brazil. ## `city` (type: `string`): Exact city name to include, such as São Paulo. Leave empty to include every city in the selected states. ## `neighborhood` (type: `string`): Exact neighborhood name to include, as reported by the listing. ## `searchTerm` (type: `string`): Optional text to find in the listing title, description, city, or neighborhood. ## `propertyCategory` (type: `string`): Property type such as Casa, Apartamento, Terreno, or Sítio. Leave empty to include every type. ## `auctionType` (type: `string`): Optional auction modality, such as alienação fiduciária or convencional. Leave empty for all modalities. ## `auctioneer` (type: `string`): Optional auction-house name, such as ZUK or Mega Leilões. Leave empty to include every auction house. ## `minPriceBrl` (type: `number`): Only include listings at or above this value in Brazilian reais. The actor uses the best available auction value. ## `maxPriceBrl` (type: `number`): Only include listings at or below this value in Brazilian reais. Listings without a usable value are excluded. ## `minDiscountPercent` (type: `number`): Only include listings whose final or second-stage value is at least this percentage below the first auction value. ## `auctionEndBefore` (type: `string`): Only include listings whose latest available auction-stage date is on or before this date. ## `onlyWithoutDebts` (type: `boolean`): Keep only listings that the source marks as having no debts. This indicator does not replace legal due diligence. ## `onlyWithVisitAllowed` (type: `boolean`): Keep only listings that the source marks as allowing property visits. ## `onlyWithLegalActions` (type: `boolean`): Keep only listings returned by the source legal-action filter. Review original documents before relying on this indicator. ## `proxyConfiguration` (type: `object`): Use a direct connection by default for this public catalog. Turn on Apify Proxy for repeated runs from different network locations. ## `includeDetails` (type: `boolean`): Optional paid enrichment for address, direct auction link, update time, and auction location. A separate event applies only to successful detail records. ## `includeDescription` (type: `boolean`): Include the original source description, which may contain area, registry, occupancy, and legal notes. ## `includeImages` (type: `boolean`): Include source image URLs and the primary image URL when available. ## `includeAuctioneer` (type: `boolean`): Include the auction house's name, website, logo, and available source information. ## `includeRawSource` (type: `boolean`): Keep the merged original record for advanced workflows that need fields outside the normalized listing output. ## `maxItems` (type: `integer`): Maximum number of matching listing rows to return. Set to 0 only for an intentional unlimited run within the page limit. ## `maxPages` (type: `integer`): Maximum number of source result pages to request. Each page contains up to 30 listings. Set to 0 only for an intentional unlimited run. ## `requestDelayMs` (type: `integer`): Pause between source requests in milliseconds. Keep a small pause for repeated collections. ## `maxRetries` (type: `integer`): Number of times to retry a temporary source or connection failure. ## Actor input object example ```json { "startUrls": [], "states": [], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "proxyConfiguration": { "useApifyProxy": false }, "includeDetails": false, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "startUrls": [], "states": [], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "proxyConfiguration": { "useApifyProxy": false }, "includeDetails": false, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/bradesco-imoveis-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 = { "startUrls": [], "states": [], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": False, "onlyWithVisitAllowed": False, "onlyWithLegalActions": False, "proxyConfiguration": { "useApifyProxy": False }, "includeDetails": False, "includeDescription": True, "includeImages": True, "includeAuctioneer": True, "includeRawSource": False, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3, } # Run the Actor and wait for it to finish run = client.actor("getascraper/bradesco-imoveis-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 '{ "startUrls": [], "states": [], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "proxyConfiguration": { "useApifyProxy": false }, "includeDetails": false, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3 }' | apify call getascraper/bradesco-imoveis-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/bradesco-imoveis-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/PgRbSNcqTsu37LtMZ/builds/Vsxaz4Rh6eyfJdmTg/openapi.json