--- title: "Rentals.ca API: Search | Perceptlayer" description: "Search from Rentals.ca as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/rentals-ca/search --- [APIs](https://perceptlayer.com/apis) / [Rentals.ca](https://perceptlayer.com/apis/rentals-ca) / Search # Rentals.ca: Search Search from Rentals.ca as JSON. 1 credit per successful call. GET `/v1/rentals-ca/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `city` | string | Optional | Up to 60 characters | | `region` | string | Optional | AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT, ab, bc, mb, nb, nl, ns, nt, nu, on, pe, qc, sk, yt | | `location` | string | Optional | Up to 80 characters | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_beds` | integer | Optional | Any | | `max_beds` | integer | Optional | Any | | `min_baths` | number | Optional | Any | | `max_baths` | number | Optional | Any | | `min_size` | integer | Optional | Any | | `max_size` | integer | Optional | Any | | `property_type[]` | list of string | Optional | condo, condo\_community, apartment, studio, bachelor, house, town\_house, multi\_unit, cabin, cottage, single\_family\_home, duplex, triplex, fourplex, semi\_house, mobile\_home, garden\_home, garage\_suite, town\_house\_community, home\_community, basement, main\_floor, loft, room, private\_room, shared\_room, office, retail, industrial | | `categories[]` | list of string | Optional | cheap\_rentals, co\_op\_housing, corporate\_housing, luxury\_rentals, senior\_housing, student\_housing, family\_housing, veteran\_housing, sublet, vacation | | `lease_terms[]` | list of string | Optional | short, long, no\_long, no\_short | | `furnished[]` | list of string | Optional | fully, partially, no, yes, mixed | | `parking_types[]` | list of string | Optional | no\_parking, garage, driveway, underground, street, visitor, outdoor, indoor, covered, electric, valet | | `amenities[]` | list of string | Optional | building-features:24h-security, building-features:bbq-area-courtyard, building-features:bike-racks, building-features:bike-room, building-features:buzzer-entry, building-features:central-air-conditioning, building-features:concierge, building-features:deck, building-features:door-person, building-features:dry-cleaning-service, building-features:electric-vehicle-charger, building-features:elevator, building-features:exercise-room, building-features:fitness-area, building-features:garage, building-features:guest-suite, building-features:intercom, building-features:jacuzzi, building-features:laundry-facilities, building-features:movie-room, building-features:on-site-maintenance, building-features:on-site-management, building-features:on-site-staff, building-features:package-service, building-features:parking-covered, building-features:parking-driveway, building-features:parking-electric, building-features:parking-garage, building-features:parking-indoor, building-features:parking-outdoor, building-features:parking-parallel, building-features:parking-street, building-features:parking-tandem, building-features:parking-underground, building-features:parking-valet, building-features:parking-visitor, building-features:party-room, building-features:pet-friendly, building-features:pool-heated, building-features:pool-rooftop, building-features:professionally-managed, building-features:recreation-room, building-features:recycling, building-features:resident-managers, building-features:rooftop-deck, building-features:rooftop-garden, building-features:rooftop-lounge, building-features:sauna, building-features:secured-access, building-features:security-on-site, building-features:storage-lockers, building-features:swimming-pool, building-features:tennis-court, building-features:theatre-room, building-features:video-surveillance, commercial-building:commercial-access-gate, commercial-building:commercial-air-conditioning, commercial-building:commercial-heating, commercial-building:commercial-loading-dock, commercial-building:commercial-security-guard, nearby:24h-emergency, nearby:atm, nearby:bank, nearby:bars, nearby:bike-trails, nearby:bus-stop, nearby:cafe, nearby:convenience-store, nearby:daycare, nearby:dog-park, nearby:gas-station, nearby:grocery-store, nearby:gym, nearby:highway, nearby:hospital, nearby:movie-theater, nearby:parks, nearby:playground, nearby:pool, nearby:public-library, nearby:public-transit, nearby:recreation, nearby:restaurants, nearby:running-path, nearby:school, nearby:schools, nearby:shopping, nearby:shopping-centre, other:business-center, other:ceiling-fan, other:no-smoking-allowed, other:smoking-permitted, unit-features:air-conditioning, unit-features:alarm-system, unit-features:backyard, unit-features:balcony, unit-features:bbq-grill, unit-features:blinds, unit-features:cable-ready, unit-features:dishwasher, unit-features:dryer, unit-features:ensuite-laundry, unit-features:fireplace, unit-features:flooring-carpeted, unit-features:flooring-ceramic, unit-features:flooring-hardwood, unit-features:flooring-laminate, unit-features:flooring-laminate-hardwood, unit-features:flooring-tile, unit-features:flooring-vinyl, unit-features:flooring-wood, unit-features:freshly-painted, unit-features:fridge, unit-features:furnished, unit-features:garburator, unit-features:garden, unit-features:gas-heating, unit-features:granite-countertops, unit-features:high-ceilings, unit-features:hot-tub, unit-features:individual-thermostats, unit-features:island, unit-features:microwave, unit-features:new-appliances, unit-features:newly-renovated, unit-features:outdoor-space, unit-features:parking, unit-features:patio, unit-features:pool-private, unit-features:private-entry, unit-features:private-yard, unit-features:radiant-heat, unit-features:security-cameras, unit-features:shared-yard, unit-features:storage, unit-features:stove, unit-features:terrace, unit-features:walk-in-closet, unit-features:washer, unit-features:wheelchair-access, unit-features:window-coverings, utilities:cable, utilities:heating, utilities:hydro-electricity, utilities:internet-wifi, utilities:not-included, utilities:satellite-tv, utilities:water | | `pets` | string | Optional | all, none | | `verified` | boolean | Optional | Any | | `has_images` | boolean | Optional | Any | | `sort` | string | Optional | relevant, recent, cheapest, expensive, newest, ranked | | `page` | integer | Optional | Any | | `per_page` | integer | Optional | Any | ## Example request Rentals.ca GET /v1/rentals-ca/search?city=Toronto®ion=ON&max\_price=3000&min\_beds=2&sort=cheapest ``` { "success": true, "data": { "search_metadata": { "status": "Success", "total_floor_plans": 3952 }, "search_parameters": { "place": "toronto, on, ca", "sort": "cheapest", "filters": { "max_price": "3000", "min_beds": "2" } }, "total": 2280, "filtered_count": 18, "page": 1, "per_page": 20, "has_next_page": true, "next_page": 2, "warning": "Some buildings were left out because none of their units fit the filters. A page can hold fewer than per_page listings.", "listings": [ { "id": "cmVudGFsbGlzdGluZzo5MTM4OTE=", "path": "toronto/davisville-avenue-id913891", "url": "https://rentals.ca/toronto/davisville-avenue-id913891", "name": "Davisville Avenue", "type": "shared_room", "listing_type": "residential:room:shared-room", "verified": true, "beds": { "min": 2, "max": 2 }, "baths": { "min": 1, "max": 1 }, "rent": { "min": 450, "max": 450 }, "size": {}, "floor_plans": [ { "beds": 2, "baths": 1, "rent": 450, "available_now": false } ], "latitude": 43.70075, "longitude": -79.39088, "address": { "street": "Uptown", "postal_code": "M4S 1G7", "city": "Toronto", "city_path": "toronto", "region": "ON", "address_hidden": false }, "thumbnail": { "small": "https://images.rentals.ca/property-pictures/small/toronto-on/913891/shared-room-2237881593.jpg", "medium": "https://images.rentals.ca/property-pictures/medium/toronto-on/913891/shared-room-2237881593.jpg", "large": "https://images.rentals.ca/property-pictures/large/toronto-on/913891/shared-room-2237881593.jpg" }, "images_count": 3, "created": "2024-11-28T15:54:00.179086+00:00", "modified": "2026-11-12T07:48:59.251178+00:00" }, { "id": "cmVudGFsbGlzdGluZzo5MTQ3MzU=", "path": "toronto/niska-road", "url": "https://rentals.ca/toronto/niska-road", "name": "Niska Road", "type": "room", "listing_type": "residential:room:room", "verified": true, "beds": { "min": 2, "max": 2 }, "baths": { "min": 1, "max": 1 }, "rent": { "min": 650, "max": 650 }, "size": {}, "floor_plans": [ { "beds": 2, "baths": 1, "rent": 650, "available_now": false } ], "latitude": 43.7644, "longitude": -79.5094, "address": { "street": "Niska Road", "postal_code": "M3N 2S3", "city": "Toronto", "city_path": "toronto", "region": "ON", "address_hidden": false }, "thumbnail": { "small": "https://images.rentals.ca/property-pictures/small/toronto-on/914735/room-2237886161.jpg", "medium": "https://images.rentals.ca/property-pictures/medium/toronto-on/914735/room-2237886161.jpg", "large": "https://images.rentals.ca/property-pictures/large/toronto-on/914735/room-2237886161.jpg" }, "images_count": 5, "created": "2024-11-28T15:55:15.867977+00:00", "modified": "2026-11-12T07:50:05.504158+00:00" }, { "id": "cmVudGFsbGlzdGluZzoxNjA1OTM2", "path": "toronto/roomies-1605936", "url": "https://rentals.ca/toronto/roomies-1605936", "name": "Rose Avenue", "type": "room", "listing_type": "residential:room:room", "verified": true, "beds": { "min": 2, "max": 2 }, "baths": { "min": 1, "max": 1 }, "rent": { "min": 790, "max": 790 }, "size": {}, "floor_plans": [ { "beds": 2, "baths": 1, "rent": 790, "available_now": false } ], "latitude": 43.66937, "longitude": -79.37045, "address": { "street": "Rose Avenue", "postal_code": "M4X 1P1", "city": "Toronto", "city_path": "toronto", "region": "ON", "neighbourhood": "St. James Town", "neighbourhood_path": "toronto/st-james-town", "address_hidden": false }, "thumbnail": { "small": "https://cloudinary.roomies.pics/image/upload/c_scale,dpr_1.0,f_jpg,fl_lossy,q_auto:good,w_672/ednvdwgteyx1f6wfrixx", "medium": "https://cloudinary.roomies.pics/image/upload/c_scale,dpr_1.0,f_jpg,fl_lossy,q_auto:good,w_672/ednvdwgteyx1f6wfrixx", "large": "https://cloudinary.roomies.pics/image/upload/c_scale,dpr_1.0,f_jpg,fl_lossy,q_auto:good,w_672/ednvdwgteyx1f6wfrixx" }, "images_count": 3, "created": "2026-11-06T07:30:15.905608+00:00", "modified": "2026-11-12T07:31:49.102006+00:00" } ] }, "meta": { "endpoint_family": "search", "request_id": "req_deb4fde8df4c4fd7b8f7af98d721aa65", "credits_charged": 1, "credits_remaining": 1814 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/rentals-ca?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.