# Leilão Imóvel Scraper - Brazil Property Auctions (`solidcode/leilaoimovel-scraper`) Actor \[💰 $2.5 / 1K] Extract Brazilian real-estate auction listings from leilaoimovel.com.br — price, appraisal value, discount %, modalities, closing date, location, and URL. Filter by state, city, property type, bank, sale type, payment, discount, and price, or paste search URLs. - **URL**: https://apify.com/solidcode/leilaoimovel-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Leilão Imóvel Scraper Pull Brazilian real-estate auction listings from leilaoimovel.com.br at scale — minimum bid, appraisal value, discount percentage, selling bank, auction modalities, closing date, photo, and location for every property up for auction across all 27 states. Built for property investors, auction hunters, and real-estate analysts who need fresh below-market opportunities without checking dozens of bank auction pages by hand. ### Why This Scraper? - **47,000+ live auction listings across all 27 Brazilian states** — every UF from São Paulo and Rio de Janeiro to Minas Gerais and Bahia, searchable from one input. - **Discount-off-appraisal filter** — surface only properties priced 20%, 40%, or 50%+ below their official appraisal value (avaliação), so deeply discounted repossessions float to the top. - **Appraisal value and discount % on every single row** — each listing carries both the minimum bid and the original assessed value, so the savings are calculated for you, not buried. - **10 named selling institutions** — filter by Caixa Econômica Federal, Banco do Brasil, Bradesco, Itaú Unibanco, Santander, Banco Inter, Banco BRB, Emgea, Fundação Assefaz, or Reverts. - **11 property types** — apartments, houses, land lots, rural areas, commercial units, garages, warehouses, industrial areas, and bank branches. - **FGTS and financiamento payment filters** — narrow to auctions that accept FGTS withdrawals or bank financing, the two payment routes most retail buyers depend on. - **11 auction sale types** — judicial, extrajudicial, online sale, direct sale, public bidding, Caixa SFI auction, and more, each as a guided dropdown. - **Opt-in deep details** — pull the auctioneer (leiloeiro), official auction-notice PDF (edital), built area in m², registry number (matrícula), county (comarca), and 1st/2nd auction round dates straight from each listing's own page. ### Use Cases **Auction Investing** - Find properties 40%+ below appraisal across an entire state in one run - Track Caixa Econômica Federal repossessions accepting FGTS payment - Compare minimum bid against appraisal value to rank the best deals - Pull the official edital PDF for every shortlisted listing before bidding **Market Research** - Map auction inventory and discount levels by state, city, and property type - Benchmark how different banks price their distressed real estate - Measure average discount-off-appraisal by region or property category - Spot supply trends in judicial vs. extrajudicial auction volume **Lead Generation for Realtors** - Build target lists of below-market properties for buyer clients - Surface commercial units and land lots in a specific city for developers - Identify newly added listings to act before the wider market sees them **Portfolio & Deal Monitoring** - Watch closing dates so no auction window is missed - Re-run a saved filter daily to catch fresh discounted listings - Feed discount and appraisal data into your own underwriting models ### Getting Started #### Search a State The simplest run — every auction listing in São Paulo: ```json { "state": "sp", "maxResults": 50 } ```` #### Discounted Caixa Repossessions Houses sold by Caixa Econômica Federal, at least 40% below appraisal, accepting FGTS: ```json { "state": "rj", "propertyType": "casa", "bank": "caixa", "paymentMethod": ["fgts"], "minDiscount": 40, "sortBy": "discount_d", "maxResults": 200 } ``` #### Full-Featured Example Apartments in a price band, deeply discounted, with full per-listing enrichment: ```json { "state": "mg", "city": "Belo Horizonte", "propertyType": "apartamento", "bank": "any", "saleType": ["venda-online", "judicial"], "minDiscount": 30, "priceMin": 100000, "priceMax": 500000, "sortBy": "price_a", "includeDetails": true, "maxResults": 300 } ``` #### Using leilaoimovel.com.br URLs Paste any search or individual listing URL straight from your browser: ```json { "startUrls": [ "https://www.leilaoimovel.com.br/leilao-de-imoveis/sp", "https://www.leilaoimovel.com.br/encontre-seu-imovel?banco=1&desconto_min=50" ], "maxResults": 100 } ``` ### Input Reference #### Search | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `state` | select | `any` | Brazilian state (UF) to search. Choose "Any" to cover the whole country. One of all 27 states. | | `city` | string | — | City to filter by (e.g. "São Paulo"). Leave empty to search the whole state. | | `propertyType` | select | `any` | Property category — House, Apartment, Land / Lot, Rural Area, Commercial, Garage, Warehouse, Industrial, Bank Branch, or Other. | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `bank` | select | `any` | Selling institution — Caixa, Banco do Brasil, Bradesco, Itaú, Santander, Banco Inter, Banco BRB, Emgea, Assefaz, or Reverts. | | `saleType` | select\[] | `[]` | One or more auction sale types — Judicial, Extrajudicial, Online Sale, Direct Sale, Public Bidding, Caixa SFI Auction, and more. Empty = all. | | `paymentMethod` | select\[] | `[]` | Keep only listings accepting Financing or FGTS. Empty = all. | | `minDiscount` | integer | `0` | Only listings discounted at least this much below appraisal. 0 = no minimum. | | `priceMin` | integer | — | Minimum bid floor in Brazilian Reais. Leave empty for no minimum. | | `priceMax` | integer | — | Minimum bid ceiling in Brazilian Reais. Leave empty for no maximum. | | `sortBy` | select | `default_order` | Order results — Price, Discount, Newest Added, or Ending Soonest (low-to-high and high-to-low variants). | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `includeDetails` | boolean | `false` | Enrich each listing with auctioneer, edital PDF link, area in m², matrícula, comarca, and auction round dates from its own page. Slower but much richer. | | `startUrls` | string\[] | `[]` | Paste exact leilaoimovel.com.br search or listing URLs. Overrides the guided fields above. | | `maxResults` | integer | `100` | Maximum listings to collect. Set 0 for unlimited. The final page may overshoot the cap by a few records. | ### Output Each row is one auction listing. Here's a representative result with `includeDetails` enabled: ```json { "id": "123456", "title": "Apartamento em São Paulo, SP", "address": "Rua das Flores, 250 - Centro, São Paulo - SP, 01001-000", "city": "São Paulo", "state": "São Paulo", "propertyType": "Apartment", "bank": "Caixa Econômica Federal (CEF)", "modalities": ["Venda Online", "FGTS", "Financiamento"], "price": 187500.00, "appraisal": 312000.00, "discount": 40, "discountText": "40% de desconto", "closingDate": "2026-07-15 14:00", "auctioneer": "Leiloeiro Oficial João Pereira", "editalUrl": "https://www.leilaoimovel.com.br/edital/123456.pdf", "area": 72.5, "matricula": "45.123", "comarca": "São Paulo", "praca1": "2026-07-08 14:00", "praca2": "2026-07-15 14:00", "image": "https://www.leilaoimovel.com.br/img/imovel/123456.jpg", "url": "https://www.leilaoimovel.com.br/imovel/sp/sao-paulo/apartamento-123456", "scrapedAt": "2026-06-26T14:30:00+00:00" } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `id` | string | Unique listing identifier | | `title` | string | Property designation (type + location) | | `propertyType` | string | Property category (Apartment, House, Land / Lot, etc.) | | `bank` | string | Selling bank or institution | | `modalities` | string\[] | Auction modes (Venda Online, FGTS, Financiamento, etc.) | | `closingDate` | string | Auction end date and time | | `image` | string | Property photo URL | | `url` | string | Direct link to the listing page | | `scrapedAt` | string | ISO 8601 timestamp of data extraction | #### Pricing & Discount | Field | Type | Description | |-------|------|-------------| | `price` | number | Minimum bid in Brazilian Reais (R$) | | `appraisal` | number | Official appraisal / assessed value in R$ | | `discount` | number | Discount off appraisal, as a percentage | | `discountText` | string | Formatted discount label as shown on the site | #### Location | Field | Type | Description | |-------|------|-------------| | `address` | string | Full street address, neighborhood, and postal code | | `city` | string | City | | `state` | string | State (full name) | #### Detail Enrichment Populated when `includeDetails` is on. | Field | Type | Description | |-------|------|-------------| | `auctioneer` | string | Auctioneer (leiloeiro) handling the sale | | `editalUrl` | string | Link to the official auction-notice PDF (edital) | | `area` | number | Built or lot area in square meters | | `matricula` | string | Property registry number (matrícula) | | `comarca` | string | Judicial district / county (comarca) | | `praca1` | string | First auction round date and time | | `praca2` | string | Second auction round date and time | ### Tips for Best Results - **Start small** — set `maxResults` to 25–50 on your first run to confirm the data fits your needs, then scale up. - **Set `minDiscount` to 40+ to surface the deepest deals** — banks list plenty of properties near appraisal; raising the floor strips those out so only the steep discounts remain. - **Sort by `discount_d` for the best opportunities first** — combined with a `minDiscount` floor, the top of your dataset is the most below-market inventory available. - **Enable `includeDetails` before bidding** — it captures the official edital PDF link and the 1st/2nd auction round dates, the documents and deadlines you need before committing. - **Filter `paymentMethod` to `fgts` if you plan to use your FGTS balance** — only a subset of auctions accept it, and this narrows straight to those. - **Leave `city` empty for the widest net** — a state search returns everything; add a city only when you need to focus, since rare cities scan more pages to fill. - **Re-run a saved filter on a schedule** — auction inventory turns over fast, so a daily run catches fresh listings before closing dates pass. ### Pricing **From $2.50 per 1,000 results** — undercuts the going rate for Brazilian auction data while bundling appraisal value and discount calculation into every row. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.30 | $0.28 | $0.27 | $0.25 | | 1,000 | $3.00 | $2.80 | $2.65 | $2.50 | | 10,000 | $30.00 | $28.00 | $26.50 | $25.00 | | 100,000 | $300.00 | $280.00 | $265.00 | $250.00 | A "result" is any auction listing row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate real-estate research, auction analysis, and lead generation. Users are responsible for complying with applicable laws and leilaoimovel.com.br's Terms of Service. Do not use extracted data for spam, harassment, or any illegal purpose. Always confirm auction terms, deadlines, and property details against the official edital before participating in any auction. # Actor input Schema ## `state` (type: `string`): Brazilian state (UF) to search. Choose 'Any' to cover the whole country. Ignored when Start URLs are provided. ## `city` (type: `string`): City to filter by (e.g. 'São Paulo' or 'Rio de Janeiro'). Matched against each listing's city after collection, so results are limited to that city. For a very rare city with few listings, the search may stop after scanning many pages without finding more. Leave empty to search the whole state. Ignored when Start URLs are provided. ## `propertyType` (type: `string`): Filter by property category. Choose 'Any' to include all types. ## `bank` (type: `string`): Filter by the selling bank or institution. Choose 'Any' to include all sellers. ## `saleType` (type: `array`): Only include listings offered under these sale types (auction modes). Leave empty to include all sale types. ## `paymentMethod` (type: `array`): Only include listings that accept these payment methods. Leave empty to include all. ## `minDiscount` (type: `integer`): Only include listings discounted at least this much below the appraisal value. 0 = no minimum. ## `priceMin` (type: `integer`): Only include listings with a minimum bid at or above this amount in Brazilian Reais. Leave empty for no minimum. ## `priceMax` (type: `integer`): Only include listings with a minimum bid at or below this amount in Brazilian Reais. Leave empty for no maximum. ## `sortBy` (type: `string`): Order in which listings are collected. 'Default' uses the site's standard order. ## `includeDetails` (type: `boolean`): When enabled, each listing is enriched with extra fields from its own page — auctioneer, official notice (edital) PDF link, area in m², registration number (matrícula), county (comarca), and 1st/2nd auction round dates. This opens one extra page per listing, so runs take noticeably longer. Leave OFF (default) for the fastest, cheapest runs — the core fields (price, appraisal, discount, location, photo, modalities, closing date) are always collected either way. ## `startUrls` (type: `array`): Power-user input. Paste exact leilaoimovel.com.br search-result URLs or individual listing URLs. When provided, these override the State / City / Property Type / Filters settings above. ## `maxResults` (type: `integer`): Maximum number of listings to collect across all searches and URLs. Set 0 for unlimited (up to 100,000 per run). Results are collected in full pages, so the final page may overshoot this cap by a few records. ## Actor input object example ```json { "state": "any", "propertyType": "any", "bank": "any", "saleType": [], "paymentMethod": [], "minDiscount": 0, "sortBy": "default_order", "includeDetails": false, "startUrls": [], "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of auction listings with the most useful fields. # 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 = { "state": "any", "city": "", "propertyType": "any", "bank": "any", "saleType": [], "paymentMethod": [], "minDiscount": 0, "sortBy": "default_order", "includeDetails": false, "startUrls": [], "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/leilaoimovel-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 = { "state": "any", "city": "", "propertyType": "any", "bank": "any", "saleType": [], "paymentMethod": [], "minDiscount": 0, "sortBy": "default_order", "includeDetails": False, "startUrls": [], "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/leilaoimovel-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "state": "any", "city": "", "propertyType": "any", "bank": "any", "saleType": [], "paymentMethod": [], "minDiscount": 0, "sortBy": "default_order", "includeDetails": false, "startUrls": [], "maxResults": 100 }' | apify call solidcode/leilaoimovel-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/leilaoimovel-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Leilão Imóvel Scraper - Brazil Property Auctions", "description": "[💰 $2.5 / 1K] Extract Brazilian real-estate auction listings from leilaoimovel.com.br — price, appraisal value, discount %, modalities, closing date, location, and URL. Filter by state, city, property type, bank, sale type, payment, discount, and price, or paste search URLs.", "version": "1.0", "x-build-id": "1uD1biuYK484NL1RP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~leilaoimovel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-leilaoimovel-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/solidcode~leilaoimovel-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-leilaoimovel-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/solidcode~leilaoimovel-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-leilaoimovel-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": { "state": { "title": "State", "enum": [ "any", "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" ], "type": "string", "description": "Brazilian state (UF) to search. Choose 'Any' to cover the whole country. Ignored when Start URLs are provided.", "default": "any" }, "city": { "title": "City", "type": "string", "description": "City to filter by (e.g. 'São Paulo' or 'Rio de Janeiro'). Matched against each listing's city after collection, so results are limited to that city. For a very rare city with few listings, the search may stop after scanning many pages without finding more. Leave empty to search the whole state. Ignored when Start URLs are provided." }, "propertyType": { "title": "Property Type", "enum": [ "any", "casa", "apartamento", "terreno", "area-rural", "comercial", "garagem", "area-industrial", "galpao", "agencia", "outros" ], "type": "string", "description": "Filter by property category. Choose 'Any' to include all types.", "default": "any" }, "bank": { "title": "Bank / Institution", "enum": [ "any", "caixa", "banco-do-brasil", "banco-inter", "banco-brb", "santander", "emgea", "itau", "bradesco", "assefaz", "reverts" ], "type": "string", "description": "Filter by the selling bank or institution. Choose 'Any' to include all sellers.", "default": "any" }, "saleType": { "title": "Sale Type", "uniqueItems": true, "type": "array", "description": "Only include listings offered under these sale types (auction modes). Leave empty to include all sale types.", "items": { "type": "string", "enum": [ "compra-direta", "judicial", "extrajudicial", "particular", "venda-online", "venda-direta", "licitacao-publica", "licitacao-aberta-caixa", "leilao-sfi-caixa", "comprei-pgfn", "outro" ], "enumTitles": [ "Direct Purchase", "Judicial", "Extrajudicial", "Private", "Online Sale", "Direct Sale", "Public Bidding", "Caixa Open Bidding", "Caixa SFI Auction", "PGFN Purchase", "Other" ] }, "default": [] }, "paymentMethod": { "title": "Payment Method", "uniqueItems": true, "type": "array", "description": "Only include listings that accept these payment methods. Leave empty to include all.", "items": { "type": "string", "enum": [ "financiamento", "fgts" ], "enumTitles": [ "Financing Accepted", "FGTS Accepted" ] }, "default": [] }, "minDiscount": { "title": "Minimum Discount (%)", "minimum": 0, "maximum": 99, "type": "integer", "description": "Only include listings discounted at least this much below the appraisal value. 0 = no minimum.", "default": 0 }, "priceMin": { "title": "Minimum Price (R$)", "minimum": 0, "type": "integer", "description": "Only include listings with a minimum bid at or above this amount in Brazilian Reais. Leave empty for no minimum." }, "priceMax": { "title": "Maximum Price (R$)", "minimum": 0, "type": "integer", "description": "Only include listings with a minimum bid at or below this amount in Brazilian Reais. Leave empty for no maximum." }, "sortBy": { "title": "Sort By", "enum": [ "default_order", "price_a", "price_d", "discount_a", "discount_d", "dt_insert_d", "dt_insert_a", "dt_auction_a", "dt_auction_d" ], "type": "string", "description": "Order in which listings are collected. 'Default' uses the site's standard order.", "default": "default_order" }, "includeDetails": { "title": "Include Full Details (slower)", "type": "boolean", "description": "When enabled, each listing is enriched with extra fields from its own page — auctioneer, official notice (edital) PDF link, area in m², registration number (matrícula), county (comarca), and 1st/2nd auction round dates. This opens one extra page per listing, so runs take noticeably longer. Leave OFF (default) for the fastest, cheapest runs — the core fields (price, appraisal, discount, location, photo, modalities, closing date) are always collected either way.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Power-user input. Paste exact leilaoimovel.com.br search-result URLs or individual listing URLs. When provided, these override the State / City / Property Type / Filters settings above.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to collect across all searches and URLs. Set 0 for unlimited (up to 100,000 per run). Results are collected in full pages, so the final page may overshoot this cap by a few records.", "default": 100 } } }, "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 } } } } } } } } } } ```