API recipes

Requests you can copy and run. Each one returns live data from the API.

Examples

Split assessed value into land and buildings

Programming language

Select the programming language you want to display the code examples in.

Split assessed value into land and buildings
Pull Seattle properties with their assessment split into its land and building parts, where the assessment roll records the split. The building share is a quick rebuild cost proxy for insurance screening, and the land share helps lenders read their collateral.
Request
Shell session
curl -X GET "https://api.houski.ca/properties?api_key=YOUR_API_KEY&assessment_improvement_value_gte=1&assessment_land_value_gte=1&city=seattle&country_abbreviation=us&page=1&province_abbreviation=wa&results_per_page=3&select=address,assessment_value,assessment_land_value,assessment_improvement_value,assessment_year"
TypeScript code
const houski_recipe_data = async (): Promise<PropertiesResponse> => {

    // You must copy the PropertiesResponse type declarations from the 
    // Houski API documentation to strongly type the response

    const url = new URL('https://api.houski.ca/properties');
    url.searchParams.set('api_key', 'YOUR_API_KEY');
    url.searchParams.set('assessment_improvement_value_gte', '1');
    url.searchParams.set('assessment_land_value_gte', '1');
    url.searchParams.set('city', 'seattle');
    url.searchParams.set('country_abbreviation', 'us');
    url.searchParams.set('page', '1');
    url.searchParams.set('province_abbreviation', 'wa');
    url.searchParams.set('results_per_page', '3');
    url.searchParams.set('select', 'address,assessment_value,assessment_land_value,assessment_improvement_value,assessment_year');

    const response = await fetch(url);
    const data = await response.json();

    return data;
}

(async () => {
let data: PropertiesResponse = await houski_recipe_data();

// Log the response
console.log(data);
})();
Response
JSON
{
  "cache_hit": true,
  "cost_cents": 1.26,
  "data": [
    {
      "address": "11722 25 Avenue NE",
      "assessment_improvement_value": 228000,
      "assessment_land_value": 600000,
      "assessment_value": 828000,
      "assessment_year": 2025,
      "property_id": "100a02b7befee12"
    },
    {
      "address": "11347 17 Avenue NE",
      "assessment_improvement_value": 118000,
      "assessment_land_value": 609000,
      "assessment_value": 727000,
      "assessment_year": 2025,
      "property_id": "100d76300f9fdf41"
    },
    {
      "address": "11032 20 Avenue NE",
      "assessment_improvement_value": 231000,
      "assessment_land_value": 632000,
      "assessment_value": 863000,
      "assessment_year": 2025,
      "property_id": "1026d02cc160a1f7"
    }
  ],
  "error": "",
  "pagination": {
    "current_page": 1,
    "has_next_page": true,
    "has_previous_page": false,
    "page_total": 63117
  },
  "price_quote": false,
  "result_total": 189349,
  "time_ms": 4092,
  "ui_info": {
    "city": "Seattle",
    "city_id": "6a23eb9e5bf4545c",
    "city_link": "us/wa/seattle",
    "city_slug": "seattle",
    "country": "United States",
    "country_abbreviation": "US",
    "country_abbreviation_id": "c148472ce4bd39d",
    "country_abbreviation_link": "us",
    "country_slug": "united_states",
    "province": "Washington",
    "province_abbreviation": "WA",
    "province_abbreviation_id": "bd83526ad9c0e644",
    "province_abbreviation_link": "us/wa",
    "province_slug": "washington"
  }
}