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

[APIs](https://perceptlayer.com/apis) / [ParuVendu Immobilier](https://perceptlayer.com/apis/paruvendu) / Search

# ParuVendu Immobilier: Search

Search from ParuVendu Immobilier as JSON. 1 credit per successful call.

GET `/v1/paruvendu/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `listing_type` | string | Optional | sale, rent |
| `property_type` | string | Optional | apartment, house, studio, land |
| `place` | string | Required | Any |
| `rooms` | string | Optional | studio, 2, 3, 4, 5, 6\_plus |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_area` | integer | Optional | Any |
| `max_area` | integer | Optional | Any |
| `min_bedrooms` | integer | Optional | Any |
| `min_bathrooms` | integer | Optional | Any |
| `seller` | string | Optional | private |
| `with_photos` | boolean | Optional | Any |
| `sort` | string | Optional | relevance, newest, price\_asc, price\_desc, area\_desc, area\_asc, rooms\_desc, rooms\_asc |
| `page` | integer | Optional | Any |

## Example request

ParuVendu Immobilier

GET /v1/paruvendu/search?listing\_type=sale&property\_type=apartment&place=lyon&min\_price=200000&max\_price=400000 

```
{
  "success": true,
  "data": {
    "search_parameters": {
      "listing_type": "sale",
      "property_type": "apartment",
      "place": "lyon",
      "min_price": "200000",
      "max_price": "400000",
      "sort": "newest",
      "page": 1
    },
    "search_metadata": {
      "total_results": 663,
      "low_price": 200000,
      "high_price": 400000,
      "page": 1,
      "per_page": 30,
      "reachable_results": 150,
      "has_next_page": true,
      "upstream_items": 30,
      "filtered_out": 0
    },
    "listings": [
      {
        "listing_id": "1297274803A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 100 m² Lyon 5",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297274803A1KIVHAP000",
        "price": {
          "amount": 325000,
          "currency": "EUR",
          "text": "325 000 €",
          "per_sqm": 3250,
          "includes_charges": false
        },
        "area_m2": 100,
        "rooms": 5,
        "bedrooms": 3,
        "city": "Lyon 5",
        "features": [
          "Garage"
        ],
        "energy": {
          "class": "D"
        },
        "seller_type": "private",
        "updated_at": "2026-11-10",
        "description_snippet": "A Lyon, grand appartement familial de plus de 100 m², 5 pièces à rénover, au 3ème étage avec ascenseur. Vue sur la Saône, environnement calme. Proximité bus, gare de Perrache et stationnement sécurisé. Idéal pour un projet sur-mesure.",
        "photo_count": 1
      },
      {
        "listing_id": "1297269803A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 39 m² Lyon 4",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297269803A1KIVHAP000",
        "price": {
          "amount": 210000,
          "currency": "EUR",
          "text": "210 000 €",
          "per_sqm": 5385,
          "includes_charges": false
        },
        "area_m2": 39,
        "rooms": 2,
        "bedrooms": 1,
        "city": "Lyon 4",
        "energy": {
          "class": "F"
        },
        "seller_type": "private",
        "updated_at": "2026-11-10",
        "description_snippet": "Lyon, T2 de 39 m2 au rez-de-chaussée. Entièrement rénové en 2020, séjour avec cuisine ouverte équipée, chambre, salle d'eau moderne. Vendu meublé, lumineux, au calme, idéal investisseur ou à habiter après avril 2027. Proche commerces et mét…",
        "photos": [
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/f3/08/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzEuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/30/69/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzIuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/96/46/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzMuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto"
        ],
        "photo_count": 3
      },
      {
        "listing_id": "1297187162A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 54 m² Lyon 4",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297187162A1KIVHAP000",
        "price": {
          "amount": 315000,
          "currency": "EUR",
          "text": "315 000 €",
          "per_sqm": 5833,
          "includes_charges": false
        },
        "area_m2": 54,
        "rooms": 2,
        "bedrooms": 1,
        "city": "Lyon 4",
        "features": [
          "Garage"
        ],
        "energy": {
          "class": "B"
        },
        "seller_type": "private",
        "updated_at": "2026-11-08",
        "description_snippet": "Lyon 4ème, appartement rénové de 54,28 m2 au 4ème étage. Prestations haut de gamme, terrasse et parking double. Pièce à vivre lumineuse, cuisine ouverte et salle de bains contemporaine. Immeuble de 2000, DPE B et GES A.",
        "photos": [
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/97/19/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzEuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/77/f0/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzIuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/29/6b/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzMuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto"
        ],
        "photo_count": 10
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_a757529134ec4e1f83f5474ed11d6b7e",
    "credits_charged": 1,
    "credits_remaining": 1831
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

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