{ "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": "0KISwGjc9BhyKX19z" }, "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, each searched on its own. Three formats work: a city with its state ('Houston, TX'), a 5-digit ZIP code ('78155'), or a county with its state and the word County ('Harris County, TX'). A county written without 'County' is read as a city name, so 'Harris, TX' finds nothing.", "items": { "type": "string" } }, "startUrls": { "title": "Listing or Search URLs", "type": "array", "description": "Paste HUD Home Store URLs to collect them directly. Both shapes work: a search-results page, and a single home's listing page — including the home links this actor puts in every result, so you can paste results straight back in.", "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 count as 0.5, so 1.5 means one full bath plus a half bath. 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: New Listing, Price Reduced, or Vacant Lot Commission. HUD only highlights homes it is actively promoting, so roughly 6 in 10 homes carry any highlight at all and this filter always returns a much smaller set than the same search unfiltered. 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. This is a hard cap: collection stops the moment it is reached, so you are never charged for more homes than you asked for. 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 } } } } } } } } } }