# Hubzu Property Search Scraper (`stealth_mode/hubzu-property-search-scraper`) Actor

Extract 90+ fields from Hubzu.com property auction listings — bids, prices, addresses, photos, dates, and more. Perfect for real estate investors, analysts, and researchers tracking foreclosure auctions across the US.

- **URL**: https://apify.com/stealth\_mode/hubzu-property-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Hubzu.com Property Search Scraper: Extract Auction Listings at Scale

***

### What Is Hubzu.com?

Hubzu.com is a US-based online real estate auction platform specializing in foreclosure, bank-owned (REO), and distressed properties. Buyers and investors bid on residential and commercial listings across all 50 states. Tracking these auctions manually is impractical at scale — the **Hubzu.com Property Search Scraper** automates extraction, delivering structured property data ready for analysis.

***

### Overview

The **Hubzu Property Scraper** collects detailed listing data from Hubzu search and auction pages, capturing everything from bid history to geolocation coordinates. It is built for:

- **Real estate investors** monitoring auction opportunities by region
- **Data analysts** building foreclosure market datasets
- **Proptech developers** feeding property data into valuation or mapping tools
- **Researchers** studying distressed housing market trends

Key advantages: configurable item limits, fault-tolerant URL handling, and a rich 90+ field output covering pricing, auction mechanics, property specs, and listing metadata.

***

### Input Format

The scraper accepts a JSON configuration object with three parameters:

