From 940b66301170697cffb2f1c0dae0ec460449f200 Mon Sep 17 00:00:00 2001
From: Zachary Hampton <zachary@zacharysproducts.com>
Date: Tue, 11 Nov 2025 12:02:35 -0800
Subject: [PATCH] Update README with new features
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add examples for multiple listing types
- Add examples for filtering by last_update_date
- Add examples for Pythonic datetime/timedelta usage
- Update basic usage example with new parameters
- Add sort_by last_update_date example

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 80 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ae07bfd..63d284e 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,7 @@ filename = f"HomeHarvest_{current_timestamp}.csv"
 
 properties = scrape_property(
   location="San Diego, CA",
-  listing_type="sold",  # or (for_sale, for_rent, pending)
+  listing_type="sold",  # or for_sale, for_rent, pending, ["for_sale", "sold"], None (all types)
   past_days=30,  # sold in last 30 days - listed in last 30 days if (for_sale, for_rent)
 
   # property_type=['single_family','multi_family'],
@@ -42,6 +42,8 @@ properties = scrape_property(
   # date_to="2023-05-28",
   # foreclosure=True
   # mls_only=True,  # only fetch MLS listings
+  # updated_in_past_hours=24,  # filter by last_update_date
+  # sort_by="last_update_date",  # sort by last update
 )
 print(f"Number of properties: {len(properties)}")
 
@@ -155,6 +157,83 @@ properties = scrape_property(
     sort_by="sqft",
     sort_direction="desc"
 )
+
+# Sort by most recently updated
+properties = scrape_property(
+    location="New York, NY",
+    listing_type="for_sale",
+    sort_by="last_update_date",
+    sort_direction="desc"
+)
+```
+
+#### Multiple Listing Types
+```py
+# Get both for_sale and pending properties
+properties = scrape_property(
+    location="Austin, TX",
+    listing_type=["for_sale", "pending"],  # Returns properties matching ANY status
+    limit=100
+)
+
+# Get all listing types
+properties = scrape_property(
+    location="Seattle, WA",
+    listing_type=None,  # Returns for_sale, for_rent, sold, pending, etc.
+    limit=100
+)
+```
+
+#### Filter by Last Update Date
+```py
+from datetime import datetime, timedelta
+
+# Get properties updated in the last 24 hours
+properties = scrape_property(
+    location="Miami, FL",
+    listing_type="for_sale",
+    updated_in_past_hours=24,
+    sort_by="last_update_date",
+    sort_direction="desc"
+)
+
+# Get properties updated since a specific date/time
+properties = scrape_property(
+    location="Chicago, IL",
+    listing_type="for_sale",
+    updated_since=datetime(2025, 11, 10, 9, 0),  # datetime object
+    limit=100
+)
+
+# Or use ISO string
+properties = scrape_property(
+    location="Portland, OR",
+    listing_type="for_sale",
+    updated_since="2025-11-10T09:00:00",  # ISO string
+    limit=100
+)
+```
+
+#### Pythonic Time Filtering
+```py
+from datetime import datetime, timedelta
+
+# Use timedelta objects for more readable code
+properties = scrape_property(
+    location="Denver, CO",
+    listing_type="for_sale",
+    past_hours=timedelta(hours=6),  # More Pythonic than past_hours=6
+    limit=100
+)
+
+# Use datetime objects for precise time ranges
+properties = scrape_property(
+    location="Phoenix, AZ",
+    listing_type="for_sale",
+    datetime_from=datetime.now() - timedelta(days=7),
+    datetime_to=datetime.now(),
+    limit=100
+)
 ```
 
 ## Output