API Reference
Build property intelligence into your applications. Property data, analytics, and climate risk — all via REST API.
Authentication
All requests require an API key passed via the Authorization header.
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://us-central1-ecometric-futuresense.cloudfunctions.net/api/api/properties/search?q=vancouver
Quick Start
JavaScript
const res = await fetch(
'https://ecometric.futuresenseai.com/api/v1/properties/search?q=vancouver&type=commercial',
{ headers: { Authorization: 'Bearer YOUR_KEY' } }
);
const { properties } = await res.json();
console.log(properties[0].greenScore.overall);Python
import requests
res = requests.get(
"https://ecometric.futuresenseai.com/api/v1/properties/search",
params={"q": "vancouver", "type": "commercial"},
headers={"Authorization": "Bearer YOUR_KEY"}
)
properties = res.json()["properties"]
print(properties[0]["greenScore"]["overall"])Endpoints
GET
/v1/properties/searchSearch properties by city, address, or keyword
Params: q, region, city, type, page, pageSize
GET
/v1/properties/:idGet full property details by ID
Params: id (path)
GET
/v1/scoring/:propertyIdCalculate Green Score for a property
Params: propertyId (path)
POST
/v1/scoring/bulkScore multiple properties (max 50)
Params: { propertyIds: string[] }
GET
/v1/data-sources/statusCheck health of all data adapters
Params: none
GET
/v1/reportsList saved reports
Params: none
POST
/v1/reportsCreate a new report
Params: { title, propertyIds[] }
Response Format
{
"properties": [
{
"id": "prop_bc_012345678",
"type": "commercial",
"address": { "street": "123 W Georgia St", "city": "Vancouver", "stateOrProvince": "BC" },
"greenScore": {
"overall": 72,
"environmental": 68,
"social": 75,
"governance": 80,
"confidence": 0.65
},
"dataCompleteness": 0.55
}
],
"total": 142,
"sources": ["municipal_energy"]
}