Deal signals your competitors
can't see.

import requests

API_KEY = "YOUR_API_KEY"
BASE    = "https://api.homedata.co.uk"
HEADERS = {"Authorization": f"Api-Key {API_KEY}"}

def find_and_assess_deals(postcode: str) -> list[dict]:
    # Step 1 — scan for recent reductions (1 call)
    listings = requests.get(
        f"{BASE}/api/live-listings/search/",
        headers=HEADERS,
        params={"postcode": postcode, "status": "reduced"}
    ).json().get("results", [])

    deals = []
    for listing in listings[:5]:  # assess top 5 reductions
        uprn = listing["property_uprn"]

        # Step 2 — property record (1 call each)
        record = requests.get(
            f"{BASE}/api/properties/{uprn}/",
            headers=HEADERS
        ).json()

        # Step 3 — comparable sales (10 calls each)
        comps = requests.get(
            f"{BASE}/api/comparables/{uprn}/",
            headers=HEADERS,
            params={"count": 20, "event_type": "sold"}
        ).json().get("comparables", [])

        avg_comp = (
            sum(c["sold_let_price"] for c in comps) / len(comps)
            if comps else None
        )
        asking   = listing["latest_price"]
        discount = round((1 - asking / avg_comp) * 100, 1) if avg_comp else None

        deals.append({
            "uprn":         uprn,
            "asking":       asking,
            "avg_comp":     avg_comp,
            "discount_pct": discount,
            "bedrooms":     record.get("bedrooms"),
            "floor_area":   record.get("floor_area_sqm"),
            "dom":          listing.get("days_on_market"),
        })

    return sorted(deals, key=lambda d: d["discount_pct"] or 0, reverse=True)

deals = find_and_assess_deals("SW11")
for d in deals:
    print(f"UPRN {d['uprn']} — £{d['asking']:,} | {d['discount_pct']}% BMV | {d['dom']} days on market")

const API_KEY = 'YOUR_API_KEY';
const BASE    = 'https://api.homedata.co.uk';
const headers = { 'Authorization': `Api-Key ${API_KEY}` };

async function findAndAssessDeals(postcode) {
  // Step 1 — scan for reductions (1 call)
  const listResp = await fetch(
    `${BASE}/api/live-listings/search/?postcode=${postcode}&status=reduced`,
    { headers }
  );
  const { results } = await listResp.json();

  // Steps 2 + 3 — property record + comps in parallel per shortlisted property
  const assessed = await Promise.all(
    results.slice(0, 5).map(async (listing) => {
      const uprn = listing.property_uprn;

      const [recordResp, compsResp] = await Promise.all([
        fetch(`${BASE}/api/properties/${uprn}/`, { headers }),
        fetch(`${BASE}/api/comparables/${uprn}/?count=20&event_type=sold`, { headers }),
      ]);

      const record           = await recordResp.json();
      const { comparables }  = await compsResp.json();

      const avgComp    = comparables.reduce((s, c) => s + c.sold_let_price, 0) / comparables.length;
      const discountPct = ((1 - listing.latest_price / avgComp) * 100).toFixed(1);

      return {
        uprn,
        asking:      listing.latest_price,
        avgComp:     Math.round(avgComp),
        discountPct,
        bedrooms:    record.bedrooms,
        dom:         listing.days_on_market,
      };
    })
  );

  return assessed.sort((a, b) => b.discountPct - a.discountPct);
}

findAndAssessDeals('SW11').then(deals =>
  deals.forEach(d =>
    console.log(`UPRN ${d.uprn} — £${d.asking.toLocaleString()} | ${d.discountPct}% BMV | ${d.dom} DOM`)
  )
);