Skip to content Discuss your data requirements with our team. Get in touch ↗Discuss your data requirements with our team. Get in touch ↗

For AI agents: the documentation index is /docs/llms.txt, and this page is available as Markdown.

Retrieve a full property profile

This guide retrieves every record West Kite holds for one property, starting from an address. It uses one search call, then six calls that can run concurrently. The six calls cost $0.17 in total. Owner research is optional and costs $0.10.

Calls

Data Endpoint Price
Property ID GET /v1/search Free
Owner of record, sales, assessments, zoning, permits, events, loans, outline GET /v1/properties/{id}?parts=all $0.01
Environmental, hazards, incentives, buildability GET /v1/properties/{id}/site $0.05
Roads, rail, water, gas GET /v1/nearby $0.01
Power plants, substations, lines, serving utility GET /v1/power $0.05
Population, income, jobs, housing GET /v1/demographics $0.05
Aerial image with the lot outlined GET /v1/properties/{id}/image Free
People behind the owner of record POST /v1/research $0.10

Step 1: Resolve the address

curl --get "https://api.westkite.com/v1/search" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "q=550 Madison Ave, New York, NY"
import os, requests
from concurrent.futures import ThreadPoolExecutor

API = "https://api.westkite.com/v1"
headers = {"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"}
id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"

calls = {
    "record": (f"/properties/{id}", {"parts": "all"}),
    "site": (f"/properties/{id}/site", {}),
    "nearby": ("/nearby", {"property_id": id}),
    "power": ("/power", {"property_id": id}),
    "demographics": ("/demographics", {"property_id": id, "radius_m": 1609}),
    "image": (f"/properties/{id}/image", {"format": "json"}),
}

def get(path, params):
    return requests.get(API + path, params=params, headers=headers, timeout=60).json()

with ThreadPoolExecutor() as pool:
    results = dict(zip(calls, pool.map(lambda call: get(*call), calls.values())))
const API = "https://api.westkite.com/v1";
const headers = { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` };
const id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0";
const get = (path: string, params: Record<string, string> = {}) =>
  fetch(`${API}${path}?${new URLSearchParams(params)}`, { headers }).then(response => response.json());

const [record, site, nearby, power, demographics, image] = await Promise.all([
  get(`/properties/${id}`, { parts: "all" }),
  get(`/properties/${id}/site`),
  get("/nearby", { property_id: id }),
  get("/power", { property_id: id }),
  get("/demographics", { property_id: id, radius_m: "1609" }),
  get(`/properties/${id}/image`, { format: "json" }),
]);

Response times

The property record typically returns in under 2 seconds. Site screening and demographics query public agency services at request time: site screening typically takes 5 to 15 seconds and demographics up to 30 seconds. Set client timeouts accordingly.

Response fields

Data Field
Owner of record record.data.property.owner_name
Saved owner research record.data.owner
Sales record.data.sales.sales, newest first
Assessed value and tax record.data.assessments.assessments, newest roll first
Zoning record.data.zoning.zoning_code, record.data.zoning.map_district
Permits record.data.permits.permits, newest first
Violations and inspections record.data.events.events, where the city publishes them
Loans record.data.loans
Flood zone and hazards site.data.hazards.findings
Environmental sites site.data.environmental.findings
Tax incentives site.data.incentives.findings
Transport and utilities nearby.data.features
Power infrastructure power.data.features
Population and income demographics.data.population, demographics.data.acs
Image source and year image.data.years[0]

Fields a source does not publish are listed in each response's missing array with a reason. They are never returned as zero. See Missing data.

Step 3: Owner research (optional)

When the owner of record is an LLC, trust or other entity, owner research identifies the people behind it. A run takes several minutes and costs $0.10. A run that identifies no person is not charged.

curl https://api.westkite.com/v1/research \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "property_ids": ["property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"] }'

Poll the run with GET /v1/research/{id}?wait=60. Each person in result.people has a person_id, which contacts takes to return an email, phone number or LinkedIn profile. After a run completes, parts=owner on the property record includes the result at no extra charge.

Cost

  • A property record costs $0.01 regardless of the parts requested.
  • Search, images, zoning, map layers, markets and coverage are free.
  • max_cost_usd on any call sets the most it can charge. Keys can also carry a monthly spend cap. See Pricing and billing.
  • For many properties, use batch retrieve or exports.