---
title: "Private Property API: Listings Search | Perceptlayer"
description: "Listings Search from Private Property as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/private-property/listings-search
---

[APIs](https://perceptlayer.com/apis) / [Private Property](https://perceptlayer.com/apis/private-property) / Listings Search

# Private Property: Listings Search

Listings Search from Private Property as JSON. 1 credit per successful call.

GET `/v1/private-property/listings-search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `type` | string | Optional | residential, commercial, farm |
| `deal_type` | string | Optional | sale, rent |
| `location_id` | integer | Optional | Any |
| `location_name` | string | Optional | Up to 255 characters |
| `location_descriptor` | string | Optional | Up to 255 characters |
| `location_shape_type` | integer | Optional | Any |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_bedrooms` | integer | Optional | Any |
| `min_baths` | integer | Optional | Any |
| `rental_price_type` | string | Optional | PerMonth, PerWeek, PerDay, PerSquareMetre |
| `page` | integer | Optional | Any |
| `has_pool` | boolean | Optional | Any |
| `has_staff_quarters` | boolean | Optional | Any |
| `has_flatlets` | boolean | Optional | Any |
| `has_borehole` | boolean | Optional | Any |
| `has_scenic_view` | boolean | Optional | Any |
| `has_alarm` | boolean | Optional | Any |
| `has_electric_fencing` | boolean | Optional | Any |
| `has_security_post` | boolean | Optional | Any |
| `has_access_gate` | boolean | Optional | Any |
| `has_intercom` | boolean | Optional | Any |
| `sub_category[]` | list of string | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/private-property/listings-search?type=residential&deal_type=sale&min_bedrooms=3" \
  -H "X-API-Key: $API_KEY"
```

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