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_usdon 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.