---
title: "HouseSigma API: Search | Perceptlayer"
description: "Search from HouseSigma as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/housesigma/search
---

[APIs](https://perceptlayer.com/apis) / [HouseSigma](https://perceptlayer.com/apis/housesigma) / Search

# HouseSigma: Search

Search from HouseSigma as JSON. 1 credit per successful call.

GET `/v1/housesigma/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `municipality_id` | integer | Required | Any |
| `community_id` | integer | Optional | Any |
| `operation` | string | Optional | sale, rent |
| `province` | string | Optional | ON, BC, AB |
| `type` | string | Optional | detached, semi\_detached, freehold\_townhouse, condo\_townhouse, condo\_apartment, link, multiplex, vacant\_land, other |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `bedrooms` | integer | Optional | Any |
| `bathrooms` | integer | Optional | Any |
| `garage` | integer | Optional | Any |
| `area_min` | integer | Optional | Any |
| `area_max` | integer | Optional | Any |
| `lot_min` | integer | Optional | Any |
| `lot_max` | integer | Optional | Any |
| `listing_days` | integer | Optional | 1, 3, 7, 30, 90 |
| `keyword` | string | Optional | Up to 100 characters |
| `sort` | string | Optional | newest, price\_asc, price\_desc |
| `page` | integer | Optional | Any |

## Example request

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.

[Run this endpoint in the playground](https://perceptlayer.com/apis/housesigma?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
