--- title: "ParuVendu Immobilier API: 7 endpoints, 1 credit per call" description: "ParuVendu Immobilier API for French homes, studios and land for sale or rent, listings, listing locations and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/paruvendu --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / ParuVendu Immobilier 1 credit per call 7 endpoints 16 datapoints # ParuVendu Immobilier API ParuVendu Immobilier API for French homes, studios and land for sale or rent, listings, listing locations and agencies as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below 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. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | listing\_id string | listing\_type string | property\_type string | title string | url url | price object | area\_m2 integer | rooms integer | bedrooms integer | city string | features string\[\] | energy object | seller\_type string | updated\_at string | description\_snippet string | photo\_count integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1297274803A1KIVHAP000 | sale | apartment | Appartement 100 m² Lyon 5 | https://www.paruvendu.fr/immobilier/vente/appartement/1297274803A1KIVHAP000 | {5 fields} | 100 | 5 | 3 | Lyon 5 | \[1 item\] | {1 fields} | private | 2026-11-10 | 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. | 1 | | 2 | 1297269803A1KIVHAP000 | sale | apartment | Appartement 39 m² Lyon 4 | https://www.paruvendu.fr/immobilier/vente/appartement/1297269803A1KIVHAP000 | {5 fields} | 39 | 2 | 1 | Lyon 4 | — | {1 fields} | private | 2026-11-10 | 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… | 3 | | 3 | 1297187162A1KIVHAP000 | sale | apartment | Appartement 54 m² Lyon 4 | https://www.paruvendu.fr/immobilier/vente/appartement/1297187162A1KIVHAP000 | {5 fields} | 54 | 2 | 1 | Lyon 4 | \[1 item\] | {1 fields} | private | 2026-11-08 | 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. | 10 | Recorded from our API · 3 items shown · 16 datapoints per item GET /v1/paruvendu/search?listing\_type=sale&property\_type=apartment&place=lyon&min\_price=200000&max\_price=400000 16 datapoints ### Identity - listing\_id string - listing\_type string - property\_type string - title string ### Contact - url url - seller\_type string ### Location - area\_m2 integer - city string ### Reputation - photo\_count integer ### Price - price object ### Other - rooms integer - bedrooms integer - features string\[\] - energy object - updated\_at string - description\_snippet string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/paruvendu/search?listing_type=sale&property_type=apartment&place=lyon&min_price=200000&max_price=400000" \ -H "X-API-Key: $API_KEY" ``` ParuVendu Immobilier · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/paruvendu/agencies`](https://perceptlayer.com/apis/paruvendu/agencies) | `area` +1 optional | 1 credit | | [GET `/v1/paruvendu/agency`](https://perceptlayer.com/apis/paruvendu/agency) | `slug` | 1 credit | | [GET `/v1/paruvendu/autocomplete`](https://perceptlayer.com/apis/paruvendu/autocomplete) | `q` | 1 credit | | [GET `/v1/paruvendu/listing`](https://perceptlayer.com/apis/paruvendu/listing) | `listing_id` | 1 credit | | [GET `/v1/paruvendu/listing-location`](https://perceptlayer.com/apis/paruvendu/listing-location) | `listing_id` | 1 credit | | [GET `/v1/paruvendu/reference`](https://perceptlayer.com/apis/paruvendu/reference) | none | 1 credit | | [GET `/v1/paruvendu/search`](https://perceptlayer.com/apis/paruvendu/search) | `place` +13 optional | 1 credit | Overview ## About the ParuVendu Immobilier API ## What you can get The ParuVendu Immobilier API returns ParuVendu property data as JSON through 7 endpoints. - **Search:** `search` takes a `place`, with `listing_type` (sale or rent), `property_type` (apartment, house, studio or land), `rooms` (studio, 2, 3, 4, 5 or 6\_plus), `min_price`, `max_price`, `min_area`, `max_area`, `min_bedrooms`, `min_bathrooms`, `seller` (private), `with_photos`, `sort` (relevance, newest, price\_asc, price\_desc, area\_desc, area\_asc, rooms\_desc or rooms\_asc) and `page`. - **Listings:** `listing` and `listing-location` take a `listing_id`. - **Agencies:** `agencies` takes an `area`, with `page`; `agency` takes a `slug`. - **Lookups:** `autocomplete` takes a `q`; `reference` takes no parameters. The recorded `search` for apartments for sale in Lyon, priced 200,000 to 400,000, returns `listings` with `listing_id`, `listing_type`, `property_type`, `title`, `url`, `price`, `area_m2`, `rooms`, `bedrooms`, `city`, `features`, `energy`, `seller_type`, `updated_at`, `description_snippet` and `photo_count`. It also returns `search_parameters`, and `search_metadata` with `total_results` (663), `reachable_results` (150), `per_page`, `has_next_page`, `low_price` and `high_price`. ## How a call works Search a city: `GET /v1/paruvendu/search?listing_type=sale&property_type=apartment&place=lyon&min_price=200000&max_price=400000` with your key in the `X-API-Key` header. Each listing's `listing_id` is what `listing` and `listing-location` take. Page with `page` while `has_next_page` is true. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices for apartments and houses in a French city `Use the ParuVendu Immobilier API to track asking prices for apartments and houses in a French city` ### Watch listings from private sellers with \`seller=private\` `` Use the ParuVendu Immobilier API to watch listings from private sellers with `seller=private` `` ### Compare price per \`area\_m2\` across districts such as Lyon 5 `` Use the ParuVendu Immobilier API to compare price per `area_m2` across districts such as Lyon 5 `` ### List the agencies in a département with \`agencies\`, such as rhone-69 `` Use the ParuVendu Immobilier API to list the agencies in a département with `agencies`, such as rhone-69 `` FAQ ## Questions **Do I need a ParuVendu account?** No. You call this ParuVendu Immobilier API with your Perceptlayer key in the \`X-API-Key\` header, with no ParuVendu login. **How much does the ParuVendu Immobilier API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **How many results can one search reach?** The recorded Lyon search reports 663 \`total\_results\` but 150 \`reachable\_results\`. Narrow the price, area or \`property\_type\` to reach more of a market. **Should I build a ParuVendu Immobilier scraper instead?** You can, but a ParuVendu Immobilier scraper is code you maintain: page changes break it, requests get blocked, and ParuVendu Immobilier's terms govern how you collect data. The ParuVendu Immobilier API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the ParuVendu Immobilier API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)