Property data API for estate agents.

# address/find: 2 tokens
curl "https://api.homedata.co.uk/address/find/?q=42+Church+Road+Bristol" \
  -H "Authorization: Api-Key YOUR_API_KEY"
  # returns suggestions[] with uprn, address, postcode

# Step 2: pull comparable sales (arranged per customer, not self-serve)
curl "https://api.homedata.co.uk/comparables/100023456789/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
  # ?count=20&property_type=Semi-Detached&event_type=sold

# Step 3: outcode price trend
curl "https://api.homedata.co.uk/price_trends/BS6/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

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 tokens)
r = requests.get(f"{BASE}/address/find/", params={"q": "42 Church Road Bristol"}, headers=HEADERS)
uprn = r.json()["suggestions"][0]["uprn"]

# Step 2: comparable sales within 0.5 miles (arranged per customer, not self-serve)
comps = requests.get(
    f"{BASE}/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}/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
  const find    = await fetch(`${BASE}/address/find/?q=${encodeURIComponent(address)}`, { headers });
  const { suggestions } = await find.json();
  const { uprn, postcode } = suggestions[0];

  // Step 2: comparable sales (arranged per customer, not self-serve)
  const compsResp = await fetch(
    `${BASE}/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}/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);