Skip to content
Scrappa Get API key
Condos.ca API 1 credit/request

Condos.ca Search API Documentation

GET https://scrappa.co/api/condos-ca/search

Condos.ca Search API lists condos, townhouses and rentals in one area. Get area_id and area_type from the autocomplete route. Use mode=rent for rentals. Every item matches all filters you send. pagination.page is the page you asked for, and a page past last_page returns an empty items list. Sort is newest, price_asc, price_desc or beds_desc. Contact details of agents are never returned. Failed requests are not billed.

Condos.ca Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/condos-ca/search
Auth header
x-api-key
Cost
1 credit/request
area_id = 1234567890 area_type = example
Response preview
200 OK
{
    "data": {
        "items": [
            {
                "id": 2375394,
                "tax": 2044,
                "url": "https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd/unit-219A-W14100176",
                "sqft": {
                    "max": 899,
                    "min": 800,
                    "value": null
                },
                "tags": [
                    "High-Rise"
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

2 required parameters needed before sending a request.

22 optional filters available.

area_id integer Required

Required. The area_id of an autocomplete item. Example: 1.

Example value 1234567890
area_type string Required

Required. The area_type of the same autocomplete item: Locality, Sublocality, Neighbourhood, LocalityParent or LocalityGrandparent.

Example value example
mode string Optional

sale (default) or rent. Rent prices are monthly.

Example value example
min_price integer Optional

Minimum price in CAD.

Example value 10
max_price integer Optional

Maximum price in CAD. Not below min_price.

Example value 10
beds string Optional

Comma separated: studio, 1, 1_den, 2, 2_den, 3_plus. Example: 2,2_den.

Example value example
min_baths integer Optional

Minimum number of bathrooms.

Example value 10
min_sqft integer Optional

Minimum interior size in square feet.

Example value 10
max_sqft integer Optional

Maximum interior size in square feet.

Example value 10
home_type string Optional

Condo, Townhouse, House or Other.

Example value example
property_type string Optional

Comma separated: Condo Apt, Condo Townhouse, Att/Row/Twnhouse, Comm Element Condo, Co-Op Apt, Co-Ownership Apt, Det Condo, Semi-Det Condo, Leasehold Condo, Phased Condo.

Example value example
parking integer Optional

Minimum number of parking spots.

Example value 10
locker boolean Optional

true for units with a locker, false for units without.

Example value true
balcony boolean Optional

true for units with a balcony, false for units without.

Example value true
furnished string Optional

Yes, No or Part. Most sale listings are No.

Example value example
exposure string Optional

Comma separated: N, S, E, W, NE, NW, SE, SW.

Example value example
amenities string Optional

Comma separated building amenities that must all be present. Example: Gym,Pool,Concierge. Pool also matches indoor and outdoor pools.

Example value example
max_maintenance_fee integer Optional

Maximum monthly maintenance fee in CAD. Listings without a fee are not returned.

Example value 10
max_building_age integer Optional

Maximum building age in years.

Example value 10
max_days_on_market integer Optional

Only listings added within this many days.

Example value 10
min_photos integer Optional

Minimum number of photos.

Example value 10
sort string Optional

newest (default), price_asc, price_desc or beds_desc.

Example value relevance
page integer Optional

One-based page number. Default 1. A page past the last page returns an empty items list.

Example value 1
per_page integer Optional

Listings per page, 1 to 100. Default 48.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "items": [
            {
                "id": 2375394,
                "tax": 2044,
                "url": "https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd/unit-219A-W14100176",
                "sqft": {
                    "max": 899,
                    "min": 800,
                    "value": null
                },
                "tags": [
                    "High-Rise"
                ],
                "offer": "Sale",
                "price": 500000,
                "title": "219A - 700 Humberwood Boulevard",
                "images": [
                    "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg",
                    "https://cdn.repliers.io/IMG-W14100176_f2f0cdc4dc34caab52815893c3cb94f593d08b102c9aef88c72fb16a37d8308f.jpg"
                ],
                "locker": {
                    "type": "Exclusive",
                    "has_locker": true
                },
                "status": "Active",
                "parking": {
                    "type": "Underground",
                    "spots": 1
                },
                "bed_type": "2",
                "bedrooms": 2,
                "building": {
                    "id": 980,
                    "age": "18",
                    "age_max": 18
                },
                "exposure": "SW",
                "location": {
                    "region": {
                        "id": 1,
                        "name": "Toronto Division"
                    },
                    "street": "Humberwood Boulevard",
                    "country": "Canada",
                    "latitude": 43.7242482,
                    "locality": {
                        "id": 1,
                        "name": "Toronto"
                    },
                    "province": {
                        "id": 9,
                        "name": "Ontario"
                    },
                    "longitude": -79.6162362,
                    "sublocality": {
                        "id": 16,
                        "name": "Etobicoke"
                    },
                    "neighbourhood": {
                        "id": 803,
                        "name": "West Humber | Clairville"
                    }
                },
                "sub_type": "Condo Apartment",
                "tax_year": 2025,
                "tour_url": null,
                "amenities": [
                    "Concierge",
                    "Party Room",
                    "Visitor Parking",
                    "Guest Suites",
                    "Meeting Room"
                ],
                "bathrooms": 1,
                "brokerage": "RE/MAX WEST REALTY INC.",
                "furnished": null,
                "home_type": "Condo",
                "entry_date": "2026-10-20",
                "mls_number": "W14100176",
                "has_balcony": true,
                "open_houses": [],
                "photo_count": 11,
                "unit_number": "219A",
                "bedrooms_plus": null,
                "listing_agent": null,
                "outdoor_space": "Balcony, Patio",
                "property_type": "Condo Apt",
                "thumbnail_url": "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg?width=640",
                "date_available": "2027-01-31",
                "days_on_market": 6,
                "pets_permitted": "Restrict",
                "maintenance_fee": 543.9
            }
        ],
        "pagination": {
            "page": 1,
            "total": 1077,
            "per_page": 3,
            "last_page": 359
        },
        "search_metadata": {
            "mode": "sale",
            "sort": "price_asc",
            "area_id": 1,
            "area_type": "Locality"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "area_id": [
            "The area id field is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

Condos.ca could not be reached. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Condos.ca could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.