{ "openapi": "3.0.1", "info": { "title": "Leilao Imovel Scraper | $1.5 / 1k | Fast & Reliable", "description": "Extract structured real estate auction listings across Brazil with property details, images, seller data and full descriptions from Leilão Imóvel. Built for enterprise-grade real estate intelligence, opportunity screening, portfolio monitoring, and automated data pipelines.", "version": "0.0", "x-build-id": "2wO7jUdNPtW1MSBkc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~leilao-imovel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-leilao-imovel-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/fatihtahta~leilao-imovel-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-leilao-imovel-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/fatihtahta~leilao-imovel-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-leilao-imovel-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": { "location_state": { "title": "Choose a State (Optional)", "type": "string", "description": "Enter a Brazilian state name or abbreviation, such as SP, RJ, or Minas Gerais. Use this to focus the collection on listings in one state." }, "location_city": { "title": "Choose a City (Optional)", "type": "string", "description": "Enter a Brazilian city name to focus results on that municipality. For the most precise setup, combine it with the matching state." }, "min_price": { "title": "Set Minimum Price", "minimum": 1, "type": "integer", "description": "Enter the lowest property price to include, in Brazilian reais. Leave empty if you do not want a minimum price filter." }, "max_price": { "title": "Set Maximum Price", "minimum": 1, "type": "integer", "description": "Enter the highest property price to include, in Brazilian reais. Leave empty if higher-priced listings should remain eligible." }, "property_type": { "title": "Choose Property Types", "uniqueItems": true, "type": "array", "description": "Select one or more property types to include, such as apartments, houses, warehouses, land, or commercial properties. Leave empty to include all supported property types.", "items": { "type": "string", "enum": [ "Agency", "Apartment", "Industrial Land", "Rural Land", "House", "Commercial Property", "Warehouse", "Parking Space", "Unspecified", "Other", "Land / Plot" ], "enumTitles": [ "Agency | Agência", "Apartment | Apartamento", "Industrial Land | Área Industrial", "Rural Land | Área Rural", "House | Casa", "Commercial Property | Comercial", "Warehouse | Galpão", "Parking Space | Garagem", "Unspecified | Não Identificado", "Other | Outros", "Land / Plot | Terreno" ] } }, "min_discount": { "title": "Set Minimum Discount", "enum": [ "0", "5", "10", "15", "20", "25", "30", "35", "40", "45", "50", "55", "60", "65", "70", "75", "80", "85", "90", "95", "100" ], "type": "string", "description": "Choose the lowest discount percentage to include. Leave empty when you do not want to require a minimum discount." }, "max_discount": { "title": "Set Maximum Discount", "enum": [ "0", "5", "10", "15", "20", "25", "30", "35", "40", "45", "50", "55", "60", "65", "70", "75", "80", "85", "90", "95", "100" ], "type": "string", "description": "Choose the highest discount percentage to include. Leave empty if listings with any higher discount should remain eligible." }, "financement_method": { "title": "Choose Financing Methods", "uniqueItems": true, "type": "array", "description": "Select the payment methods that listings must support. Choose multiple options when either financing path is acceptable.", "items": { "type": "string", "enum": [ "FGTS (Severance Fund)", "Financing" ], "enumTitles": [ "FGTS (Severance Fund) | FGTS", "Financing | Financiamento" ] } }, "sale_type": { "title": "Choose Sale Types", "uniqueItems": true, "type": "array", "description": "Select one or more sale types to include, such as direct purchase, online sale, open bidding, or SFI auction.", "items": { "type": "string", "enum": [ "Direct Purchase", "Online Sale", "Open Bidding (Caixa)", "SFI Auction (Caixa)" ], "enumTitles": [ "Direct Purchase | Compra Direta", "Online Sale | Venda Online", "Open Bidding (Caixa) | Licitação Aberta Caixa", "SFI Auction (Caixa) | Leilão SFI Caixa" ] } }, "condo_debt": { "title": "Choose Condo Debt Rules", "uniqueItems": true, "type": "array", "description": "Select the condo debt conditions you want listings to match. Leave empty if condo debt handling should not narrow the collection.", "items": { "type": "string", "enum": [ "Buyer Pays Condo Debt", "Buyer Pays up to 10% of Appraised Value" ], "enumTitles": [ "Buyer Pays Condo Debt | Arrematante Paga", "Buyer Pays up to 10% of Appraised Value | Arrematante paga até 10% da avaliação" ] } }, "sale_modality": { "title": "Choose Sale Modalities", "uniqueItems": true, "type": "array", "description": "Select the sale modalities to include, such as judicial auction, extrajudicial auction, private sale, or direct sale.", "items": { "type": "string", "enum": [ "PGFN Acquisition", "Extrajudicial Auction", "Judicial Auction", "Other", "Private Sale", "Direct Sale" ], "enumTitles": [ "PGFN Acquisition | Comprei PGFN", "Extrajudicial Auction | Extrajudicial", "Judicial Auction | Judicial", "Other | Outro", "Private Sale | Particular", "Direct Sale | Venda Direta" ] } }, "auction_end_before": { "title": "Set Latest Auction End Date", "type": "string", "description": "Choose the latest auction end date to include. Use this when you only want listings ending on or before a specific date." }, "listing_date_from": { "title": "Set Earliest Listing Date", "type": "string", "description": "Choose the earliest listing inclusion date to include. Use this to focus on listings added on or after a specific date." }, "banks": { "title": "Choose Banks", "uniqueItems": true, "type": "array", "description": "Select one or more banks to include in the results. Selecting several banks broadens coverage while still keeping the run institution-focused.", "items": { "type": "string", "enum": [ "Caixa Econômica Federal CEF", "Banco do Brasil", "Banco BRB", "Banco Inter", "Banco Santander", "Bradesco", "Emgea", "Fundação Assefaz", "Itaú Unibanco" ] } }, "limit": { "title": "Set Maximum Results per Input", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save for this run configuration. Leave empty to collect as many matching listings as are available during the run." }, "enrich_data": { "title": "Enrich Data", "type": "boolean", "description": "Fetch each listing detail page to add detail-only fields. Disable this for faster runs that save only fields available on search result pages.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }