!

Sorting

Most of the endpoints on the Houski API allow you to sort the data returned by the API by a field.

There is no additional cost for sorting the data returned by the Houski API.

Sorting is performed by adding query parameters to the request URL. For example, to sort the properties returned by the properties endpoint by the estimated list price field, you can do either of the following:

SortTypeExample
Sort lowest to highestascestimate_list_price_sort=asc
Sort highest to lowestdescestimate_list_price_sort=desc
Programming language

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

Sorting by estimated list price
Request
Shell session
curl -X GET "https://api.houski.ca/properties?api_key=YOUR_API_KEY&country_abbreviation=ca&estimate_list_price_sort=asc&province_abbreviation=ab&results_per_page=3&select=estimate_list_price"
TypeScript code
const houski_properties_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('country_abbreviation', 'ca');
    url.searchParams.set('estimate_list_price_sort', 'asc');
    url.searchParams.set('province_abbreviation', 'ab');
    url.searchParams.set('results_per_page', '3');
    url.searchParams.set('select', 'estimate_list_price');

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

    return data;
}

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

// Log the response
console.log(data);
})();
Response
JSON
{
  "cache_hit": false,
  "cost_cents": 0.9000000357627869,
  "data": [
    {
      "address": "Twp Road 670 And Range Road 225A",
      "estimate_list_price": 50000,
      "property_id": "94aab9b892fa628c"
    },
    {
      "address": "625063 Rg Road 65",
      "estimate_list_price": 50000,
      "property_id": "9b74f092588309eb"
    },
    {
      "address": "Lot 9 572A Hunter Drive",
      "estimate_list_price": 50000,
      "property_id": "c7d0e5b1de68d28f"
    }
  ],
  "error": "",
  "pagination": {
    "current_page": 1,
    "has_next_page": true,
    "has_previous_page": false,
    "page_total": 654934
  },
  "price_quote": false,
  "result_total": 1964800,
  "time_ms": 309,
  "ui_info": {
    "country": "Canada",
    "country_abbreviation": "CA",
    "country_abbreviation_id": "9ace2b6431b7f1be",
    "country_abbreviation_link": "ca",
    "country_slug": "canada",
    "province": "Alberta",
    "province_abbreviation": "AB",
    "province_abbreviation_id": "aae1f05a0f89d2c7",
    "province_abbreviation_link": "ca/ab",
    "province_slug": "alberta"
  }
}