--- title: "Condos.ca API: JSON data, 6 endpoints, 1 credit per call" description: "Condos.ca API for Canadian condos and townhouses for sale or rent, MLS listing details, buildings and agents as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/condos-ca --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Condos.ca 1 credit per call 6 endpoints 35 datapoints # Condos.ca API Condos.ca API for Canadian condos and townhouses for sale or rent, MLS listing details, buildings and agents as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Condos.ca GET /v1/condos-ca/search?area\_id=1&area\_type=Locality&mode=sale&min\_price=500000&max\_price=800000&beds=2&sort=price\_asc ``` { "success": true, "data": { "search_metadata": { "mode": "sale", "sort": "price_asc", "area_id": 1, "area_type": "Locality" }, "pagination": { "page": 1, "per_page": 48, "total": 1032, "last_page": 22 }, "items": [ { "id": 2375394, "mls_number": "W14100176", "url": "https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd/unit-219A-W14100176", "offer": "Sale", "status": "Active", "title": "219A - 700 Humberwood Boulevard", "home_type": "Condo", "property_type": "Condo Apt", "sub_type": "Condo Apartment", "unit_number": "219A", "price": 500000, "maintenance_fee": 543.9, "tax": 2044, "tax_year": 2025, "bedrooms": 2, "bed_type": "2", "bathrooms": 1, "sqft": { "min": 800, "max": 899 }, "parking": { "spots": 1, "type": "Underground" }, "locker": { "has_locker": true, "type": "Exclusive" }, "has_balcony": true, "outdoor_space": "Balcony, Patio", "exposure": "SW", "pets_permitted": "Restrict", "amenities": [ "Concierge", "Party Room", "Visitor Parking" ], "tags": [ "High-Rise" ], "building": { "id": 980, "age": "18", "age_max": 18 }, "location": { "latitude": 43.7242482, "longitude": -79.6162362, "street": "Humberwood Boulevard", "neighbourhood": { "id": 803, "name": "West Humber | Clairville" }, "sublocality": { "id": 16, "name": "Etobicoke" }, "locality": { "id": 1, "name": "Toronto" }, "region": { "id": 1, "name": "Toronto Division" }, "province": { "id": 9, "name": "Ontario" }, "country": "Canada" }, "photo_count": 11, "thumbnail_url": "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg?width=640", "images": [ "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg", "https://cdn.repliers.io/IMG-W14100176_f2f0cdc4dc34caab52815893c3cb94f593d08b102c9aef88c72fb16a37d8308f.jpg", "https://cdn.repliers.io/IMG-W14100176_4378fe7f548ab91b753ec11339dd451b424cd738198ed340a872f5dcdd3bded4.jpg" ], "entry_date": "2026-10-20", "days_on_market": 23, "date_available": "2027-01-31", "brokerage": "RE/MAX WEST REALTY INC." }, { "id": 2335013, "mls_number": "W13773268", "url": "https://condos.ca/toronto/eleven-superior-11-superior-ave/unit-TH1-W13773268", "offer": "Sale", "status": "Active", "title": "TH1 - 11 Superior Avenue", "home_type": "Townhouse", "property_type": "Condo Townhouse", "sub_type": "Townhouse", "unit_number": "TH1", "price": 500000, "maintenance_fee": 966.21, "tax": 3420, "tax_year": 2026, "bedrooms": 2, "bed_type": "2", "bathrooms": 2, "sqft": { "min": 900, "max": 999, "value": 946 }, "parking": { "spots": 1, "type": "Underground" }, "locker": { "has_locker": true, "type": "Owned" }, "has_balcony": true, "outdoor_space": "Balcony, Patio", "exposure": "W", "pets_permitted": "Restrict", "amenities": [ "Rooftop Deck", "Visitor Parking", "Party Room" ], "tags": [ "Mid-Rise" ], "building": { "id": 1422, "age": "10", "age_max": 10 }, "location": { "latitude": 43.6152271, "longitude": -79.4890168, "street": "Superior Avenue", "neighbourhood": { "id": 788, "name": "Mimico" }, "sublocality": { "id": 16, "name": "Etobicoke" }, "locality": { "id": 1, "name": "Toronto" }, "region": { "id": 1, "name": "Toronto Division" }, "province": { "id": 9, "name": "Ontario" }, "country": "Canada" }, "photo_count": 28, "thumbnail_url": "https://cdn.repliers.io/IMG-W13773268_69b4ec21-2501-4795-afba-a43ab9b43c00-l.jpg?width=640", "images": [ "https://cdn.repliers.io/IMG-W13773268_69b4ec21-2501-4795-afba-a43ab9b43c00-l.jpg", "https://cdn.repliers.io/IMG-W13773268_b1393056-a1ec-4564-bed1-3731fef12eba-l.jpg", "https://cdn.repliers.io/IMG-W13773268_bfc8640b-61ec-432b-8e18-d2cd2ac930b0-l.jpg" ], "tour_url": "https://houses-by-hilary.aryeo.com/sites/11-superior-avenue-th1-toronto-on-m8v0a7-8264830/branded", "entry_date": "2026-09-11", "days_on_market": 62, "date_available": "60-89 days", "brokerage": "RE/MAX REALTY ENTERPRISES INC." }, { "id": 2304626, "mls_number": "W13668386", "url": "https://condos.ca/toronto/westline-condos-1100-sheppard-ave-w/unit-217-W13668386", "offer": "Sale", "status": "Active", "title": "217 - 1100 Sheppard Avenue W", "home_type": "Condo", "property_type": "Condo Apt", "sub_type": "Condo Apartment", "unit_number": "217", "price": 500000, "maintenance_fee": 597.73, "tax": 2639.55, "tax_year": 2025, "bedrooms": 2, "bed_type": "2", "bathrooms": 2, "sqft": { "min": 700, "max": 799, "value": 750 }, "parking": { "spots": 0, "type": "Owned" }, "locker": { "has_locker": false, "type": "None" }, "has_balcony": true, "outdoor_space": "Balcony, Patio", "exposure": "S", "pets_permitted": "Restrict", "amenities": [ "Concierge", "Guest Suites", "Gym" ], "tags": [ "High-Rise" ], "building": { "id": 12287, "age": "2", "age_max": 2 }, "location": { "latitude": 43.751927, "longitude": -79.4666946, "street": "Sheppard Avenue West", "neighbourhood": { "id": 837, "name": "York University Heights" }, "sublocality": { "id": 17, "name": "North York" }, "locality": { "id": 1, "name": "Toronto" }, "region": { "id": 1, "name": "Toronto Division" }, "province": { "id": 9, "name": "Ontario" }, "country": "Canada" }, "photo_count": 42, "thumbnail_url": "https://cdn.repliers.io/IMG-W13668386_1.jpg?width=640", "images": [ "https://cdn.repliers.io/IMG-W13668386_1.jpg", "https://cdn.repliers.io/IMG-W13668386_2.jpg", "https://cdn.repliers.io/IMG-W13668386_3.jpg" ], "entry_date": "2026-08-12", "days_on_market": 92, "date_available": "30-59 days", "brokerage": "CENTURY 21 ATRIA REALTY INC." } ] }, "meta": { "endpoint_family": "search", "request_id": "req_f49536ca8f7443d8ae10ec8ed41fb31e", "credits_charged": 1, "credits_remaining": 1880 } } ``` 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 integer | mls\_number string | url url | offer string | status string | title string | home\_type string | property\_type string | sub\_type string | unit\_number string | price integer | maintenance\_fee number | tax number | tax\_year integer | bedrooms integer | bed\_type string | bathrooms integer | sqft object | parking object | locker object | has\_balcony boolean | outdoor\_space string | exposure string | pets\_permitted string | amenities string\[\] | tags string\[\] | building object | location object | photo\_count integer | thumbnail\_url url | images string\[\] | entry\_date string | days\_on\_market integer | date\_available string | brokerage string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 2375394 | W14100176 | https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd/unit-219A-W14100176 | Sale | Active | 219A - 700 Humberwood Boulevard | Condo | Condo Apt | Condo Apartment | 219A | 500000 | 543.9 | 2044 | 2025 | 2 | 2 | 1 | {2 fields} | {2 fields} | {2 fields} | true | Balcony, Patio | SW | Restrict | \[3 items\] | \[1 item\] | {3 fields} | {9 fields} | 11 | https://cdn.repliers.io/IMG-W14100176\_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg?width=640 | \[3 items\] | 2026-10-20 | 23 | 2027-01-31 | RE/MAX WEST REALTY INC. | | 2 | 2335013 | W13773268 | https://condos.ca/toronto/eleven-superior-11-superior-ave/unit-TH1-W13773268 | Sale | Active | TH1 - 11 Superior Avenue | Townhouse | Condo Townhouse | Townhouse | TH1 | 500000 | 966.21 | 3420 | 2026 | 2 | 2 | 2 | {3 fields} | {2 fields} | {2 fields} | true | Balcony, Patio | W | Restrict | \[3 items\] | \[1 item\] | {3 fields} | {9 fields} | 28 | https://cdn.repliers.io/IMG-W13773268\_69b4ec21-2501-4795-afba-a43ab9b43c00-l.jpg?width=640 | \[3 items\] | 2026-09-11 | 62 | 60-89 days | RE/MAX REALTY ENTERPRISES INC. | | 3 | 2304626 | W13668386 | https://condos.ca/toronto/westline-condos-1100-sheppard-ave-w/unit-217-W13668386 | Sale | Active | 217 - 1100 Sheppard Avenue W | Condo | Condo Apt | Condo Apartment | 217 | 500000 | 597.73 | 2639.55 | 2025 | 2 | 2 | 2 | {3 fields} | {2 fields} | {2 fields} | true | Balcony, Patio | S | Restrict | \[3 items\] | \[1 item\] | {3 fields} | {9 fields} | 42 | https://cdn.repliers.io/IMG-W13668386\_1.jpg?width=640 | \[3 items\] | 2026-08-12 | 92 | 30-59 days | CENTURY 21 ATRIA REALTY INC. | Recorded from our API · 3 items shown · 35 datapoints per item GET /v1/condos-ca/search?area\_id=1&area\_type=Locality&mode=sale&min\_price=500000&max\_price=800000&beds=2&sort=price\_asc 35 datapoints ### Identity - id integer - status string - title string - home\_type string - property\_type string - sub\_type string - bed\_type string ### Contact - url url - thumbnail\_url url ### Location - location object ### Reputation - photo\_count integer - images string\[\] ### Price - price integer - maintenance\_fee number ### Other - mls\_number string - offer string - unit\_number string - tax number - tax\_year integer - bedrooms integer - bathrooms integer - sqft object - parking object - locker object - has\_balcony boolean - outdoor\_space string - exposure string - pets\_permitted string - amenities string\[\] - tags string\[\] - building object - entry\_date string - days\_on\_market integer - date\_available string - brokerage string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/condos-ca/search?area_id=1&area_type=Locality&mode=sale&min_price=500000&max_price=800000&beds=2&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` Condos.ca · 6 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/condos-ca/agent`](https://perceptlayer.com/apis/condos-ca/agent) | `url` | 1 credit | | [GET `/v1/condos-ca/agents`](https://perceptlayer.com/apis/condos-ca/agents) | `query` +2 optional | 1 credit | | [GET `/v1/condos-ca/autocomplete`](https://perceptlayer.com/apis/condos-ca/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/condos-ca/buildings`](https://perceptlayer.com/apis/condos-ca/buildings) | none +4 optional | 1 credit | | [GET `/v1/condos-ca/listing`](https://perceptlayer.com/apis/condos-ca/listing) | `mls_number` | 1 credit | | [GET `/v1/condos-ca/search`](https://perceptlayer.com/apis/condos-ca/search) | `area_id` `area_type` +22 optional | 1 credit | Overview ## About the Condos.ca API ## What you can get The Condos.ca API returns Condos.ca listing data for Canada as JSON through 6 endpoints. - **Search:** `search` takes an `area_id` and an `area_type` (Locality, Sublocality, Neighbourhood, LocalityParent or LocalityGrandparent), with `mode` (sale or rent), `min_price`, `max_price`, `beds`, `min_baths`, `min_sqft`, `max_sqft`, `home_type` (Condo, Townhouse, House or Other), `property_type`, `parking`, `locker`, `balcony`, `furnished` (Yes, No or Part), `exposure`, `amenities`, `max_maintenance_fee`, `max_building_age`, `max_days_on_market`, `min_photos`, `sort` (newest, price\_asc, price\_desc or beds\_desc), `page` and `per_page`. - **Listings:** `listing` takes an `mls_number`. - **Buildings:** `buildings` takes a `query` or an `id`, with `limit` and `page`. - **Agents:** `agents` takes a `query`, with `limit` and `page`; `agent` takes an agent `url`, such as condo-pros/magda-smith. - **Autocomplete:** `autocomplete` takes `q`, with `limit`. The recorded `search` ( `area_id=1`, `area_type=Locality`, `mode=sale`, `min_price=500000`, `max_price=800000`, `beds=2`, `sort=price_asc`) for Toronto returns `items`, each with `id`, `mls_number`, `url`, `status`, `title`, `home_type`, `unit_number`, `price`, `maintenance_fee`, `tax`, `bedrooms`, `bathrooms`, `sqft`, `parking`, `locker`, `has_balcony`, `exposure`, `pets_permitted`, `amenities`, `building`, `location`, `days_on_market` and `brokerage`. Its `pagination` gives `total` (1,032), `per_page` and `last_page`. ## How a call works Search two-bedroom condos for sale in Toronto: `GET /v1/condos-ca/search?area_id=1&area_type=Locality&mode=sale&min_price=500000&max_price=800000&beds=2&sort=price_asc` with your key in the `X-API-Key` header. Each item's `mls_number` goes to `listing`, and its `building.id` goes to `buildings` as `id`. Each item's `location` names its neighbourhood, sublocality and locality with their IDs, which go back into `search` as `area_id` with the matching `area_type`. 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 condo asking prices and rents by Toronto neighbourhood `Use the Condos.ca API to track condo asking prices and rents by Toronto neighbourhood` ### Compare maintenance fees and property tax across buildings `Use the Condos.ca API to compare maintenance fees and property tax across buildings` ### Screen units by exposure, parking, locker and balcony `Use the Condos.ca API to screen units by exposure, parking, locker and balcony` ### Watch fresh listings with \`max\_days\_on\_market\` or \`sort=newest\` `` Use the Condos.ca API to watch fresh listings with `max_days_on_market` or `sort=newest` `` FAQ ## Questions **Do I need a Condos.ca account?** No. You call this Condos.ca API with your Perceptlayer key in the \`X-API-Key\` header, with no Condos.ca login. **How much does the Condos.ca 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. **Can I look up a listing by MLS number?** Yes. Pass it to \`listing\` as \`mls\_number\`, such as W14100176. **Should I build a Condos.ca scraper instead?** You can, but a Condos.ca scraper is code you maintain: page changes break it, requests get blocked, and Condos.ca's terms govern how you collect data. The Condos.ca API gives you 6 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 Condos.ca 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)