{
  "schema_version": 1,
  "generated_at": "2026-11-22T07:01:00+13:00",
  "built_at": "2026-11-21T18:00:44+00:00",
  "snapshot_date": "22 November 2026",
  "counts": {
    "listings": 2254,
    "standard": 2191,
    "non_standard": 63,
    "suburbs": 30,
    "sales": 667
  },
  "coverage": {
    "homes_avm": 943,
    "homes_avm_pct": 43.0,
    "sold_comps": 1233,
    "active_guide": 15,
    "hedonic_fallback": 0,
    "with_range_pct": 100.0,
    "comp_cv_normalised": 0,
    "comp_absolute": 1233,
    "all_listings": {
      "homes_avm": 968,
      "sold_comps": 1270,
      "active_guide": 16
    }
  },
  "model": {
    "version": "hedonic-avm-v1",
    "n_train": 1145,
    "mape_with_cv": 0.0639,
    "median_ape_with_cv": 0.0385,
    "mape_no_cv": 0.2114,
    "r2": 0.9662,
    "interval_level": 0.8
  },
  "market": {
    "median_value_mid": 1255000,
    "median_cv": 1475000,
    "median_cv_ratio": 0.9789,
    "median_days_on_market": 72,
    "below_avm_count": 273,
    "below_avm_pct": 12.5,
    "mean_cv_ratio": 0.9871
  },
  "suburbs": [
    {
      "name": "Orewa",
      "slug": "orewa",
      "group": "Hibiscus Coast",
      "listings": 361,
      "median_value_mid": 1080388,
      "median_cv": 1275000,
      "median_cv_ratio": 0.9773,
      "median_days_on_market": 80,
      "avm_pct": 33.5,
      "trend_12w": 0.0044,
      "mean_cv_ratio": 0.9763
    },
    {
      "name": "Gulf Harbour",
      "slug": "gulf-harbour",
      "group": "Whangaparāoa Peninsula",
      "listings": 140,
      "median_value_mid": 866326,
      "median_cv": 1000000,
      "median_cv_ratio": 1.0022,
      "median_days_on_market": 138,
      "avm_pct": 37.9,
      "trend_12w": 0.0052,
      "mean_cv_ratio": 0.9952
    },
    {
      "name": "Takapuna",
      "slug": "takapuna",
      "group": "North Shore",
      "listings": 136,
      "median_value_mid": 1350000,
      "median_cv": 2025000,
      "median_cv_ratio": 0.9617,
      "median_days_on_market": 92,
      "avm_pct": 44.1,
      "trend_12w": 0.0081,
      "mean_cv_ratio": 0.9757
    },
    {
      "name": "Bucklands Beach",
      "slug": "bucklands-beach",
      "group": "Eastern Beaches",
      "listings": 127,
      "median_value_mid": 1445000,
      "median_cv": 1675000,
      "median_cv_ratio": 0.9337,
      "median_days_on_market": 67,
      "avm_pct": 43.3,
      "trend_12w": 0.0063,
      "mean_cv_ratio": 0.9356
    },
    {
      "name": "Stanmore Bay",
      "slug": "stanmore-bay",
      "group": "Whangaparāoa Peninsula",
      "listings": 127,
      "median_value_mid": 890000,
      "median_cv": 940000,
      "median_cv_ratio": 0.9838,
      "median_days_on_market": 85,
      "avm_pct": 40.2,
      "trend_12w": -0.0003,
      "mean_cv_ratio": 0.9994
    },
    {
      "name": "Browns Bay",
      "slug": "browns-bay",
      "group": "North Shore",
      "listings": 122,
      "median_value_mid": 1138000,
      "median_cv": 1200000,
      "median_cv_ratio": 0.9649,
      "median_days_on_market": 66,
      "avm_pct": 35.2,
      "trend_12w": -0.0007,
      "mean_cv_ratio": 0.9769
    },
    {
      "name": "Torbay",
      "slug": "torbay",
      "group": "North Shore",
      "listings": 105,
      "median_value_mid": 1150000,
      "median_cv": 1175000,
      "median_cv_ratio": 0.9676,
      "median_days_on_market": 46,
      "avm_pct": 35.2,
      "trend_12w": -0.0041,
      "mean_cv_ratio": 0.9747
    },
    {
      "name": "Half Moon Bay",
      "slug": "half-moon-bay",
      "group": "Eastern Beaches",
      "listings": 90,
      "median_value_mid": 1350000,
      "median_cv": 1400000,
      "median_cv_ratio": 0.9479,
      "median_days_on_market": 48,
      "avm_pct": 41.1,
      "trend_12w": -0.0063,
      "mean_cv_ratio": 0.9354
    },
    {
      "name": "Long Bay",
      "slug": "long-bay",
      "group": "North Shore",
      "listings": 83,
      "median_value_mid": 1455000,
      "median_cv": 2025000,
      "median_cv_ratio": 1.0253,
      "median_days_on_market": 78,
      "avm_pct": 31.3,
      "trend_12w": 0.024,
      "mean_cv_ratio": 1.02
    },
    {
      "name": "St Heliers",
      "slug": "saint-heliers",
      "group": "Eastern Bays",
      "listings": 83,
      "median_value_mid": 1950000,
      "median_cv": 2275000,
      "median_cv_ratio": 0.9904,
      "median_days_on_market": 66,
      "avm_pct": 68.7,
      "trend_12w": 0.001,
      "mean_cv_ratio": 1.0028
    },
    {
      "name": "Millwater",
      "slug": "millwater",
      "group": "Hibiscus Coast",
      "listings": 82,
      "median_value_mid": 1345000,
      "median_cv": 1450000,
      "median_cv_ratio": 0.9834,
      "median_days_on_market": 72,
      "avm_pct": 26.8,
      "trend_12w": 0.0065,
      "mean_cv_ratio": 0.9335
    },
    {
      "name": "Silverdale",
      "slug": "silverdale",
      "group": "Hibiscus Coast",
      "listings": 82,
      "median_value_mid": 1245000,
      "median_cv": 1125000,
      "median_cv_ratio": 0.9549,
      "median_days_on_market": 162,
      "avm_pct": 30.5,
      "trend_12w": 0.0065,
      "mean_cv_ratio": 0.948
    },
    {
      "name": "Milford",
      "slug": "milford",
      "group": "North Shore",
      "listings": 67,
      "median_value_mid": 1550000,
      "median_cv": 1950000,
      "median_cv_ratio": 1.0099,
      "median_days_on_market": 93,
      "avm_pct": 34.3,
      "trend_12w": 0.0071,
      "mean_cv_ratio": 1.0296
    },
    {
      "name": "Mairangi Bay",
      "slug": "mairangi-bay",
      "group": "North Shore",
      "listings": 64,
      "median_value_mid": 1496500,
      "median_cv": 1725000,
      "median_cv_ratio": 1.023,
      "median_days_on_market": 55,
      "avm_pct": 32.8,
      "trend_12w": -0.001,
      "mean_cv_ratio": 1.014
    },
    {
      "name": "Red Beach",
      "slug": "red-beach",
      "group": "Hibiscus Coast",
      "listings": 64,
      "median_value_mid": 1110000,
      "median_cv": 1200000,
      "median_cv_ratio": 0.9873,
      "median_days_on_market": 52,
      "avm_pct": 60.9,
      "trend_12w": 0.0027,
      "mean_cv_ratio": 0.9729
    },
    {
      "name": "Devonport",
      "slug": "devonport",
      "group": "North Shore",
      "listings": 57,
      "median_value_mid": 1825966,
      "median_cv": 2275000,
      "median_cv_ratio": 0.9953,
      "median_days_on_market": 58,
      "avm_pct": 75.4,
      "trend_12w": 0.0107,
      "mean_cv_ratio": 1.0288
    },
    {
      "name": "Ōrākei",
      "slug": "orakei",
      "group": "Eastern Bays",
      "listings": 53,
      "median_value_mid": 1691417,
      "median_cv": 2375000,
      "median_cv_ratio": 0.9776,
      "median_days_on_market": 149,
      "avm_pct": 64.2,
      "trend_12w": 0.0069,
      "mean_cv_ratio": 0.9727
    },
    {
      "name": "Glendowie",
      "slug": "glendowie",
      "group": "Eastern Bays",
      "listings": 51,
      "median_value_mid": 1834409,
      "median_cv": 2000000,
      "median_cv_ratio": 0.9951,
      "median_days_on_market": 64,
      "avm_pct": 56.9,
      "trend_12w": -0.0106,
      "mean_cv_ratio": 1.0076
    },
    {
      "name": "Mission Bay",
      "slug": "mission-bay",
      "group": "Eastern Bays",
      "listings": 41,
      "median_value_mid": 1595000,
      "median_cv": 1650000,
      "median_cv_ratio": 0.9522,
      "median_days_on_market": 73,
      "avm_pct": 80.5,
      "trend_12w": -0.0038,
      "mean_cv_ratio": 0.9858
    },
    {
      "name": "Rothesay Bay",
      "slug": "rothesay-bay",
      "group": "North Shore",
      "listings": 40,
      "median_value_mid": 1385000,
      "median_cv": 2250000,
      "median_cv_ratio": 1.0319,
      "median_days_on_market": 45,
      "avm_pct": 22.5,
      "trend_12w": 0.0026,
      "mean_cv_ratio": 1.0238
    },
    {
      "name": "Kohimarama",
      "slug": "kohimarama",
      "group": "Eastern Bays",
      "listings": 39,
      "median_value_mid": 1804668,
      "median_cv": 1912500,
      "median_cv_ratio": 0.9494,
      "median_days_on_market": 46,
      "avm_pct": 82.1,
      "trend_12w": -0.006,
      "mean_cv_ratio": 0.9634
    },
    {
      "name": "Manly",
      "slug": "manly",
      "group": "Whangaparāoa Peninsula",
      "listings": 38,
      "median_value_mid": 981904,
      "median_cv": 1087500,
      "median_cv_ratio": 0.9825,
      "median_days_on_market": 28,
      "avm_pct": 63.2,
      "trend_12w": -0.006,
      "mean_cv_ratio": 0.9983
    },
    {
      "name": "Campbells Bay",
      "slug": "campbells-bay",
      "group": "North Shore",
      "listings": 33,
      "median_value_mid": 1495000,
      "median_cv": 2450000,
      "median_cv_ratio": 1.0429,
      "median_days_on_market": 61,
      "avm_pct": 30.3,
      "trend_12w": 0.0103,
      "mean_cv_ratio": 1.0698
    },
    {
      "name": "Castor Bay",
      "slug": "castor-bay",
      "group": "North Shore",
      "listings": 33,
      "median_value_mid": 1670620,
      "median_cv": 2200000,
      "median_cv_ratio": 1.0581,
      "median_days_on_market": 78,
      "avm_pct": 63.6,
      "trend_12w": 0.0018,
      "mean_cv_ratio": 1.0619
    },
    {
      "name": "Murrays Bay",
      "slug": "murrays-bay",
      "group": "North Shore",
      "listings": 27,
      "median_value_mid": 1495000,
      "median_cv": 1837500,
      "median_cv_ratio": 1.0407,
      "median_days_on_market": 31,
      "avm_pct": 59.3,
      "trend_12w": 0.0021,
      "mean_cv_ratio": 1.092
    },
    {
      "name": "Eastern Beach",
      "slug": "eastern-beach",
      "group": "Eastern Beaches",
      "listings": 17,
      "median_value_mid": 1465000,
      "median_cv": 1830000,
      "median_cv_ratio": 0.966,
      "median_days_on_market": 47,
      "avm_pct": 47.1,
      "trend_12w": 0.0007,
      "mean_cv_ratio": 0.9612
    },
    {
      "name": "Waiake",
      "slug": "waiake",
      "group": "North Shore",
      "listings": 13,
      "median_value_mid": 1307141,
      "median_cv": 2100000,
      "median_cv_ratio": 0.9969,
      "median_days_on_market": 36,
      "avm_pct": 61.5,
      "trend_12w": -0.0148,
      "mean_cv_ratio": 1.0011
    },
    {
      "name": "Army Bay",
      "slug": "army-bay",
      "group": "Whangaparāoa Peninsula",
      "listings": 9,
      "median_value_mid": 1021805,
      "median_cv": 1175000,
      "median_cv_ratio": 0.9968,
      "median_days_on_market": 24,
      "avm_pct": 66.7,
      "trend_12w": -0.0036,
      "mean_cv_ratio": 1.0371
    },
    {
      "name": "Whangaparāoa",
      "slug": "whangaparaoa",
      "group": "Whangaparāoa Peninsula",
      "listings": 7,
      "median_value_mid": 900000,
      "median_cv": null,
      "median_cv_ratio": null,
      "median_days_on_market": 516,
      "avm_pct": 0.0,
      "trend_12w": null,
      "mean_cv_ratio": null
    },
    {
      "name": "Big Manly",
      "slug": "big-manly",
      "group": "Whangaparāoa Peninsula",
      "listings": 0,
      "median_value_mid": null,
      "median_cv": null,
      "median_cv_ratio": null,
      "median_days_on_market": null,
      "avm_pct": null,
      "trend_12w": null,
      "mean_cv_ratio": null
    }
  ],
  "top_value": [
    {
      "id": "6101282500",
      "address": "23 Te Arawa Street",
      "suburb": "Ōrākei",
      "value_low": 1428395,
      "value_mid": 1517744,
      "value_high": 1607092,
      "cv_ratio": 0.934,
      "deal_gap": 467744,
      "deal_gap_pct": 30.82,
      "sale_method": "Asking price",
      "days_on_market": 87,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2325440250.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/orakei/listing/6101282500"
    },
    {
      "id": "6237603464",
      "address": "27A Auckland Road",
      "suburb": "St Heliers",
      "value_low": 2147055,
      "value_mid": 2281357,
      "value_high": 2415658,
      "cv_ratio": 1.0253,
      "deal_gap": 682357,
      "deal_gap_pct": 29.91,
      "sale_method": "Asking price",
      "days_on_market": 2,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2342953865.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/saint-heliers/listing/6237603464"
    },
    {
      "id": "6177079569",
      "address": "14 Blue Gum Avenue",
      "suburb": "Silverdale",
      "value_low": 787087,
      "value_mid": 836321,
      "value_high": 885554,
      "cv_ratio": 0.6691,
      "deal_gap": 241321,
      "deal_gap_pct": 28.86,
      "sale_method": "Asking price",
      "days_on_market": 39,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2334855443.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/rodney/silverdale/listing/6177079569"
    },
    {
      "id": "6032734560",
      "address": "54A Comins Crescent",
      "suburb": "Mission Bay",
      "value_low": 1292839,
      "value_mid": 1373708,
      "value_high": 1454577,
      "cv_ratio": 0.9991,
      "deal_gap": 378708,
      "deal_gap_pct": 27.57,
      "sale_method": "Asking price",
      "days_on_market": 130,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2317642636.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/mission-bay/listing/6032734560"
    },
    {
      "id": "5863790138",
      "address": "99a Selwyn Avenue",
      "suburb": "Mission Bay",
      "value_low": 1002779,
      "value_mid": 1065504,
      "value_high": 1128230,
      "cv_ratio": 0.8879,
      "deal_gap": 265504,
      "deal_gap_pct": 24.92,
      "sale_method": "Asking price",
      "days_on_market": 233,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2305779741.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/mission-bay/listing/5863790138"
    },
    {
      "id": "6069633148",
      "address": "70A Hutchinsons Road",
      "suburb": "Bucklands Beach",
      "value_low": 1466295,
      "value_mid": 1558014,
      "value_high": 1649733,
      "cv_ratio": 0.9738,
      "deal_gap": 360014,
      "deal_gap_pct": 23.11,
      "sale_method": "Asking price",
      "days_on_market": 107,
      "confidence": "high",
      "photo_url": "https://trademe.tmcdn.co.nz/photoserver/med/2321769941.jpg",
      "url": "https://www.trademe.co.nz/a/property/residential/sale/auckland/manukau-city/bucklands-beach/listing/6069633148"
    }
  ],
  "sale_methods": [
    {
      "method": "Price by negotiation",
      "count": 1133,
      "share_pct": 51.7
    },
    {
      "method": "Asking price",
      "count": 753,
      "share_pct": 34.4
    },
    {
      "method": "Auction",
      "count": 175,
      "share_pct": 8.0
    },
    {
      "method": "Deadline sale",
      "count": 119,
      "share_pct": 5.4
    },
    {
      "method": "Tender",
      "count": 11,
      "share_pct": 0.5
    }
  ],
  "coverage_by_type": [
    {
      "property_type": "House",
      "count": 1601,
      "avm_pct": 47.4
    },
    {
      "property_type": "Townhouse",
      "count": 185,
      "avm_pct": 28.6
    },
    {
      "property_type": "Apartment",
      "count": 176,
      "avm_pct": 50.6
    },
    {
      "property_type": "Section",
      "count": 167,
      "avm_pct": 0.0
    },
    {
      "property_type": "Unit",
      "count": 54,
      "avm_pct": 66.7
    },
    {
      "property_type": "Dwelling",
      "count": 7,
      "avm_pct": 71.4
    },
    {
      "property_type": "Bare land",
      "count": 1,
      "avm_pct": 100.0
    }
  ],
  "trend": {
    "weeks": 12,
    "series": [
      {
        "week": "2026-08-20",
        "median_estimate": 1496791
      },
      {
        "week": "2026-09-03",
        "median_estimate": 1482583
      },
      {
        "week": "2026-09-17",
        "median_estimate": 1479705
      },
      {
        "week": "2026-10-01",
        "median_estimate": 1485076
      },
      {
        "week": "2026-10-15",
        "median_estimate": 1508631
      },
      {
        "week": "2026-10-29",
        "median_estimate": 1484065
      },
      {
        "week": "2026-11-12",
        "median_estimate": 1488970
      }
    ]
  },
  "automation": {
    "status": "running",
    "last_run_at": "2026-11-22T03:19:30+13:00",
    "steps": 0
  },
  "research": {
    "topics": 12,
    "fdr_significant": 0,
    "fdr_tests": 36,
    "text_model_delta_pct": -5.62
  },
  "definitions": {
    "standard_listings": "listings that pass the standard-property classifier; non-standard types (relocatable, leasehold-only, retirement etc.) are excluded",
    "homes_avm": "standard listings whose primary valuation range is the Homes.co.nz AVM shown on the Trade Me listing (standard listings only)",
    "homes_avm_pct": "homes_avm as a percentage of standard listings (standard listings only)",
    "sold_comps": "standard listings whose primary range comes from comparable sales, i.e. comp_cv_normalised + comp_absolute (standard listings only)",
    "comp_cv_normalised": "standard listings valued by the CV-normalised comparable-sales model (sale price / CV ratios; value_source 'sold_comps') (standard listings only)",
    "comp_absolute": "standard listings valued by the raw nearby-sales fallback (value_source 'sold_comps_absolute') (standard listings only)",
    "active_guide": "standard listings valued from the active suburb guide only (standard listings only)",
    "hedonic_fallback": "standard listings valued by the calibrated hedonic fallback model (standard listings only)",
    "with_range_pct": "share of standard listings with a complete low/mid/high value range (standard listings only)",
    "all_listings.homes_avm": "all collected listings whose primary range is a Homes.co.nz AVM, including non-standard ones (all collected listings; reference only)",
    "all_listings.sold_comps": "all collected listings with a comparable-sales range, including non-standard ones (all collected listings; reference only)",
    "all_listings.active_guide": "all collected listings valued from the active suburb guide, including non-standard ones (all collected listings; reference only)",
    "mape_with_cv": "mean absolute percentage error of the hedonic AVM under 5-fold cross-validation, as a fraction",
    "median_ape_with_cv": "median absolute percentage error of the hedonic AVM under 5-fold cross-validation, as a fraction",
    "mape_no_cv": "mean absolute percentage error of the no-CV hedonic variant, as a fraction",
    "interval_level": "nominal level of the reported prediction interval (0.8 = 80%)",
    "median_value_mid": "median of the primary value-range midpoints across standard listings",
    "median_cv": "median council capital value across standard listings",
    "median_cv_ratio": "median of per-listing value midpoint ÷ council CV, across standard listings where both exist (this is a median of ratios, not median value ÷ median CV)",
    "mean_cv_ratio": "arithmetic mean of per-listing value midpoint ÷ council CV, across standard listings where both exist (context only)",
    "median_days_on_market": "median days on market across standard listings",
    "below_avm_count": "standard listings asking below their primary value midpoint, counted only where the stored deal gap is reliable (high/medium confidence, non-leasehold)",
    "below_avm_pct": "below_avm_count as a percentage of standard listings",
    "suburbs.median_value_mid": "median primary value midpoint across the suburb's standard listings",
    "suburbs.median_cv_ratio": "median of per-listing value midpoint ÷ council CV, across this suburb's standard listings where both exist (not the suburb's median value ÷ median CV, which is lower when expensive homes have low CVs)",
    "suburbs.mean_cv_ratio": "arithmetic mean of per-listing value midpoint ÷ council CV for this suburb's standard listings (context only; median_cv_ratio is the comparable statistic)",
    "suburbs.avm_pct": "share of the suburb's standard listings whose primary range is the Homes.co.nz AVM",
    "suburbs.trend_12w": "change in the suburb median estimate over the stored 12-week window, as a fraction",
    "top_value.ranking": "standard listings, high/medium confidence, non-null deal gap; ordered by deal_gap_pct descending, then deal_gap descending, then days_on_market descending; top 6",
    "top_value.value_low": "lower bound of the listing's primary published value range (the range bound shown in the listing card)",
    "top_value.value_mid": "midpoint of the listing's primary published value range (the model-comparable estimate)",
    "top_value.value_high": "upper bound of the listing's primary published value range (the range bound shown in the listing card)",
    "top_value.deal_gap": "primary value midpoint minus asking price, in dollars",
    "top_value.deal_gap_pct": "the same gap as a percentage of the primary value midpoint",
    "sale_methods.share_pct": "share of standard listings using the sale method",
    "coverage_by_type.avm_pct": "share of standard listings of that property type whose primary range is the Homes.co.nz AVM",
    "trend.weeks": "nominal trend window in weeks; series holds the stored suburb snapshot dates inside that window",
    "trend.series.week": "a stored market snapshot date; the database captures suburb estimates fortnightly, not weekly",
    "automation.last_run_at": "start time of the last daily refresh run",
    "research.fdr_tests": "text-regression coefficients tested with Benjamini-Hochberg FDR across the two dependent variables",
    "research.text_model_delta_pct": "percentage-point change in cross-validated MAPE when text features are added to the structural model (negative = text improves the model)",
    "generated_at": "export time in the build host's local timezone (+13:00 NZDT)",
    "snapshot_date": "human-readable date label of generated_at"
  },
  "sources": {
    "counts": "/api/health counts",
    "coverage": "/api/research valuation",
    "model": "/api/research hedonic.metrics (database meta)",
    "market": "/api/listings cards (standard listings)",
    "suburbs": "/api/market, with group and AVM share from /api/listings cards",
    "top_value": "/api/listings cards",
    "sale_methods": "/api/listings cards",
    "coverage_by_type": "/api/listings cards",
    "trend": "/api/market series (database suburb_estimate_history)",
    "automation": "automation/status/last_run.json",
    "research": "/api/research text"
  }
}
