> For the complete documentation index, see [llms.txt](https://streasy.gitbook.io/realtor.ca-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://streasy.gitbook.io/realtor.ca-api/realtor-active-sales-search-api.md).

# Realtor Active Sales Search API

Search Canadian residential for-sale listings from Realtor.ca. All query parameters are optional. Returns a paginated list of matching listings with summary fields.

### Request Parameters

<table><thead><tr><th>Parameter</th><th>Description</th><th width="153">Required</th></tr></thead><tbody><tr><td>province</td><td>Exact province name (e.g. <code>Ontario</code>, <code>British Columbia</code>, <code>Quebec</code>). Optional.</td><td>FALSE</td></tr><tr><td>city</td><td>Exact city name. Optional.</td><td>FALSE</td></tr><tr><td>neighbourhood</td><td>Exact neighbourhood name. Optional.</td><td>FALSE</td></tr><tr><td>minLat</td><td>Southern edge of the search bounding box (latitude). Optional; if any bbox param is set, all four are required.</td><td>FALSE</td></tr><tr><td>maxLat</td><td>Northern edge of the search bounding box (latitude). Optional; if any bbox param is set, all four are required.</td><td>FALSE</td></tr><tr><td>minLng</td><td>Western edge of the search bounding box (longitude). Optional; if any bbox param is set, all four are required.</td><td>FALSE</td></tr><tr><td>maxLng</td><td>Eastern edge of the search bounding box (longitude). Optional; if any bbox param is set, all four are required.</td><td>FALSE</td></tr><tr><td>minPrice</td><td>Minimum listing price in CAD. Default: <code>0</code>.</td><td>FALSE</td></tr><tr><td>maxPrice</td><td>Maximum listing price in CAD. Default: <code>1000000000</code>.</td><td>FALSE</td></tr><tr><td>minBeds</td><td>Minimum number of bedrooms. Default: <code>0</code>.</td><td>FALSE</td></tr><tr><td>maxBeds</td><td>Maximum number of bedrooms. Default: <code>100</code>.</td><td>FALSE</td></tr><tr><td>minBaths</td><td>Minimum number of bathrooms. Default: <code>0</code>.</td><td>FALSE</td></tr><tr><td>propertyType</td><td>Property type filter. One of: <code>Single Family</code>, <code>Vacant Land</code>, <code>Multi-family</code>, <code>Agriculture</code>, <code>Recreational</code>, <code>Parking</code>. Comma-separated for multiple. Optional.</td><td>FALSE</td></tr><tr><td>maxHoa</td><td>Maximum monthly HOA / condo fees. Default: <code>100000</code>.</td><td>FALSE</td></tr><tr><td>minSqft</td><td>Minimum living area in square feet. Default: <code>0</code>.</td><td>FALSE</td></tr><tr><td>maxSqft</td><td>Maximum living area in square feet. Default: <code>10000000</code>.</td><td>FALSE</td></tr><tr><td>limit</td><td>Number of results to return per page (max <code>500</code>). Default: <code>100</code>.</td><td>FALSE</td></tr><tr><td>offset</td><td>Number of results to skip for pagination. Default: <code>0</code>.</td><td>FALSE</td></tr></tbody></table>

### Sample Request

```
curl --request GET \
  --url 'https://canada-real-estate-api.p.rapidapi.com/sales/search?province=Ontario&minLat=43.5&maxLat=43.9&minLng=-79.7&maxLng=-79.1&minPrice=500000&maxPrice=1500000&minBeds=2&maxBeds=4&minBaths=1&minSqft=800&maxSqft=2500&maxHoa=800&limit=25&offset=0' \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-host: canada-real-estate-api.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
```

### Sample Response

```
{
  "pagination": {
    "count": 4004,
    "nextOffset": 10
  },
  "listings": [
    {
      "mls_number": "X12993768",
      "property_id": 29599481,
      "price": 668000,
      "latitude": 43.67726135253906,
      "longitude": -79.11370849609375,
      "url": "https://realtor.ca/real-estate/29599481/15-wylie-way-carleton-place-909-carleton-place",
      "address": "15 WYLIE WAY|Carleton Place, Ontario K7C0C4",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W9387650",
      "property_id": 27517914,
      "price": 1200000,
      "latitude": 43.546913146972656,
      "longitude": -79.58910369873047,
      "url": "https://realtor.ca/real-estate/27517914/1305-220-missinnihe-way-mississauga-port-credit",
      "address": "1305 - 220 MISSINNIHE WAY|Mississauga (Port Credit), Ontario L5H0A9",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664966",
      "property_id": 30144274,
      "price": 1249000,
      "latitude": 43.74833679199219,
      "longitude": -79.56525421142578,
      "url": "https://realtor.ca/real-estate/30144274/2-grenadine-court-toronto-humber-summit",
      "address": "2 GRENADINE COURT|Toronto (Humber Summit), Ontario M9L2H6",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664814",
      "property_id": 30144147,
      "price": 697777,
      "latitude": 43.52515411376953,
      "longitude": -79.68811798095703,
      "url": "https://realtor.ca/real-estate/30144147/122-3050-orleans-road-mississauga-erin-mills",
      "address": "122 - 3050 ORLEANS ROAD|Mississauga (Erin Mills), Ontario L5L5P7",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664692",
      "property_id": 30143853,
      "price": 998000,
      "latitude": 43.678565979003906,
      "longitude": -79.56901550292969,
      "url": "https://realtor.ca/real-estate/30143853/127-redgrave-drive-toronto-willowridge-martingrove-richview",
      "address": "127 REDGRAVE DRIVE|Toronto (Willowridge-Martingrove-Richview), Ontario M9R3V5",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664492",
      "property_id": 30143672,
      "price": 949000,
      "latitude": 43.61766815185547,
      "longitude": -79.57750701904297,
      "url": "https://realtor.ca/real-estate/30143672/13-3071-treadwells-drive-mississauga-applewood",
      "address": "13 - 3071 TREADWELLS DRIVE|Mississauga (Applewood), Ontario L4X0A1",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664446",
      "property_id": 30143663,
      "price": 899000,
      "latitude": 43.64045715332031,
      "longitude": -79.55618286132812,
      "url": "https://realtor.ca/real-estate/30143663/22-lormar-drive-toronto-islington-city-centre-west",
      "address": "22 LORMAR DRIVE|Toronto (Islington-City Centre West), Ontario M9B4V7",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664320",
      "property_id": 30143307,
      "price": 1199000,
      "latitude": 43.5377197265625,
      "longitude": -79.6015853881836,
      "url": "https://realtor.ca/real-estate/30143307/644-sweetwater-place-mississauga-lorne-park",
      "address": "644 SWEETWATER PLACE|Mississauga (Lorne Park), Ontario L5H3Y8",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13664186",
      "property_id": 30143295,
      "price": 859900,
      "latitude": 43.767311096191406,
      "longitude": -79.52590942382812,
      "url": "https://realtor.ca/real-estate/30143295/111-shoreham-drive-toronto-black-creek",
      "address": "111 SHOREHAM DRIVE|Toronto (Black Creek), Ontario M3N1S8",
      "city": "",
      "province": "Ontario"
    },
    {
      "mls_number": "W13663882",
      "property_id": 30142905,
      "price": 949900,
      "latitude": 43.76077651977539,
      "longitude": -79.49317932128906,
      "url": "https://realtor.ca/real-estate/30142905/27-villata-gardens-toronto-york-university-heights",
      "address": "27 VILLATA GARDENS|Toronto (York University Heights), Ontario M3J1J7",
      "city": "",
      "province": "Ontario"
    }
  ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://streasy.gitbook.io/realtor.ca-api/realtor-active-sales-search-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.