---
title: "Point2 API: Search | Perceptlayer"
description: "Search from Point2 as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/point2/search
---

[APIs](https://perceptlayer.com/apis) / [Point2](https://perceptlayer.com/apis/point2) / Search

# Point2: Search

Search from Point2 as JSON. 1 credit per successful call.

GET `/v1/point2/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `country` | string | Required | CA, US, ca, us |
| `state` | string | Required | Up to 2 characters |
| `city` | string | Required | Up to 100 characters |
| `page` | integer | Optional | Any |
| `bedrooms[]` | list of integer | Optional | Any |
| `bathrooms[]` | list of integer | Optional | Any |
| `property_type[]` | list of string | Optional | house, townhouse, duplex\_triplex, mobile\_home, apartment, condo, other |
| `pet_policy[]` | list of string | Optional | pet\_friendly, no\_pets, cats, dogs |
| `amenities[]` | list of string | Optional | air\_conditioning, dishwasher, fireplace, furnished, large\_closets, patio\_balcony, in\_unit\_laundry, laundry\_hookup, wheelchair\_access, gated\_access, covered\_parking, garage, high\_speed\_internet, shared\_laundry, pool, fitness\_center |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `square_feet_min` | integer | Optional | Any |
| `square_feet_max` | integer | Optional | Any |
| `available_now` | boolean | Optional | Any |
| `sort` | string | Optional | relevance, price\_asc, price\_desc |

## Example request

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.

[Run this endpoint in the playground](https://perceptlayer.com/apis/point2?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.