```json
{
  "urls": ["https://www.hubzu.com/tx/auctions?pageNumber=2"],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `urls` | `array` | — | One or more Hubzu property list/search page URLs to scrape. Supports pagination URLs (e.g., `?pageNumber=2`). Add URLs one by one or use bulk edit. |
| `ignore_url_failures` | `boolean` | `true` | If `true`, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs. |
| `max_items_per_url` | `integer` | `20` | Maximum number of listings to collect per URL. Set higher (e.g., `50`) for denser search pages. |

> **Tip:** Use state or city-filtered Hubzu URLs (e.g., `/tx/auctions`, `/fl/auctions`) and increment `pageNumber` to crawl paginated results systematically.

***

### Output Format

**Sample output**

```json
{
  "property_category": "SC",
  "property_status": "ACTV",
  "id": null,
  "value": null,
  "property_id": "94317656486",
  "listing_id": "94317656486AUCN8",
  "listing_url": "/property/94317656486-2818-PORTER-DR-Amarillo-TX-79110",
  "listing_type": "AUCN",
  "reserve_met": "N",
  "client_code_restricted_flag": false,
  "reserve_price_flag": "Y",
  "self_showing_flag": "N",
  "broker_co_op": "N",
  "property_sub_type": "Single Family",
  "size": "2,707",
  "lot_size": "10,500",
  "lot_size_unit": "",
  "area_square_feet": null,
  "listing_ending_info": {
    "days": "1",
    "hrs": "14",
    "mins": "20"
  },
  "bed_count": "5",
  "bath_count": "2",
  "photo_count": "8",
  "bid_offer_count": "0",
  "image_url": "//image-prod.hubzu.com/2026/4/94317656486/94317656486_20260429140656281_5.JPEG.X278.Y184.JPEG",
  "own_it_now_flag": "N",
  "own_it_now_price": "",
  "prop_address": {
    "street_number": "2818 PORTER DR",
    "street_name": "",
    "county": "RANDALL",
    "city": "Amarillo",
    "state": "TX",
    "zip": "79110",
    "latitude": null,
    "longitude": null,
    "state_landing_url": "/tx/auctions",
    "city_landing_url": "/tx/amarillo/auctions"
  },
  "current_bid": "",
  "starting_bid": "159,000",
  "category": "SC",
  "occupancy_status": "N",
  "current_highest_bid": null,
  "agent_company_name": "FOR SALE BY OWNER",
  "on_watch_list": null,
  "watch_notify_type": null,
  "on_short_list": null,
  "lat": "35.161247",
  "lng": "-101.86906",
  "has_hnb": "N",
  "waiting_for_hnb": null,
  "rank": "38.0",
  "myrank": null,
  "radius_score": "",
  "color_code": "Orange",
  "tag_name": "Active",
  "listing_price": "175,900",
  "hot_property": "N",
  "pre_market_flag": "N",
  "is_ocwen_seller": "N",
  "is_preview": false,
  "is_no_buyer_premium": true,
  "estimated_bid_price": "",
  "auction_time_left": 138052150,
  "preview_period_end_at": null,
  "display_list_price_for_auction": "N",
  "seller_id": "943",
  "event": null,
  "non_bank_owned": "N",
  "listing_start_date": "2026-05-06T16:00:00Z",
  "listing_end_date": "2026-05-13T14:00:00Z",
  "auction_duration": "May. 06 - May. 13",
  "child_bulk_property_flag": "N",
  "parent_bulk_property_flag": "N",
  "new_to_hubzu_flag": "N",
  "fc_online_flag": "N",
  "listing_status": "Active",
  "listing_detail_status": null,
  "is_place_bid_enabled": "N",
  "invr_aprvl_reqd_prop": "Y",
  "is_fc_proxy_bid_enabled": false,
  "image_list": null,
  "prop_address_string": null,
  "modified_on": null,
  "offer_placed_on": null,
  "increment_amount": null,
  "increment_multiplier": null,
  "cfd_offer_id": null,
  "estimated_property_value": null,
  "cfd_flag": null,
  "cfd_flag_updated_time": null,
  "cfd_property_disclaimer_flag": null,
  "cfd_listing_attempt_number": null,
  "commercial_retail_tag": "N",
  "short_description": null,
  "marketing_description": null,
  "property_information": null,
  "cwcot_updates_enabled": false,
  "cwcot_updates_valid": false,
  "fc_proxy_bid_cut_off_available": false,
  "user_registered_for_fc_proxy_bid": false,
  "from_url": "https://www.hubzu.com/tx/auctions?pageNumber=2"
}
```

Each listing returns a structured record with 90+ fields grouped below by category:

#### Property Identification

| Field | Meaning |
|---|---|
| `ID` | Internal scraper record ID |
| `Property ID` | Hubzu's unique property identifier |
| `Listing ID` | Unique ID for this listing instance |
| `Value` | Raw value object for the property |
| `Property Category` | Broad category (e.g., residential, commercial) |
| `Property Sub Type` | Subtype (e.g., single-family, condo, multi-family) |
| `Property Status` | Current status of the property |
| `Listing Status` | Status of the listing (active, closed, etc.) |
| `Listing Detail Status` | Granular status label shown on listing detail page |
| `Listing Type` | Auction type (e.g., online auction, BIN) |
| `Listing URL` | Direct URL to the property's listing page |

#### Pricing & Bidding

| Field | Meaning |
|---|---|
| `Starting Bid` | Minimum opening bid amount |
| `Current Bid` | Most recent bid placed |
| `Current Highest Bid` | Highest bid at time of scrape |
| `Estimated Bid Price` | Platform's estimated competitive bid |
| `Listing Price` | Listed price (for non-auction or BIN listings) |
| `Own It Now Price` | Buy It Now price if enabled |
| `Own It Now Flag` | Whether Buy It Now option is available |
| `Display List Price For Auction` | Whether list price is shown alongside auction |
| `Reserve Met` | Whether the reserve price threshold has been reached |
| `Reserve Price Flag` | Whether a reserve price exists on this listing |
| `Increment Amount` | Fixed bid increment value |
| `Increment Multiplier` | Multiplier applied to bid increments |
| `Estimated Property Value` | Platform or seller estimated market value |
| `Bid Offer Count` | Total number of bids placed |
| `Is No Buyer Premium` | Whether buyer's premium is waived |

#### Auction Timing

| Field | Meaning |
|---|---|
| `Listing Start Date` | When the auction listing opened |
| `Listing End Date` | When the auction closes |
| `Auction Duration` | Total length of the auction window |
| `Auction Time Left` | Remaining time at time of scrape |
| `Preview Period End At` | End of the property preview window |
| `Listing Ending Info` | Summary of ending conditions or countdown |
| `Modified On` | Last modification timestamp of the listing |
| `Offer Placed On` | Timestamp of the most recent offer |

#### Property Details

| Field | Meaning |
|---|---|
| `Bed Count` | Number of bedrooms |
| `Bath Count` | Number of bathrooms |
| `Size` | Property size (typically in sq ft) |
| `Area Square Feet` | Explicit square footage |
| `Lot Size` | Lot area |
| `Lot Size Unit` | Unit for lot size (acres, sq ft, etc.) |
| `Occupancy Status` | Whether the property is occupied or vacant |
| `Short Description` | Brief marketing headline |
| `Marketing Description` | Full marketing copy for the listing |
| `Property Information` | Additional structured property details |

#### Location

| Field | Meaning |
|---|---|
| `Property Address` | Full address object |
| `Property Address String` | Flat string version of the address |
| `Latitude` | Geographic latitude coordinate |
| `Longitude` | Geographic longitude coordinate |

#### Media

| Field | Meaning |
|---|---|
| `Image URL` | Primary listing image URL |
| `Image List` | Full array of property photo URLs |
| `Photo Count` | Total number of available photos |

#### Listing Flags & Features

| Field | Meaning |
|---|---|
| `Hot Property` | Platform-highlighted high-interest listing |
| `New To Hubzu Flag` | Recently added listing flag |
| `Pre Market Flag` | Listed before public market release |
| `Is Preview` | Whether listing is in preview-only mode |
| `Self Showing Flag` | Whether self-guided tours are available |
| `Broker Co Op` | Whether broker co-op participation is offered |
| `FC Online Flag` | Foreclosure online listing flag |
| `Child Bulk Property Flag` | Part of a bulk/portfolio sale (child) |
| `Parent Bulk Property Flag` | Head listing of a bulk/portfolio sale |
| `Client Code Restricted Flag` | Access restricted to specific clients |
| `Is Ocwen Seller` | Whether seller is Ocwen (major servicer) |
| `Non Bank Owned` | Whether seller is a non-bank entity |
| `Investor Approval Required Property` | Requires investor pre-approval to bid |
| `Commercial Retail Tag` | Tagged as commercial/retail type |

#### CWCOT & FC Proxy Bid (Foreclosure-Specific)

| Field | Meaning |
|---|---|
| `CWCOT Updates Enabled` | Competitive With Cash Out Title process active |
| `CWCOT Updates Valid` | CWCOT data is current and validated |
| `Is FC Proxy Bid Enabled` | Foreclosure proxy bidding is available |
| `Is Place Bid Enabled` | Whether bidding is currently open |
| `FC Proxy Bid Cut Off Available` | Proxy bid cutoff window exists |
| `User Registered For FC Proxy Bid` | Current user's proxy bid registration status |
| `Has HNB` | Has a highest non-bank bid |
| `Waiting For HNB` | Awaiting highest non-bank bid resolution |

#### CFD (Contract for Deed)

| Field | Meaning |
|---|---|
| `CFD Flag` | Whether listing is available as Contract for Deed |
| `CFD Offer ID` | Associated CFD offer identifier |
| `CFD Flag Updated Time` | When CFD status was last updated |
| `CFD Property Disclaimer Flag` | CFD-specific legal disclaimer required |
| `CFD Listing Attempt Number` | Number of times listed under CFD terms |

#### Agent, Seller & Watchlist

| Field | Meaning |
|---|---|
| `Seller ID` | Seller's Hubzu account ID |
| `Agent Company Name` | Listing agent's brokerage |
| `On Watch List` | Whether user has watchlisted this property |
| `Watch Notify Type` | Notification preference for watchlisted item |
| `On Short List` | Whether property is on user's shortlist |
| `Event` | Associated auction event or campaign |
| `Category` | Internal Hubzu category tag |
| `Tag Name` | Display tag (e.g., "Reduced", "Ending Soon") |
| `Rank` | Listing rank in search results |
| `My Rank` | Personalized rank for the current user |
| `Radius Score` | Geo-relevance score |
| `Color Code` | UI color tag associated with listing status |

***

### How to Use

1. **Get search URLs** — Navigate to Hubzu.com, filter by state/city/type, and copy the resulting page URL (e.g., `https://www.hubzu.com/fl/auctions?pageNumber=1`).
2. **Build your input** — Add URLs to the `urls` array. Increment `pageNumber` for pagination.
3. **Set limits** — Use `max_items_per_url` to control volume per page (up to 50 is typical per Hubzu page).
4. **Enable fault tolerance** — Keep `ignore_url_failures: true` for multi-URL runs.
5. **Run and export** — Download results as JSON, CSV, or Excel.

