pyfunda 2.1.0__tar.gz → 2.2.0__tar.gz

{pyfunda-2.1.0 → pyfunda-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyfunda
-Version: 2.1.0
+Version: 2.2.0
 Summary: Python API for Funda.nl real estate listings
 Project-URL: Homepage, https://github.com/0xMH/pyfunda
 Project-URL: Repository, https://github.com/0xMH/pyfunda
@@ -265,6 +265,34 @@ for listing in f.poll_new_listings(
 
 This bypasses ES search and queries the detail API directly, catching listings that haven't been indexed yet.
 
+#### get_price_history(listing)
+
+Get historical price data for a listing, including previous asking prices, WOZ tax assessments, and sale history.
+
+```python
+listing = f.get_listing(43032486)
+history = f.get_price_history(listing)
+
+for change in history:
+    print(change['date'], change['human_price'], change['status'])
+# 22 okt, 2025    €435.000     asking_price
+# 1 jan, 2025     €472.000     woz
+# 19 aug, 2019    €300.000     asking_price
+```
+
+**Returns:** List of price changes, each containing:
+
+| Field | Description |
+|-------|-------------|
+| `price` | Numeric price |
+| `human_price` | Formatted price (e.g., "€435.000") |
+| `date` | Human readable date |
+| `timestamp` | ISO timestamp |
+| `source` | "Funda" or "WOZ" |
+| `status` | `asking_price`, `sold`, or `woz` |
+
+> **Note:** This fetches data from the Walter Living API. Only called when explicitly requested (lazy-loaded).
+
 ### Listing
 
 Listing objects support dict-like access with convenient aliases.
@@ -516,6 +544,29 @@ for listing in f.poll_new_listings(since_id=latest_id, offering_type="buy"):
 
 The generator stops after 20 consecutive 404s (configurable via `max_consecutive_404s`).
 
+### Get price history for a listing
+
+```python
+from funda import Funda
+
+f = Funda()
+listing = f.get_listing(43032486)
+
+# Fetch historical prices (WOZ assessments, previous asking prices, sales)
+history = f.get_price_history(listing)
+
+print(f"Price history for {listing['title']}:")
+for change in history:
+    print(f"  {change['date']}: {change['human_price']} ({change['status']})")
+
+# Calculate price change over time
+funda_prices = [c for c in history if c['source'] == 'Funda']
+if len(funda_prices) >= 2:
+    newest, oldest = funda_prices[0]['price'], funda_prices[-1]['price']
+    change_pct = ((newest - oldest) / oldest) * 100
+    print(f"\nPrice change: {change_pct:+.1f}%")
+```
+
 ## License
 
 AGPL-3.0

{pyfunda-2.1.0 → pyfunda-2.2.0}/README.md

@@ -243,6 +243,34 @@ for listing in f.poll_new_listings(
 
 This bypasses ES search and queries the detail API directly, catching listings that haven't been indexed yet.
 
+#### get_price_history(listing)
+
+Get historical price data for a listing, including previous asking prices, WOZ tax assessments, and sale history.
+
+```python
+listing = f.get_listing(43032486)
+history = f.get_price_history(listing)
+
+for change in history:
+    print(change['date'], change['human_price'], change['status'])
+# 22 okt, 2025    €435.000     asking_price
+# 1 jan, 2025     €472.000     woz
+# 19 aug, 2019    €300.000     asking_price
+```
+
+**Returns:** List of price changes, each containing:
+
+| Field | Description |
+|-------|-------------|
+| `price` | Numeric price |
+| `human_price` | Formatted price (e.g., "€435.000") |
+| `date` | Human readable date |
+| `timestamp` | ISO timestamp |
+| `source` | "Funda" or "WOZ" |
+| `status` | `asking_price`, `sold`, or `woz` |
+
+> **Note:** This fetches data from the Walter Living API. Only called when explicitly requested (lazy-loaded).
+
 ### Listing
 
 Listing objects support dict-like access with convenient aliases.
@@ -494,6 +522,29 @@ for listing in f.poll_new_listings(since_id=latest_id, offering_type="buy"):
 
 The generator stops after 20 consecutive 404s (configurable via `max_consecutive_404s`).
 
+### Get price history for a listing
+
+```python
+from funda import Funda
+
+f = Funda()
+listing = f.get_listing(43032486)
+
+# Fetch historical prices (WOZ assessments, previous asking prices, sales)
+history = f.get_price_history(listing)
+
+print(f"Price history for {listing['title']}:")
+for change in history:
+    print(f"  {change['date']}: {change['human_price']} ({change['status']})")
+
+# Calculate price change over time
+funda_prices = [c for c in history if c['source'] == 'Funda']
+if len(funda_prices) >= 2:
+    newest, oldest = funda_prices[0]['price'], funda_prices[-1]['price']
+    change_pct = ((newest - oldest) / oldest) * 100
+    print(f"\nPrice change: {change_pct:+.1f}%")
+```
+
 ## License
 
 AGPL-3.0

{pyfunda-2.1.0 → pyfunda-2.2.0}/examples/price_history.py

@@ -5,8 +5,8 @@ Shows previous asking prices, WOZ tax assessments, and sale history
 using the Walter Living API.
 
 Usage:
-    uv run examples/price_history.py 89666837
-    uv run examples/price_history.py "https://www.funda.nl/detail/koop/..."
+    uv run examples/price_history.py 43032486
+    uv run examples/price_history.py "https://www.funda.nl/en/detail/koop/amsterdam/appartement-pieter-calandlaan-400/43032486/"
 """
 
 import argparse

{pyfunda-2.1.0 → pyfunda-2.2.0}/funda/__init__.py

@@ -16,5 +16,5 @@ Example usage:
 from funda.funda import Funda, FundaAPI
 from funda.listing import Listing
 
-__version__ = "2.1.0"
+__version__ = "2.2.0"
 __all__ = ["Funda", "FundaAPI", "Listing", "__version__"]

{pyfunda-2.1.0 → pyfunda-2.2.0}/funda/funda.py

@@ -18,13 +18,11 @@ API_WALTER = "https://api.walterliving.com/hunter/lookup"
 
 # Headers for mobile API
 HEADERS = {
-    "user-agent": "Dart/3.9 (dart:io)",
     "x-funda-app-platform": "android",
     "content-type": "application/json",
 }
 
 SEARCH_HEADERS = {
-    "user-agent": "Dart/3.9 (dart:io)",
     "content-type": "application/json",
     "accept": "application/json",
     "referer": "https://www.funda.nl/",
@@ -71,7 +69,7 @@ class Funda:
     def session(self) -> requests.Session:
         """Lazily create HTTP session."""
         if self._session is None:
-            self._session = requests.Session(impersonate="safari")
+            self._session = requests.Session(impersonate="chrome")
             self._session.headers.update(HEADERS)
         return self._session
 

{pyfunda-2.1.0 → pyfunda-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyfunda"
-version = "2.1.0"
+version = "2.2.0"
 description = "Python API for Funda.nl real estate listings"
 readme = "README.md"
 license = "AGPL-3.0-or-later"