--- title: "HouseSigma API: JSON data, 5 endpoints, 1 credit per call" description: "HouseSigma API for Canadian home search, listings, nearby homes, market stats and locations in Ontario, BC and Alberta as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/housesigma --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / HouseSigma 1 credit per call 5 endpoints 27 datapoints # HouseSigma API HouseSigma API for Canadian home search, listings, nearby homes, market stats and locations in Ontario, BC and Alberta as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below HouseSigma GET /v1/housesigma/search?municipality\_id=10343&operation=sale&price\_max=1200000&bedrooms=3&sort=price\_asc ``` { "success": true, "total": 449, "returned": 18, "pagination": { "page": 1, "limit": 20, "total_pages": 23, "has_next_page": true, "has_previous_page": false, "capped": false }, "applied_filters": { "operation": "sale", "province": "ON", "municipality_id": 10343, "sort": "price_asc", "bedrooms": 3, "price_max": 1200000 }, "listings": [ { "id": "XRla7gBaaxPyjEvL", "ml_num": "C13883318", "url": "https://housesigma.com/on/toronto-real-estate/704-100-leeward-glenway/home/owJKR7Po9EpyXeLP/", "address": "704 - 100 Leeward Glenway", "price": { "amount": 399000, "currency": "CAD", "abbr": "0.4M", "gated": false }, "bedrooms": 3, "bathrooms": 2, "parking": { "total": 0, "garage": 0, "garage_type": "Underground", "text": "-" }, "property_type": { "code": "C.", "label": "Condo Apartment" }, "style": "Apartment", "area": { "text": "800-899", "min": 800, "max": 899, "unit": "feet²" }, "location": { "lat": 43.71141, "lon": -79.32846 }, "status": { "kind": "sale", "text": "For Sale", "code": "A", "live": true }, "community": "Flemingdon Park", "municipality": "Toronto", "province": "ON", "listed_at": "2026-10-09", "updated_at": "2026-10-10", "days_on_site": 34, "photo": "https://cache-e11.housesigma.com/file/pix-treb/C13883318/14482_1_1200.webp?43631644", "brokerage": "RIGHT AT HOME REALTY · MLS# C13883318", "estimate": 381900, "rent_yield": 4.9, "scores": { "school": 6, "rent": 8, "growth": 1 }, "tags": [ "For Sale" ], "data_source": "PROPTX", "gated": false }, { "id": "K8OgYBzRVGjYJmG2", "ml_num": "C14145184", "url": "https://housesigma.com/on/toronto-real-estate/1204-ossington-avenue/home/GMnKYqp2Lgj3w1Qr/", "address": "1204 Ossington Avenue", "price": { "amount": 408000, "currency": "CAD", "abbr": "0.41M", "gated": false }, "bedrooms": 3, "bedrooms_extra": 1, "bathrooms": 4, "parking": { "total": 0, "garage": 0, "garage_type": "None", "text": "0 garage, 4 parking" }, "property_type": { "code": "J.", "label": "Duplex" }, "style": "2 1/2 Storey", "area": { "text": "1500-2000", "min": 1500, "max": 2000, "unit": "feet²" }, "lot": { "front": 16, "depth": 116, "area": 1856, "unit": "feet" }, "location": { "lat": 43.67382, "lon": -79.43094 }, "status": { "kind": "sale", "text": "For Sale", "code": "A", "live": true }, "community": "Wychwood", "municipality": "Toronto", "province": "ON", "listed_at": "2026-11-03", "updated_at": "2026-11-11", "days_on_site": 9, "photo": "https://cache-e18.housesigma.com/file/pix-treb/C14145184/d8284_1_1200.webp?f289f192", "brokerage": "RE/MAX HALLMARK REALTY LTD. · MLS# C14145184", "scores": { "school": 6 }, "tags": [ "For Sale" ], "data_source": "PROPTX", "gated": false }, { "id": "JKdOYrBNxdZY54lW", "ml_num": "C14126530", "url": "https://housesigma.com/on/toronto-real-estate/1603-15-vicora-linkway/home/nbq6y10Da2PYo9DA/", "address": "1603 - 15 Vicora Linkway", "price": { "amount": 419800, "currency": "CAD", "abbr": "0.42M", "gated": false }, "bedrooms": 3, "bathrooms": 2, "parking": { "total": 1, "garage": 1, "garage_type": "Underground", "text": "Underground 1 parking" }, "property_type": { "code": "C.", "label": "Condo Apartment" }, "style": "Apartment", "area": { "text": "1000-1199", "min": 1000, "max": 1199, "unit": "feet²" }, "location": { "lat": 43.71093, "lon": -79.32513 }, "status": { "kind": "sale", "text": "For Sale", "code": "A", "live": true }, "community": "Flemingdon Park", "municipality": "Toronto", "province": "ON", "listed_at": "2026-10-28", "updated_at": "2026-11-09", "days_on_site": 15, "photo": "https://cache06.housesigma.com/file/pix-treb/C14126530/38e9c_1_1200.webp?46abae5d", "brokerage": "REMAX YOUR COMMUNITY REALTY · MLS# C14126530", "estimate": 407600, "rent_yield": 4.2, "scores": { "school": 6, "rent": 7, "growth": 1 }, "tags": [ "For Sale" ], "data_source": "PROPTX", "gated": false } ], "meta": { "endpoint_family": "search", "attempts": 1, "filtered_out": 2, "request_id": "req_e7445b76c1784f1fbf0d1198ff5e4105", "credits_charged": 1, "credits_remaining": 1861 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | ml\_num string | url url | address string | price object | bedrooms integer | bathrooms integer | parking object | property\_type object | style string | area object | location object | status object | community string | municipality string | province string | listed\_at string | updated\_at string | days\_on\_site integer | photo url | brokerage string | estimate number | rent\_yield number | scores object | tags string\[\] | data\_source string | gated boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | XRla7gBaaxPyjEvL | C13883318 | https://housesigma.com/on/toronto-real-estate/704-100-leeward-glenway/home/owJKR7Po9EpyXeLP/ | 704 - 100 Leeward Glenway | {4 fields} | 3 | 2 | {4 fields} | {2 fields} | Apartment | {4 fields} | {2 fields} | {4 fields} | Flemingdon Park | Toronto | ON | 2026-10-09 | 2026-10-10 | 34 | https://cache-e11.housesigma.com/file/pix-treb/C13883318/14482\_1\_1200.webp?43631644 | RIGHT AT HOME REALTY · MLS# C13883318 | 381900 | 4.9 | {3 fields} | \[1 item\] | PROPTX | false | | 2 | K8OgYBzRVGjYJmG2 | C14145184 | https://housesigma.com/on/toronto-real-estate/1204-ossington-avenue/home/GMnKYqp2Lgj3w1Qr/ | 1204 Ossington Avenue | {4 fields} | 3 | 4 | {4 fields} | {2 fields} | 2 1/2 Storey | {4 fields} | {2 fields} | {4 fields} | Wychwood | Toronto | ON | 2026-11-03 | 2026-11-11 | 9 | https://cache-e18.housesigma.com/file/pix-treb/C14145184/d8284\_1\_1200.webp?f289f192 | RE/MAX HALLMARK REALTY LTD. · MLS# C14145184 | — | — | {1 fields} | \[1 item\] | PROPTX | false | | 3 | JKdOYrBNxdZY54lW | C14126530 | https://housesigma.com/on/toronto-real-estate/1603-15-vicora-linkway/home/nbq6y10Da2PYo9DA/ | 1603 - 15 Vicora Linkway | {4 fields} | 3 | 2 | {4 fields} | {2 fields} | Apartment | {4 fields} | {2 fields} | {4 fields} | Flemingdon Park | Toronto | ON | 2026-10-28 | 2026-11-09 | 15 | https://cache06.housesigma.com/file/pix-treb/C14126530/38e9c\_1\_1200.webp?46abae5d | REMAX YOUR COMMUNITY REALTY · MLS# C14126530 | 407600 | 4.2 | {3 fields} | \[1 item\] | PROPTX | false | Recorded from our API · 3 items shown · 27 datapoints per item GET /v1/housesigma/search?municipality\_id=10343&operation=sale&price\_max=1200000&bedrooms=3&sort=price\_asc 27 datapoints ### Identity - id string - property\_type object - status object ### Contact - url url ### Location - address string - area object - location object ### Reputation - photo url - scores object ### Price - price object ### Other - ml\_num string - bedrooms integer - bathrooms integer - parking object - style string - community string - municipality string - province string - listed\_at string - updated\_at string - days\_on\_site integer - brokerage string - estimate number - rent\_yield number - tags string\[\] - data\_source string - gated boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/housesigma/search?municipality_id=10343&operation=sale&price_max=1200000&bedrooms=3&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` HouseSigma · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/housesigma/listing`](https://perceptlayer.com/apis/housesigma/listing) | `id` | 1 credit | | [GET `/v1/housesigma/locations`](https://perceptlayer.com/apis/housesigma/locations) | `q` +1 optional | 1 credit | | [GET `/v1/housesigma/market`](https://perceptlayer.com/apis/housesigma/market) | `municipality_id` +1 optional | 1 credit | | [GET `/v1/housesigma/nearby`](https://perceptlayer.com/apis/housesigma/nearby) | `id` | 1 credit | | [GET `/v1/housesigma/search`](https://perceptlayer.com/apis/housesigma/search) | `municipality_id` +17 optional | 1 credit | Overview ## About the HouseSigma API ## What you can get The HouseSigma API returns Canadian property data from HouseSigma as JSON through 5 endpoints. Most take a `province`: ON, BC or AB. - **Search:** `search` takes a `municipality_id`, with `community_id`, `operation` (sale or rent), `province`, `type` (detached, semi\_detached, freehold\_townhouse, condo\_townhouse, condo\_apartment, link, multiplex, vacant\_land or other), `price_min`, `price_max`, `bedrooms`, `bathrooms`, `garage`, `area_min`, `area_max`, `lot_min`, `lot_max`, `listing_days` (1, 3, 7, 30 or 90), `keyword`, `sort` (newest, price\_asc or price\_desc) and `page`. - **Listings:** `listing` and `nearby` take an `id`. - **Markets:** `market` takes a `municipality_id`, with `province`. - **Locations:** `locations` takes a `q`, with `province`. The recorded `search` for 3-bedroom homes for sale in Toronto ( `municipality_id=10343`) up to 1,200,000 CAD, cheapest first, returns `listings`, each with `id`, `ml_num`, `url`, `address`, `price`, `bedrooms`, `bathrooms`, `parking`, `property_type`, `style`, `area`, `location`, `status`, `community`, `municipality`, `province`, `listed_at`, `updated_at`, `days_on_site`, `brokerage`, `estimate`, `rent_yield`, `scores` ( `school`, `rent` and `growth`) and `tags`. It also returns `total` (449), `returned`, `pagination` with `total_pages` and `has_next_page`, and `applied_filters`. ## How a call works Search a municipality: `GET /v1/housesigma/search?municipality_id=10343&operation=sale&price_max=1200000&bedrooms=3&sort=price_asc` with your key in the `X-API-Key` header. Each listing's `id` goes to `listing` or `nearby`, and the same `municipality_id` goes to `market`. `locations` takes a place name, such as toronto, to help you find one. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices and \`days\_on\_site\` in Toronto, Vancouver or Calgary `` Use the HouseSigma API to track asking prices and `days_on_site` in Toronto, Vancouver or Calgary `` ### Compare asking prices with each listing's \`estimate\` `` Use the HouseSigma API to compare asking prices with each listing's `estimate` `` ### Rank listings by \`rent\_yield\` and \`scores\` `` Use the HouseSigma API to rank listings by `rent_yield` and `scores` `` ### Pull market stats for a municipality with \`market\` `` Use the HouseSigma API to pull market stats for a municipality with `market` `` FAQ ## Questions **Do I need a HouseSigma account?** No. You call this HouseSigma API with your Perceptlayer key in the \`X-API-Key\` header, with no HouseSigma login. **How much does the HouseSigma API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Which provinces does it cover?** Set \`province\` to ON, BC or AB for Ontario, British Columbia or Alberta on \`search\`, \`market\` and \`locations\`. **Should I build a HouseSigma scraper instead?** You can, but a HouseSigma scraper is code you maintain: page changes break it, requests get blocked, and HouseSigma's terms govern how you collect data. The HouseSigma API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the HouseSigma API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)