**Tips:**

- Hubzu paginates results; scrape multiple `pageNumber` values in a single run by adding all page URLs.
- Filter URLs by state slug (`/tx/`, `/ca/`) to segment data by geography.
- If a URL returns empty results, confirm it loads correctly in a browser first.

***

### Use Cases & Business Value

- **Auction monitoring:** Track new and ending listings in target markets daily
- **Investment screening:** Filter by bed/bath count, price, and occupancy to shortlist deals
- **Market research:** Analyze foreclosure volume and pricing trends by region
- **Portfolio tools:** Feed data into custom dashboards or valuation models

The Hubzu Property Scraper turns paginated auction search pages into structured, analysis-ready datasets — eliminating hours of manual browsing and copy-pasting.

***

### Conclusion

The **Hubzu.com Property Search Scraper** is an essential tool for anyone working with US foreclosure and auction data. With 90+ output fields spanning pricing, auction mechanics, property specs, and geolocation, it delivers the depth needed for serious real estate analysis. Configure your URLs, set your limits, and start collecting.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.hubzu.com/tx/auctions?pageNumber=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.hubzu.com/tx/auctions?pageNumber=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/hubzu-property-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.hubzu.com/tx/auctions?pageNumber=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/hubzu-property-search-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 '{
  "urls": [
    "https://www.hubzu.com/tx/auctions?pageNumber=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/hubzu-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/hubzu-property-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ju6V5xbTkoi1AyIOE/builds/BkvLTJk9TFzTndHdp/openapi.json