# HUD Home Store Scraper (`solidcode/hudhomestore-scraper`) Actor \[💰 $2.5 / 1K] Extract HUD foreclosed home listings nationwide — addresses, prices, beds/baths, case numbers, bid dates, FHA financing, and photos. Search by state, city, ZIP, or URL with price, bedroom, type, and status filters. - **URL**: https://apify.com/solidcode/hudhomestore-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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 ## HUD Home Store Scraper Pull government-owned foreclosed home listings from HUD Home Store at scale — case numbers, full addresses, list prices, beds and baths, FHA insurability, bid-opening dates, and up to 46 photos per home across all 50 US states. Built for real estate investors, buyer's agents, and FHA owner-occupant buyers who need a clean, structured feed of HUD foreclosures without checking the .gov portal one state at a time. ### Why This Scraper? - **All 50 US states plus DC and three territories** — 54 HUD jurisdictions (including Puerto Rico, the US Virgin Islands, and Guam) selectable from a full-name multi-select, no abbreviations to memorize. - **FHA insurability on every home** — each listing is tagged Insured, Insured with Escrow, or Uninsured, so you instantly know whether a property qualifies for an FHA loan as-is or needs repairs first. - **HUD case number as a stable primary key** — the official case number (e.g. `495-893204`) lands on every row, ready to join against bid systems, broker portals, and your own CRM. - **Three live bid dates per home** — list date, bid-open date, and period deadline, all normalized to ISO 8601 (`YYYY-MM-DD`) so you never miss an offer window. - **`$100 Down` program flag** — a dedicated `program100Down` boolean surfaces homes eligible for HUD's $100-down FHA financing, the single most-asked-about HUD incentive. - **Up to 46 photos per listing** — the full Cloudinary photo gallery plus a primary thumbnail, ready for slide decks, valuations, and listing sites. - **Six client-side filters that scope the whole result set** — price min/max, bedrooms min/max, bathrooms min, three property types, listing highlight, and FHA financing type, all applied across every search. - **Indoor and outdoor amenities, parking, stories, and eligible bidder categories** — the detail HUD shows buyers (Investor, Owner Occupant, Nonprofit, Government Agency) captured as clean arrays on each home. ### Use Cases **Real Estate Investment** - Hunt below-market HUD foreclosures across multiple states in a single run - Filter to Uninsured homes for fix-and-flip and BRRRR pipelines - Track price-reduced listings to time low-ball offers - Map inventory by latitude/longitude for drive-by and territory planning **Buyer's Agents & Brokerages** - Build HUD-home buyer lists for owner-occupant clients - Surface `$100 Down`-eligible homes for first-time-buyer leads - Monitor new listings the day they post by listing date - Match clients to homes by bedrooms, bathrooms, and property type **FHA Owner-Occupant Buyers** - Find Insured homes that qualify for an FHA loan with no extra repairs - Compare Insured-with-Escrow homes where repair funds are set aside - Track bid-open dates so you submit during the owner-occupant priority window **Market Research** - Measure government foreclosed-housing inventory by state and county - Analyze price per square foot across HUD listings by ZIP - Track manufactured vs. single-family vs. condo HUD supply over time - Feed structured HUD data into dashboards and lead-gen systems ### Getting Started #### Search by State The simplest start — pick one or more states: ```json { "states": ["TX"], "maxResults": 100 } ```` #### Search a City with Filters ```json { "searchTerms": ["Houston, TX", "San Antonio, TX"], "priceMin": 50000, "priceMax": 250000, "bedroomsMin": 3, "propertyTypes": ["single_family"], "maxResults": 200 } ``` #### Advanced — FHA & Listing Highlight Across Multiple States ```json { "states": ["FL", "GA", "NC"], "searchTerms": ["Memphis, TN"], "priceMax": 180000, "bedroomsMin": 2, "bathroomsMin": 1.5, "propertyTypes": ["single_family", "manufactured"], "propertyStatus": "price_reduced", "fhaFinancing": "IN", "maxResults": 500 } ``` ### Input Reference #### What to Search At least one of these is needed. | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `states` | array (select) | `["TX"]` | US states to search for HUD homes. Pick one or more. Leave empty if you are searching by city/ZIP terms or pasting listing URLs instead. | | `searchTerms` | array (string) | `[]` | Search terms such as a city with its state ("Houston, TX"). Each term is searched on its own. For best results use the "City, ST" format — a bare ZIP code on its own often returns no homes, so pair it with a city and state. | | `startUrls` | array (string) | `[]` | Paste HUD Home Store listing or search-result URLs to scrape them directly. Use this if you already have specific pages in mind. | #### Filters Narrow results before they are collected so you do not pay for homes you do not want. Leave a filter empty to ignore it. | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `priceMin` | integer | *(none)* | Only return homes listed at or above this price. Leave empty for no minimum. | | `priceMax` | integer | *(none)* | Only return homes listed at or below this price. Leave empty for no maximum. | | `bedroomsMin` | integer | *(none)* | Only return homes with at least this many bedrooms. Leave empty for any. | | `bedroomsMax` | integer | *(none)* | Only return homes with at most this many bedrooms. Leave empty for any. | | `bathroomsMin` | number | *(none)* | Only return homes with at least this many bathrooms. Half-baths are allowed (e.g. 1.5). Leave empty for any. | | `propertyTypes` | array (select) | `[]` | Only return these kinds of homes: Single Family Home, Condominium, or Manufactured Home. Leave empty to include all property types. | | `propertyStatus` | select | *(none)* | Only return homes with a specific listing highlight: New Listing, Price Reduced, or Vacant Lot Commission. Leave empty for all listings. | | `fhaFinancing` | select | *(none)* | Filter by FHA insurability: FHA Insured, FHA Insured with Escrow, or FHA Uninsured. Insured homes qualify for an FHA loan as-is, Insured with Escrow set aside repair funds, and Uninsured homes need repairs before financing. Leave empty for all. | #### Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `100` | Maximum number of homes to return across all searches. Collection stops once this number is reached, so the final page may slightly overshoot the limit. Set to 0 for no limit. | ### Output Each HUD home is one flat row in the dataset. Here is a representative result: ```json { "caseNumber": "495-893204", "url": "https://www.hudhomestore.gov/propertydetails?caseNumber=495-893204", "price": 510720, "address": "25 W Skyview Dr", "city": "Del Rio", "state": "TX", "zip": "78840", "county": "Val Verde", "latitude": 29.3981, "longitude": -100.94, "bedrooms": 6, "bathrooms": 4.2, "squareFootage": 7804, "yearBuilt": 2005, "propertyType": "Single Family Home", "numberOfStories": 1.1, "parkingType": "Carport", "listingStatus": "Price Reduced", "fhaFinancing": "IE (Insured Escrow)", "program100Down": true, "listDate": "2026-05-05", "bidOpenDate": "2026-06-02", "bidDeadlineDate": "2026-08-12", "listingPeriod": "Extended", "eligibleBidders": ["Investor", "Owner Occupant", "Nonprofit", "Government Agency"], "eligibleBiddersLabel": "All Bidders", "indoorAmenities": ["Fireplace"], "outdoorAmenities": ["Patio/Deck", "Porch", "Fence"], "imageUrl": "https://res.cloudinary.com/yardi/.../hhs/Front_x.png", "imageUrls": [ "https://res.cloudinary.com/yardi/.../hhs/Front_x.png", "https://res.cloudinary.com/yardi/.../hhs/Back_y.png" ] } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `caseNumber` | string | HUD case number — the official identifier and primary key for each home | | `url` | string | Direct HUD Home Store detail-page URL | | `price` | number | List price in USD | | `propertyType` | string | Single Family Home, Condo, or Manufactured Home | | `listingStatus` | string | Listing highlight, e.g. New Listing or Price Reduced | #### Address & Location | Field | Type | Description | |-------|------|-------------| | `address` | string | Street address | | `city` | string | City | | `state` | string | Two-letter state code | | `zip` | string | ZIP code | | `county` | string | County name | | `latitude` | number | Latitude | | `longitude` | number | Longitude | #### Pricing & Financing | Field | Type | Description | |-------|------|-------------| | `fhaFinancing` | string | FHA insurability: Insured, Insured Escrow, or Uninsured | | `program100Down` | boolean | Eligible for HUD's `$100 Down` FHA program | | `listDate` | string | Date the home was listed (ISO 8601) | | `bidOpenDate` | string | Date bidding opens (ISO 8601) | | `bidDeadlineDate` | string | Bid / period deadline (ISO 8601) | | `listingPeriod` | string | Offer period label, e.g. Extended or Exclusive | | `eligibleBidders` | array | Bidder categories allowed, e.g. Investor, Owner Occupant | | `eligibleBiddersLabel` | string | Human-readable eligible-bidder summary | #### Property Details | Field | Type | Description | |-------|------|-------------| | `bedrooms` | integer | Number of bedrooms | | `bathrooms` | number | Number of bathrooms (half-baths allowed) | | `squareFootage` | integer | Living area in square feet | | `yearBuilt` | integer | Year the home was built | | `numberOfStories` | number | Number of stories | | `parkingType` | string | Parking or garage type | | `indoorAmenities` | array | Indoor features, e.g. Fireplace | | `outdoorAmenities` | array | Outdoor features, e.g. Patio/Deck, Porch, Fence | #### Media | Field | Type | Description | |-------|------|-------------| | `imageUrl` | string | Primary photo URL | | `imageUrls` | array | All photo URLs for the listing (up to ~46 per home) | ### Tips for Best Results - **Use "City, ST", never a bare ZIP** — a ZIP code on its own (e.g. `78840`) often returns no homes on HUD's search. Pair it with a city and state, like `"Del Rio, TX"`, to get results every time. - **Start with one state and a small `maxResults`** — run 50–100 first to confirm the data fits your needs, then scale up to multiple states. - **Filter on FHA financing to match your strategy** — choose FHA Insured for owner-occupant buyers who want move-in-ready financing, or FHA Uninsured for investors targeting repair-and-resell deals. - **Combine state and city searches in one run** — list several states in `states` and add specific cities in `searchTerms` to widen or pinpoint coverage at the same time. - **Watch `bidOpenDate` for owner-occupant windows** — HUD gives owner-occupants priority before investors; sort by bid-open date to plan submissions inside that window. - **Use `propertyStatus: "price_reduced"`** to surface motivated sellers — price-reduced HUD homes signal listings that have been on the market and may take a lower offer. - **Dedupe is automatic** — overlapping state and city searches that return the same home are merged on case number, so you never pay for a duplicate row. ### Pricing **From $2.50 per 1,000 results** — about 17% below the typical HUD-home scraper rate. No compute charges — you only pay per result returned. | 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 one HUD home row in the output dataset. Bronze, Silver, and Gold are Apify loyalty tiers — the more you subscribe, the less you pay per result. Platform fees may apply depending on your Apify plan. ### 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, investment analysis, and lead generation using publicly available HUD Home Store listings. Users are responsible for complying with applicable laws and HUD Home Store's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and be mindful of fair housing regulations when working with property data. # Actor input Schema ## `states` (type: `array`): US states to search for HUD homes. Pick one or more. Leave empty if you are searching by city/ZIP terms or pasting listing URLs instead. ## `searchTerms` (type: `array`): Search terms such as a city with its state ('Houston, TX'). Each term is searched on its own. For best results use the 'City, ST' format — a bare ZIP code on its own often returns no homes, so pair it with a city and state. ## `startUrls` (type: `array`): Paste HUD Home Store listing or search-result URLs to scrape them directly. Use this if you already have specific pages in mind. ## `priceMin` (type: `integer`): Only return homes listed at or above this price. Leave empty for no minimum. ## `priceMax` (type: `integer`): Only return homes listed at or below this price. Leave empty for no maximum. ## `bedroomsMin` (type: `integer`): Only return homes with at least this many bedrooms. Leave empty for any. ## `bedroomsMax` (type: `integer`): Only return homes with at most this many bedrooms. Leave empty for any. ## `bathroomsMin` (type: `number`): Only return homes with at least this many bathrooms. Half-baths are allowed (e.g. 1.5). Leave empty for any. ## `propertyTypes` (type: `array`): Only return these kinds of homes. Leave empty to include all property types. ## `propertyStatus` (type: `string`): Only return homes with a specific listing highlight, such as newly listed or price-reduced homes. Leave empty for all listings. ## `fhaFinancing` (type: `string`): Filter by FHA insurability. Insured homes qualify for an FHA loan as-is, Insured with Escrow set aside repair funds, and Uninsured homes need repairs before financing. Leave empty for all. ## `maxResults` (type: `integer`): Maximum number of homes to return across all searches. The actor stops requesting new pages once this number is reached, so the final page may slightly overshoot the limit. Set to 0 for no limit. ## Actor input object example ```json { "states": [ "TX" ], "searchTerms": [], "startUrls": [], "propertyTypes": [], "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped HUD home listings with key 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 = { "states": [ "TX" ], "searchTerms": [], "startUrls": [], "propertyTypes": [], "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/hudhomestore-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 = { "states": ["TX"], "searchTerms": [], "startUrls": [], "propertyTypes": [], "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/hudhomestore-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 '{ "states": [ "TX" ], "searchTerms": [], "startUrls": [], "propertyTypes": [], "maxResults": 100 }' | apify call solidcode/hudhomestore-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/hudhomestore-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HUD Home Store Scraper", "description": "[💰 $2.5 / 1K] Extract HUD foreclosed home listings nationwide — addresses, prices, beds/baths, case numbers, bid dates, FHA financing, and photos. Search by state, city, ZIP, or URL with price, bedroom, type, and status filters.", "version": "1.0", "x-build-id": "RHHzecg3VqczSThvX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~hudhomestore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-hudhomestore-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~hudhomestore-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-hudhomestore-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~hudhomestore-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-hudhomestore-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": { "states": { "title": "States", "uniqueItems": true, "type": "array", "description": "US states to search for HUD homes. Pick one or more. Leave empty if you are searching by city/ZIP terms or pasting listing URLs instead.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "VI", "GU" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Puerto Rico", "U.S. Virgin Islands", "Guam" ] } }, "searchTerms": { "title": "City / ZIP / County Terms", "type": "array", "description": "Search terms such as a city with its state ('Houston, TX'). Each term is searched on its own. For best results use the 'City, ST' format — a bare ZIP code on its own often returns no homes, so pair it with a city and state.", "items": { "type": "string" } }, "startUrls": { "title": "Listing or Search URLs", "type": "array", "description": "Paste HUD Home Store listing or search-result URLs to scrape them directly. Use this if you already have specific pages in mind.", "items": { "type": "string" } }, "priceMin": { "title": "Minimum Price (USD)", "minimum": 0, "type": "integer", "description": "Only return homes listed at or above this price. Leave empty for no minimum." }, "priceMax": { "title": "Maximum Price (USD)", "minimum": 0, "type": "integer", "description": "Only return homes listed at or below this price. Leave empty for no maximum." }, "bedroomsMin": { "title": "Minimum Bedrooms", "minimum": 0, "type": "integer", "description": "Only return homes with at least this many bedrooms. Leave empty for any." }, "bedroomsMax": { "title": "Maximum Bedrooms", "minimum": 0, "type": "integer", "description": "Only return homes with at most this many bedrooms. Leave empty for any." }, "bathroomsMin": { "title": "Minimum Bathrooms", "minimum": 0, "type": "number", "description": "Only return homes with at least this many bathrooms. Half-baths are allowed (e.g. 1.5). Leave empty for any." }, "propertyTypes": { "title": "Property Types", "uniqueItems": true, "type": "array", "description": "Only return these kinds of homes. Leave empty to include all property types.", "items": { "type": "string", "enum": [ "single_family", "condominium", "manufactured" ], "enumTitles": [ "Single Family Home", "Condominium", "Manufactured Home" ] } }, "propertyStatus": { "title": "Listing Highlight", "enum": [ "new_listing", "price_reduced", "vacant_lot" ], "type": "string", "description": "Only return homes with a specific listing highlight, such as newly listed or price-reduced homes. Leave empty for all listings." }, "fhaFinancing": { "title": "FHA Financing Type", "enum": [ "IN", "IE", "UI" ], "type": "string", "description": "Filter by FHA insurability. Insured homes qualify for an FHA loan as-is, Insured with Escrow set aside repair funds, and Uninsured homes need repairs before financing. Leave empty for all." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of homes to return across all searches. The actor stops requesting new pages once this number is reached, so the final page may slightly overshoot the limit. Set to 0 for no limit.", "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 } } } } } } } } } } ```