# 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:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.31 / 1,000 auction listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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 the public Vitrine Bradesco data service. Filter imóveis by UF, cidade, bairro, leiloeiro, price, discount, or auction deadline, then choose optional detail enrichment.
📍 Focus the search
Filter by UF, cidade, bairro, category, auction type, and leiloeiro. 		💸 Compare auction stages
Review first, second, and final values beside an effective price and discount. 		🧾 Enrich when needed
Choose descriptions, images, auctioneer details, and the raw source object. 		🔎 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 source 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 states, location filters, property type, auction conditions, and limits. 		STEP 2
Choose detail depth
Keep the default enrichment or select only the source details your workflow needs. 		STEP 3
Review structured rows
Use price, auction, property, and auctioneer fields to prioritize the next review.
### 🎛️ Input | Field | Type | Required | Description | | ---------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `startUrls` | array of URLs | No | Optional Vitrine Bradesco auction or public data-service listing URLs. They provide the source query, and the filters below can refine it. | | `states` | array of strings | No | Brazilian state abbreviations to include, such as `SP` or `RJ`. Leave empty to search all states. Defaults to `SP`. | | `city` | string | No | Exact city name to keep after source results are received. Use `cityId` when you know the source identifier. | | `cityId` | integer | No | Vitrine Bradesco city identifier sent to the source service. It takes priority over `city`. | | `neighborhood` | string | No | Exact bairro name to keep in the output. | | `searchTerm` | string | No | Text to match across listing title, legal description, city, and neighborhood. | | `propertyCategory` | string | No | Property category, such as Casa, Apartamento, Terreno, or Sítio. Recognized names are resolved against the source categories. | | `auctionType` | string | No | Auction modality returned by the source, such as `alienacao-fiduciaria` or `convencional`. | | `auctioneer` | string | No | Source leiloeiro token, such as `zukerman_leiloes`. | | `onlyWithoutDebts` | boolean | No | Keep only listings marked by the source as having no debts. Defaults to false. | | `onlyWithVisitAllowed` | boolean | No | Keep only listings marked by the source as allowing visits. Defaults to false. | | `onlyWithLegalActions` | boolean | No | Keep only listings returned by the source legal-actions filter. Defaults to false. | | `minPriceBrl` | number | No | Minimum effective auction value in Brazilian reais. The Actor checks final, second-stage, first-stage, then listed price. | | `maxPriceBrl` | number | No | Maximum effective auction value in Brazilian reais. Listings without a usable auction value do not pass this filter. | | `minDiscountPercent` | number | No | Minimum reduction from the first auction value to the final or second-stage value. | | `auctionEndBefore` | string | No | Keep listings whose latest available auction date is on or before this date. | | `includeDetails` | boolean | No | Fetch each listing's detail record for source-provided address, external auction URL, update time, and auction location. Defaults to true. | | `includeDescription` | boolean | No | Include the full source description, with area, registry, occupancy, and legal notes when available. Defaults to true. | | `includeImages` | boolean | No | Include source image URLs and the primary image URL when available. Defaults to true. | | `includeAuctioneer` | boolean | No | Include source auctioneer identity, website, logo, owner name, token, and synchronization details when available. Defaults to true. | | `includeRawSource` | boolean | No | Add the merged listing and detail object for workflows that need fields outside the normalized dataset. Defaults to false. | | `maxItems` | integer | No | Maximum final listing rows. Set `0` only when you intentionally want all matching listings within the selected page limit. Defaults to 10. | | `maxPages` | integer | No | Maximum source pages to request. Each page contains up to 30 source records. Set `0` only for an unlimited crawl. Defaults to 2. | | `requestDelayMs` | integer | No | Delay between source requests in milliseconds. Keep a small delay for repeated collections. Defaults to 150. | | `maxRetries` | integer | No | Number of automatic retries for temporary source or connection failures. Defaults to 3. | | `proxyConfiguration` | object | No | Optional Apify Proxy routing. Datacenter proxy is enabled by default and can be disabled for this public data service. | ### 📦 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 | Exact public source page used for this row. | | `source_type` | string | Source record type, normally `realstate`. | | `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 | Source field 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 the optional detail request completed for this listing. | | `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 auctioneer token 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 is pay per result. You pay for rows saved to your dataset. 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 requests its supported listings and detail data from the public Vitrine Bradesco data service. It has no Vitrine Bradesco login input. ##### What does optional detail enrichment add? When enabled, detail enrichment requests the source detail record for each returned listing. It can add the address, external auction URL, source update time, and auction location. Source-provided descriptions, images, and auctioneer fields have their own controls. ##### Which leilões de imóveis can I filter? You can filter Vitrine Bradesco real-estate listings by UF, city, bairro, text, property category, auction type, auctioneer, price, discount, and auction deadline. A direct Vitrine Bradesco listing URL can also seed 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 are available only when the source supplies them 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 or public API listing URLs. These URLs provide the source query, while the filters below can refine it. ## `states` (type: `array`): Brazilian state abbreviations to include, such as SP or RJ. Leave empty to search all states. ## `city` (type: `string`): Exact city name to keep after the API response is received. Use City ID when you know the source identifier. ## `cityId` (type: `integer`): Vitrine Bradesco city identifier. This takes priority over City and is sent directly to the source service. ## `neighborhood` (type: `string`): Exact neighborhood name to keep in the output. ## `searchTerm` (type: `string`): Search across listing title, legal description, city, and neighborhood. ## `propertyCategory` (type: `string`): Property category, for example Casa, Apartamento, Terreno, or Sítio. The actor resolves recognized names to the source category ID and verifies the returned name. ## `auctionType` (type: `string`): Auction modality returned by the source, such as alienacao-fiduciaria or convencional. ## `auctioneer` (type: `string`): Source auctioneer token, such as zukerman\_leiloes. Use the auctioneer directory to discover current tokens. ## `onlyWithoutDebts` (type: `boolean`): Keep only listings marked by the source as having no debts. ## `onlyWithVisitAllowed` (type: `boolean`): Keep only listings marked by the source as allowing visits. ## `onlyWithLegalActions` (type: `boolean`): Keep only listings returned by the source legal-actions filter. ## `minPriceBrl` (type: `number`): Minimum effective auction value in Brazilian reais. The actor checks final value, second-stage value, first-stage value, then listed price. ## `maxPriceBrl` (type: `number`): Maximum effective auction value in Brazilian reais. Listings without a usable auction value do not pass a numeric price filter. ## `minDiscountPercent` (type: `number`): Minimum percentage reduction from the first auction value to the final or second-stage value. ## `auctionEndBefore` (type: `string`): Keep listings whose latest available auction date is on or before this date. ## `includeDetails` (type: `boolean`): Fetch the source detail record for each returned listing to add the external auction URL, address, update time, and online location. ## `includeDescription` (type: `boolean`): Include the full source description, including area, registry, occupancy, and legal notes when provided. ## `includeImages` (type: `boolean`): Include all source image URLs and the primary image URL. ## `includeAuctioneer` (type: `boolean`): Include auctioneer identity, website, logo, owner name, crawl token, and synchronization status. ## `includeRawSource` (type: `boolean`): Add the merged source and detail object for pipelines that need fields beyond the normalized dataset contract. ## `maxItems` (type: `integer`): Maximum final listing rows. Set to 0 only when you intentionally want all matching listings within the selected page limit. ## `maxPages` (type: `integer`): Maximum listing pages to request. Each page contains up to 30 source records. Set to 0 only for an explicit unlimited crawl. ## `requestDelayMs` (type: `integer`): Delay between API page and detail requests in milliseconds. The public service exposes a finite request rate, so keep a small delay for repeated runs. ## `maxRetries` (type: `integer`): Number of automatic retries for temporary API or connection failures. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy routing. Datacenter proxy is enabled by default and can be disabled for this public API. ## Actor input object example ```json { "startUrls": [], "states": [ "SP" ], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "includeDetails": true, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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": [ "SP" ], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "includeDetails": true, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3, "proxyConfiguration": { "useApifyProxy": true } }; // 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": ["SP"], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": False, "onlyWithVisitAllowed": False, "onlyWithLegalActions": False, "includeDetails": True, "includeDescription": True, "includeImages": True, "includeAuctioneer": True, "includeRawSource": False, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3, "proxyConfiguration": { "useApifyProxy": True }, } # 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": [ "SP" ], "city": "", "neighborhood": "", "searchTerm": "", "propertyCategory": "", "auctionType": "", "auctioneer": "", "onlyWithoutDebts": false, "onlyWithVisitAllowed": false, "onlyWithLegalActions": false, "includeDetails": true, "includeDescription": true, "includeImages": true, "includeAuctioneer": true, "includeRawSource": false, "maxItems": 10, "maxPages": 2, "requestDelayMs": 150, "maxRetries": 3, "proxyConfiguration": { "useApifyProxy": true } }' | 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/i0B9ng6PvKudpJ5hH/openapi.json