--- title: "Point2 API: JSON data, 3 endpoints, 1 credit per call" description: "Point2 API for rental homes in Canada and the US, searched by city, price, size, pets and amenities, with listing details as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/point2 --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Point2 1 credit per call 3 endpoints 15 datapoints # Point2 API Point2 API for rental homes in Canada and the US, searched by city, price, size, pets and amenities, with listing details as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Point2 GET /v1/point2/search?country=CA&state=BC&city=Vancouver ``` { "success": true, "data": { "items": [ { "id": "1097386", "url": "https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/Bayview-At-Coal-Harbour-New-0.html", "slug": "bayview-at-coal-harbour-new-0", "title": "Bayview at Coal Harbour", "property_type": "House", "listing_type": "rent", "price": { "display": "$2,195-$4,180", "min": 2195, "max": 4180, "is_starting_price": false, "currency": "CAD", "period": "month" }, "address": { "full": "1529 West Pender Street, Vancouver, BC, V6G 3J3", "city": "Vancouver", "state": "BC", "postal_code": "V6G 3J3" }, "bedrooms": { "label": "Studio-3 beds", "min": 0, "max": 3 }, "bathrooms": { "label": "2 baths", "min": 2, "max": 2 }, "area": { "label": "439-1,700 sqft", "min": 439, "max": 1700, "unit": "sqft" }, "photo": "https://cdngeneral.point2homes.com/dmslivecafe/3/1097386/BCH%20Living%20Room%202%20(2).jpg?width=360&quality=80", "photo_count": 28, "badges": [ "Available now" ], "rating": 4 }, { "id": "2067353", "url": "https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/3449-East-28Th-Ave-B-230014.html", "slug": "3449-east-28th-ave-b-230014", "title": "3449 East 28th Ave/B-230014", "property_type": "House", "listing_type": "rent", "price": { "display": "From $2,300", "min": 2300, "is_starting_price": true, "currency": "CAD", "period": "month" }, "address": { "full": "Vancouver, BC, V5R 1T2", "city": "Vancouver", "state": "BC", "postal_code": "V5R 1T2" }, "bedrooms": { "label": "2 beds", "min": 2, "max": 2 }, "bathrooms": { "label": "2 baths", "min": 2, "max": 2 }, "area": { "label": "1,500 sqft", "min": 1500, "max": 1500, "unit": "sqft" }, "photo": "https://cdngeneral.point2homes.com/dmslivecafe/3/2067353/IMG_4636(20250617121611013).JPG?width=360&quality=80", "photo_count": 8 }, { "id": "1448976", "url": "https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/220-2780-Acadia-Road.html", "slug": "220-2780-acadia-road", "title": "220-2780 Acadia Road", "property_type": "House", "listing_type": "rent", "price": { "display": "Ask for pricing", "is_starting_price": false, "currency": "CAD", "period": "month" }, "address": { "full": "Vancouver, BC, V6T 2L3", "city": "Vancouver", "state": "BC", "postal_code": "V6T 2L3" }, "bedrooms": { "label": "3 beds", "min": 3, "max": 3 }, "bathrooms": { "label": "2 baths", "min": 2, "max": 2 }, "area": { "label": "1,035 sqft", "min": 1035, "max": 1035, "unit": "sqft" }, "photo": "https://cdngeneral.point2homes.com/dmslivecafe/2/134703/01212_8hZeNxE9Kfqz_0ak07K_600x450.jpg?width=360&quality=80", "photo_count": 17 } ], "pagination": { "page": 1, "per_page": 30, "returned": 31, "total_results": 38, "has_next": true }, "location": { "country": "CA", "state": "BC", "city": "Vancouver" }, "filtered_out": 0 }, "meta": { "endpoint_family": "search", "request_id": "req_8e1f2285c7c14453800b374168a34496", "credits_charged": 1, "credits_remaining": 1828 } } ``` 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 string | url url | slug string | title string | property\_type string | listing\_type string | price object | address object | bedrooms object | bathrooms object | area object | photo url | photo\_count integer | badges string\[\] | rating number | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1097386 | https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/Bayview-At-Coal-Harbour-New-0.html | bayview-at-coal-harbour-new-0 | Bayview at Coal Harbour | House | rent | {6 fields} | {4 fields} | {3 fields} | {3 fields} | {4 fields} | https://cdngeneral.point2homes.com/dmslivecafe/3/1097386/BCH%20Living%20Room%202%20(2).jpg?width=360&quality=80 | 28 | \[1 item\] | 4 | | 2 | 2067353 | https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/3449-East-28Th-Ave-B-230014.html | 3449-east-28th-ave-b-230014 | 3449 East 28th Ave/B-230014 | House | rent | {5 fields} | {4 fields} | {3 fields} | {3 fields} | {4 fields} | https://cdngeneral.point2homes.com/dmslivecafe/3/2067353/IMG\_4636(20250617121611013).JPG?width=360&quality=80 | 8 | — | — | | 3 | 1448976 | https://www.point2homes.com/CA/Home-For-Rent/BC/Vancouver/220-2780-Acadia-Road.html | 220-2780-acadia-road | 220-2780 Acadia Road | House | rent | {4 fields} | {4 fields} | {3 fields} | {3 fields} | {4 fields} | https://cdngeneral.point2homes.com/dmslivecafe/2/134703/01212\_8hZeNxE9Kfqz\_0ak07K\_600x450.jpg?width=360&quality=80 | 17 | — | — | Recorded from our API · 3 items shown · 15 datapoints per item GET /v1/point2/search?country=CA&state=BC&city=Vancouver 15 datapoints ### Identity - id string - slug string - title string - property\_type string - listing\_type string ### Contact - url url ### Location - address object - area object ### Reputation - photo url - photo\_count integer - badges string\[\] - rating number ### Price - price object ### Other - bedrooms object - bathrooms object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/point2/search?country=CA&state=BC&city=Vancouver" \ -H "X-API-Key: $API_KEY" ``` Point2 · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/point2/autocomplete`](https://perceptlayer.com/apis/point2/autocomplete) | `query` `country` +1 optional | 1 credit | | [GET `/v1/point2/listing`](https://perceptlayer.com/apis/point2/listing) | `url` | 1 credit | | [GET `/v1/point2/search`](https://perceptlayer.com/apis/point2/search) | `country` `state` `city` +12 optional | 1 credit | Overview ## About the Point2 API ## What you can get The Point2 API returns Point2 rental data as JSON through 3 endpoints. `search` and `autocomplete` take a `country` of CA or US. - **Search:** `search` takes a `country`, `state` and `city`, with `page`, the repeatable `bedrooms[]`, `bathrooms[]`, `property_type[]`, `pet_policy[]` and `amenities[]`, `price_min`, `price_max`, `square_feet_min`, `square_feet_max`, `available_now` and `sort` (relevance, price\_asc or price\_desc). - **Listings:** `listing` takes a Point2 `url`. - **Autocomplete:** `autocomplete` takes a `query` and a `country`, with `limit`. The recorded `search` for Vancouver, BC returns `items` with `id`, `url`, `slug`, `title`, `property_type`, `listing_type`, `price` (with `min`, `max`, `currency` and `period`), `address`, `bedrooms`, `bathrooms`, `area`, `photo`, `photo_count`, `badges` and `rating`. It also returns `pagination` with `page`, `per_page`, `total_results` and `has_next`, and the `location` searched. ## How a call works Search a city: `GET /v1/point2/search?country=CA&state=BC&city=Vancouver` with your key in the `X-API-Key` header. Each item's `url` is what `listing` takes. Page with `page` while `has_next` is true. 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 asking rents in a Canadian or US city `Use the Point2 API to track asking rents in a Canadian or US city` ### Compare the rent range from \`price.min\` and \`price.max\` across buildings `` Use the Point2 API to compare the rent range from `price.min` and `price.max` across buildings `` ### Find pet-friendly rentals with \`pet\_policy\[\]\` `` Use the Point2 API to find pet-friendly rentals with `pet_policy[]` `` ### Filter by size with \`square\_feet\_min\` and \`square\_feet\_max\` `` Use the Point2 API to filter by size with `square_feet_min` and `square_feet_max` `` FAQ ## Questions **Do I need a Point2 account?** No. You call this Point2 API with your Perceptlayer key in the \`X-API-Key\` header, with no Point2 login. **How much does the Point2 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. **Which countries does it cover?** Set \`country\` to CA or US for Canada or the United States. \`search\` also needs a \`state\` and a \`city\`. **Should I build a Point2 scraper instead?** You can, but a Point2 scraper is code you maintain: page changes break it, requests get blocked, and Point2's terms govern how you collect data. The Point2 API gives you 3 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 Point2 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)