APIs / ParuVendu Immobilier / 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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.