!
Overview
Design philosophy
Quick start
Recipes
Pricing
Fields
Filtering
Sorting
Selecting
Expanding
MCP
FAQ
Endpoints
Aggregate
Auth
AVM
Properties
Location
Search
Map
Predict
Geocoding

Examples

API Recipe: Get recent listings in specific city communities

Learn how to use the Houski API with practical examples.

Get recent listings in specific city communities
In this example, we are retrieving houses that have been listed within the last 60 days in the communities of Riverbend and McKenzie Towne in Calgary. Community names must be capitalized and spelled correctly to work. Our location endpoint can deliver location data for communities in a city, if you need to ensure they all formatted correctly. Setting 'filter_expand_match=all' ensures we only return properties that have listing data. We are also selecting some fields for each property - the latitude, longitude, community, and the size of the interior in square meters. We are then limiting the results per each page to 3.
Request
Shell session
curl -X GET "https://api.houski.ca/properties?api_key=YOUR_API_KEY&city=calgary&community_in=Riverbend,McKenzie Towne&country_abbreviation=ca&expand=listings&expand_listing_date_gt=2025-05-15&filter_expand_match=all&province_abbreviation=ab&results_per_page=3&select=latitude,longitude,community,interior_sq_m"
Shell session
curl -X GET "https://api.houski.ca/properties?api_key=YOUR_API_KEY&city=calgary&community_in=Riverbend,McKenzie Towne&country_abbreviation=ca&expand=listings&expand_listing_date_gt=2025-05-15&filter_expand_match=all&province_abbreviation=ab&results_per_page=3&select=latitude,longitude,community,interior_sq_m"
Response
JSON
{
  "cache_hit": false,
  "cost_cents": 1.8700001239776611,
  "data": [
    {
      "address": "47 Elgin Terrace SE",
      "community": "McKenzie Towne",
      "interior_sq_m": 188.3128967285156,
      "latitude": 50.9063835144043,
      "listings": [
        {
          "expand_estimate_list_price": 684900,
          "expand_listing_date": "2025-06-09",
          "expand_listing_event": "Listed",
          "property_id": "10053e86b05542f8"
        },
        {
          "expand_estimate_list_price": 664900,
          "expand_listing_date": "2025-07-07",
          "expand_listing_event": "Price decrease",
          "property_id": "10053e86b05542f8"
        }
      ],
      "longitude": -113.96188354492188,
      "property_id": "10053e86b05542f8"
    },
    {
      "address": "1309 310 McKenzie Towne Gate SE",
      "community": "McKenzie Towne",
      "interior_sq_m": 85.8416976928711,
      "latitude": 50.91393280029297,
      "listings": [
        {
          "expand_estimate_list_price": 379900,
          "expand_listing_date": "2025-07-07",
          "expand_listing_event": "Price decrease",
          "property_id": "121c14cbfabad2a5"
        }
      ],
      "longitude": -113.95620727539062,
      "property_id": "121c14cbfabad2a5"
    },
    {
      "address": "171 Riverglen Park SE",
      "community": "Riverbend",
      "interior_sq_m": 124.95355224609376,
      "latitude": 50.9727897644043,
      "listings": [
        {
          "expand_estimate_list_price": 409900,
          "expand_listing_date": "2025-05-24",
          "expand_listing_event": "Price decrease",
          "property_id": "150e7d51dca67143"
        },
        {
          "expand_estimate_list_price": 399900,
          "expand_listing_date": "2025-05-28",
          "expand_listing_event": "Price decrease",
          "property_id": "150e7d51dca67143"
        },
        {
          "expand_estimate_list_price": 394900,
          "expand_listing_date": "2025-07-01",
          "expand_listing_event": "Price decrease",
          "property_id": "150e7d51dca67143"
        },
        {
          "expand_estimate_list_price": 394900,
          "expand_listing_date": "2025-07-13",
          "expand_listing_event": "Unlisted",
          "property_id": "150e7d51dca67143"
        }
      ],
      "longitude": -114.010986328125,
      "property_id": "150e7d51dca67143"
    }
  ],
  "error": "",
  "pagination": {
    "current_page": 1,
    "has_next_page": true,
    "has_previous_page": false,
    "page_total": 67
  },
  "price_quote": false,
  "result_total": 199,
  "time_ms": 234,
  "ui_info": {
    "city": "Calgary",
    "city_id": "6ec95b53075d062c",
    "city_link": "ca/ab/calgary",
    "city_slug": "calgary",
    "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"
  }
}