Property data API
for estate agents.

import requests

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

# Step 1 — resolve address to UPRN (2 calls)
r = requests.get(f"{BASE}/api/address/find/", params={"q": "42 Church Road Bristol"})
uprn = r.json()["suggestions"][0]["uprn"]

# Step 2 — comparable sales within 0.5 miles
comps = requests.get(
    f"{BASE}/api/comparables/{uprn}/",
    headers=HEADERS,
    params={"property_type": "Semi-Detached", "count": 20, "event_type": "sold"}
).json()

for c in comps["comparables"]:
    print(f"{c['address']}: £{c['sold_let_price']:,} ({c['sold_let_date']}) — {c['distance_meters']}m away")

# Step 3 — 12-month price trend for the outcode
postcode  = r.json()["suggestions"][0]["postcode"]
outcode   = postcode.split()[0]  # e.g. 'BS6'
trends    = requests.get(f"{BASE}/api/price_trends/{outcode}/", headers=HEADERS).json()
months    = sorted(trends["monthly_average_prices"].items())
print(f"Latest median: £{months[-1][1]:,}")

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

async function buildComparableReport(address) {
  // Step 1 — UPRN lookup (free)
  const find    = await fetch(`${BASE}/api/address/find/?q=${encodeURIComponent(address)}`);
  const { suggestions } = await find.json();
  const { uprn, postcode } = suggestions[0];

  // Step 2 — comparable sales
  const compsResp = await fetch(
    `${BASE}/api/comparables/${uprn}/?property_type=Semi-Detached&count=20&event_type=sold`,
    { headers }
  );
  const { comparables } = await compsResp.json();

  // Step 3 — price trend for outcode
  const outcode    = postcode.split(' ')[0];
  const trendResp  = await fetch(`${BASE}/api/price_trends/${outcode}/`, { headers });
  const { monthly_average_prices } = await trendResp.json();

  return { uprn, comparables, monthly_average_prices };
}

buildComparableReport('42 Church Road Bristol').then(console.log);