{ "openapi": "3.0.1", "info": { "title": "Bradesco Imóveis: Brazil Property Auction Scraper", "description": "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.", "version": "1.2", "x-build-id": "maJPiYwxQn2GgJp1u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bradesco-imoveis-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bradesco-imoveis-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/getascraper~bradesco-imoveis-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bradesco-imoveis-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/getascraper~bradesco-imoveis-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bradesco-imoveis-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Existing Bradesco search URL", "type": "array", "description": "Optional Vitrine Bradesco auction-results URL. Use a saved search or leave this empty to build a search with the filters below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "states": { "title": "States", "type": "array", "description": "Select one or more Brazilian states. Leave empty to search across Brazil.", "items": { "type": "string", "enum": [ "AC", "AL", "AP", "AM", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RS", "RO", "RR", "SC", "SP", "SE", "TO" ], "enumTitles": [ "Acre", "Alagoas", "Amapá", "Amazonas", "Bahia", "Ceará", "Distrito Federal", "Espírito Santo", "Goiás", "Maranhão", "Mato Grosso", "Mato Grosso do Sul", "Minas Gerais", "Pará", "Paraíba", "Paraná", "Pernambuco", "Piauí", "Rio de Janeiro", "Rio Grande do Norte", "Rio Grande do Sul", "Rondônia", "Roraima", "Santa Catarina", "São Paulo", "Sergipe", "Tocantins" ] }, "default": [] }, "city": { "title": "City", "type": "string", "description": "Exact city name to include, such as São Paulo. Leave empty to include every city in the selected states.", "default": "" }, "neighborhood": { "title": "Neighborhood", "type": "string", "description": "Exact neighborhood name to include, as reported by the listing.", "default": "" }, "searchTerm": { "title": "Keyword in listing details", "type": "string", "description": "Optional text to find in the listing title, description, city, or neighborhood.", "default": "" }, "propertyCategory": { "title": "Property type", "type": "string", "description": "Property type such as Casa, Apartamento, Terreno, or Sítio. Leave empty to include every type.", "default": "" }, "auctionType": { "title": "Auction modality", "type": "string", "description": "Optional auction modality, such as alienação fiduciária or convencional. Leave empty for all modalities.", "default": "" }, "auctioneer": { "title": "Auction house", "type": "string", "description": "Optional auction-house name, such as ZUK or Mega Leilões. Leave empty to include every auction house.", "default": "" }, "minPriceBrl": { "title": "Minimum auction value", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Only include listings at or above this value in Brazilian reais. The actor uses the best available auction value." }, "maxPriceBrl": { "title": "Maximum auction value", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Only include listings at or below this value in Brazilian reais. Listings without a usable value are excluded." }, "minDiscountPercent": { "title": "Minimum discount versus first auction value", "minimum": 0, "maximum": 100, "type": "number", "description": "Only include listings whose final or second-stage value is at least this percentage below the first auction value." }, "auctionEndBefore": { "title": "Latest auction date on or before", "type": "string", "description": "Only include listings whose latest available auction-stage date is on or before this date." }, "onlyWithoutDebts": { "title": "Only listings marked as having no debts", "type": "boolean", "description": "Keep only listings that the source marks as having no debts. This indicator does not replace legal due diligence.", "default": false }, "onlyWithVisitAllowed": { "title": "Only listings where visits are allowed", "type": "boolean", "description": "Keep only listings that the source marks as allowing property visits.", "default": false }, "onlyWithLegalActions": { "title": "Only listings with legal-action information", "type": "boolean", "description": "Keep only listings returned by the source legal-action filter. Review original documents before relying on this indicator.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use a direct connection by default for this public catalog. Turn on Apify Proxy for repeated runs from different network locations.", "default": { "useApifyProxy": false } }, "includeDetails": { "title": "Fetch full listing details (paid add-on)", "type": "boolean", "description": "Optional paid enrichment for address, direct auction link, update time, and auction location. A separate event applies only to successful detail records.", "default": false }, "includeDescription": { "title": "Include full listing description", "type": "boolean", "description": "Include the original source description, which may contain area, registry, occupancy, and legal notes.", "default": true }, "includeImages": { "title": "Include property images", "type": "boolean", "description": "Include source image URLs and the primary image URL when available.", "default": true }, "includeAuctioneer": { "title": "Include auction-house details", "type": "boolean", "description": "Include the auction house's name, website, logo, and available source information.", "default": true }, "includeRawSource": { "title": "Include original source record", "type": "boolean", "description": "Keep the merged original record for advanced workflows that need fields outside the normalized listing output.", "default": false }, "maxItems": { "title": "Maximum listings", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of matching listing rows to return. Set to 0 only for an intentional unlimited run within the page limit.", "default": 10 }, "maxPages": { "title": "Maximum pages to check", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of source result pages to request. Each page contains up to 30 listings. Set to 0 only for an intentional unlimited run.", "default": 2 }, "requestDelayMs": { "title": "Pause between requests", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Pause between source requests in milliseconds. Keep a small pause for repeated collections.", "default": 150 }, "maxRetries": { "title": "Retries for temporary failures", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of times to retry a temporary source or connection failure.", "default": 3 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }