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

[APIs](https://perceptlayer.com/apis) / [Bien'ici](https://perceptlayer.com/apis/bienici) / Search

# Bien'ici: Search

Search from Bien'ici as JSON. 1 credit per successful call.

GET `/v1/bienici/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `transaction_type` | string | Optional | buy, rent, new\_build |
| `property_type[]` | list of string | Optional | house, flat, parking, terrain, building, castle, loft, office, premises, shop, townhouse, annexe, others, programme |
| `zone_ids[]` | list of number | Optional | Any |
| `postal_code[]` | list of string | Optional | Any |
| `min_price` | number | Optional | Any |
| `max_price` | number | Optional | Any |
| `min_area` | number | Optional | Any |
| `max_area` | number | Optional | Any |
| `min_bedrooms` | integer | Optional | Any |
| `max_bedrooms` | integer | Optional | Any |
| `min_rooms` | integer | Optional | Any |
| `max_rooms` | integer | Optional | Any |
| `min_garden_area` | number | Optional | Any |
| `max_garden_area` | number | Optional | Any |
| `energy_classification` | string | Optional | Up to 10 characters |
| `on_the_market` | boolean | Optional | Any |
| `new_only` | boolean | Optional | Any |
| `sort` | string | Optional | publicationDate |
| `sort_order` | string | Optional | asc, desc |
| `page` | integer | Optional | Any |
| `size` | integer | Optional | Any |
| `is_preview` | boolean | Optional | Any |
| `is_on_last_floor` | boolean | Optional | Any |
| `has_3d_model` | boolean | Optional | Any |
| `is_ground_floor` | boolean | Optional | Any |
| `is_not_ground_floor` | boolean | Optional | Any |
| `has_pool` | boolean | Optional | Any |
| `has_balcony` | boolean | Optional | Any |
| `has_terrace` | boolean | Optional | Any |
| `has_balcony_or_terrace` | boolean | Optional | Any |
| `has_cellar` | boolean | Optional | Any |
| `has_parking` | boolean | Optional | Any |
| `has_fire_place` | boolean | Optional | Any |
| `has_door_code` | boolean | Optional | Any |
| `has_intercom` | boolean | Optional | Any |
| `has_garden` | boolean | Optional | Any |
| `has_elevator` | boolean | Optional | Any |
| `work_to_do` | boolean | Optional | Any |
| `no_work_to_do` | boolean | Optional | Any |
| `single_storey_house` | boolean | Optional | Any |
| `is_disabled_people_friendly` | boolean | Optional | Any |
| `flat_sharing` | boolean | Optional | Any |
| `is_building_plot` | boolean | Optional | Any |
| `is_exclusive_sale_mandate` | boolean | Optional | Any |
| `has_caretaker` | boolean | Optional | Any |
| `is_duplex` | boolean | Optional | Any |
| `has_separate_toilet` | boolean | Optional | Any |
| `is_furnished` | boolean | Optional | Any |
| `is_not_furnished` | boolean | Optional | Any |
| `has_photo` | boolean | Optional | Any |
| `is_eligible_for_denormandie_law` | boolean | Optional | Any |
| `exportable_ad` | boolean | Optional | Any |
| `is_in_student_residence` | boolean | Optional | Any |
| `is_in_senior_residence` | boolean | Optional | Any |
| `is_in_tourism_residence` | boolean | Optional | Any |
| `is_in_managed_residence` | boolean | Optional | Any |
| `is_not_in_residence` | boolean | Optional | Any |
| `is_not_life_annuity_sale` | boolean | Optional | Any |
| `is_life_annuity_sale_only` | boolean | Optional | Any |
| `is_not_property_without_usufruct` | boolean | Optional | Any |
| `is_property_without_usufruct_only` | boolean | Optional | Any |
| `is_promoted_new_property` | boolean | Optional | Any |
| `has_no_photo` | boolean | Optional | Any |
| `has_no_address` | boolean | Optional | Any |
| `has_address` | boolean | Optional | Any |
| `has_no_price` | boolean | Optional | Any |
| `is_promoted_as_exclusive` | boolean | Optional | Any |
| `has_to_be_built` | boolean | Optional | Any |
| `has_not_to_be_built` | boolean | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/bienici/search?transaction_type=rent&size=2" \
  -H "X-API-Key: $API_KEY"
```

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