{ "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 } } } } } } } } } }