# HouseSigma Listing Details API Documentation Scrappa's `GET /api/housesigma/listing` returns the full record of one HouseSigma listing. ## Input Pass `id`, the 16 letter and digit id from the search, nearby or locations endpoint (`houses.listing_id`). Other values are refused with `422`. ## What you get `id`, `address_id`, `ml_num`, `url`, `title`, `address`, `price` (amount, currency `CAD`, `abbr`, `gated`), `status`, `property_type`, `location` (`lat`, `lon`), `community`, `municipality`, `province`, `cross_street`, `postal_code`, `bedrooms`, `bedrooms_extra`, `bathrooms`, `parking`, `area`, `lot`, `fees` (property `tax` per year, `tax_note`, `maintenance`), `dates`, `description`, all `photos`, `agency.name`, `key_facts`, `details` (property, building, inside, utilities, parking and land groups), `rooms` (type, level, size in metres and feet, features), `history` (earlier listings of the address), `schools`, `community_stats`, `estimate` (price, rent, rent yield, scores), `open_houses`, `faq` and `data_source`. ## Brokerage, not agents The listing brokerage is returned as `agency.name`. HouseSigma shows the listing agent only to signed-in users, so there is no agent object and no agent or agency profile endpoint. ## Sold and masked values Sold and leased prices are masked by HouseSigma for visitors who are not signed in, so history entries carry no sold price. A masked price, room count or area is `null` and `price.gated` is `true`. ## Unavailable listings A listing that HouseSigma shows only to signed-in users returns `503` with `listing_unavailable`. A removed listing returns `404`. Both are non-billable. - **Documentation:** [https://scrappa.co/docs/housesigma-api/housesigma_listing](https://scrappa.co/docs/housesigma-api/housesigma_listing) - **API group:** HouseSigma API - **Endpoint:** `GET https://scrappa.co/api/housesigma/listing` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | Listing id from search, for example ZxwR7Mj4Jve3KabB. | ## Example request ```bash #!/bin/bash curl -X GET \ -H "x-api-key: YOUR_API_KEY_HERE" \ "https://scrappa.co/api/housesigma/listing?id=ZxwR7Mj4Jve3KabB" ``` ## Example response ```json { "success": true, "listing": { "id": "ZxwR7Mj4Jve3KabB", "address_id": "0A9X3jP8xJEyvgxV", "ml_num": "W13861182", "url": "https://housesigma.com/on/toronto-real-estate/39-exeter-street/home/0A9X3jP8xJEyvgxV/", "title": "39 Exeter Street, Toronto, Ontario For Sale | HouseSigma", "address": "39 Exeter Street", "price": { "amount": 930000, "currency": "CAD", "abbr": "0.93M", "gated": false }, "status": { "kind": "sale", "text": "For Sale", "code": "A", "live": true }, "property_type": { "code": "S.", "label": "Semi-Detached" }, "location": { "lat": 43.67327, "lon": -79.4558 }, "community": { "id": 108, "name": "Weston-Pellam Park" }, "municipality": { "id": 10343, "name": "Toronto", "area": "All GTA - Central" }, "province": "ON", "cross_street": "St Clair Ave/Caledonia Rd", "bedrooms": 3, "bedrooms_extra": 1, "bathrooms": 2, "parking": { "total": 2, "garage": 2, "garage_type": "Detached", "text": "Detached 2 garages" }, "area": { "text": "1100-1500", "min": 1100, "max": 1500, "unit": "feet\u00b2" }, "lot": { "front": 18, "depth": 110, "area": 1980, "unit": "feet", "text": "18 x 110 feet" }, "fees": { "tax": 4540, "tax_note": "$4,540 / 2025", "maintenance": null }, "dates": { "listed_at": "2026-10-05", "updated_at": "2026-10-25", "days_on_site": 21 }, "description": "Green with Envy! Imagine having Wadsworth Park practically as your backyard.", "photos": [ "https://cache-e15.housesigma.com/file/pix-treb/W13861182/e3665_1.jpg?7f6b4e72" ], "agency": { "name": "SUTTON GROUP REALTY SYSTEMS INC." }, "key_facts": [ { "name": "Lot Size", "value": "18 x 110 feet" }, { "name": "Tax", "value": "$4,540 / 2025" } ], "details": [ { "group": "Property", "items": [ { "name": "Property Type", "value": "Semi-Detached" } ] } ], "rooms": [ { "type": "Living Room", "level": "Main", "size_m": "3.3 x 3", "size_ft": "10.8 x 9.8", "features": "Ceramic Floor,Open Concept,Window" } ], "history": [ { "listing_id": "ZxwR7Mj4Jve3KabB", "ml_num": "W13861182", "status": "For Sale", "kind": "sale", "price": 930000, "date_start": null, "date_end": null } ], "schools": [ { "name": "St. Demetrius Catholic School", "board": "Toronto Catholic District School Board", "level": "Elementary", "distance_m": 5469, "score": 7.7 } ], "community_stats": { "period_name": "September 2026", "price_sold_median": 963750, "sold_count": 3, "dom_avg": 21 }, "estimate": { "price": null, "rent": 3872, "rent_yield": 4.08 }, "open_houses": [], "faq": [ { "question": "How many bedrooms and bathrooms does 39 Exeter Street, Toronto, ON have?", "answer": "3 bedrooms plus 1 additional room and 2 bathrooms." } ], "data_source": "PROPTX" }, "meta": { "endpoint_family": "listing", "billable": true, "attempts": 1 } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 404 | Not Found | No HouseSigma listing has that id, or the listing was removed (`not_found`). Non-billable. | | 503 | Listing Unavailable | HouseSigma shows this listing only to signed-in users (`listing_unavailable`). Scrappa never uses accounts, so the listing cannot be returned. Non-billable. | | 422 | Validation Error | A query parameter is missing, unknown or unusable, for example `page` above 200. Unknown parameters are rejected, never ignored. Non-billable. | | 503 | Upstream Unavailable | HouseSigma could not be reached after retries, answered with an error, or returned an unexpected answer (`upstream_unavailable`, `upstream_blocked`, `token_unavailable`, `upstream_changed`). Retryable and never billed. Clients are never rate limited. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)