Sign inGet a free API keyDashboard
Menu

APIs / Real estate / ParuVendu Immobilier

1 credit per call7 endpoints16 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 keyRun 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 OKJSONX-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_idstringlisting_typestringproperty_typestringtitlestringurlurlpriceobjectarea_m2integerroomsintegerbedroomsintegercitystringfeaturesstring[]energyobjectseller_typestringupdated_atstringdescription_snippetstringphoto_countinteger
11297274803A1KIVHAP000saleapartmentAppartement 100 m² Lyon 5https://www.paruvendu.fr/immobilier/vente/appartement/1297274803A1KIVHAP000{5 fields}10053Lyon 5[1 item]{1 fields}private2026-11-10A 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
21297269803A1KIVHAP000saleapartmentAppartement 39 m² Lyon 4https://www.paruvendu.fr/immobilier/vente/appartement/1297269803A1KIVHAP000{5 fields}3921Lyon 4—{1 fields}private2026-11-10Lyon, 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
31297187162A1KIVHAP000saleapartmentAppartement 54 m² Lyon 4https://www.paruvendu.fr/immobilier/vente/appartement/1297187162A1KIVHAP000{5 fields}5421Lyon 4[1 item]{1 fields}private2026-11-08Lyon 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 itemGET /v1/paruvendu/search?listing_type=sale&property_type=apartment&place=lyon&min_price=200000&max_price=400000

16 datapoints

Identity

  • listing_idstring
  • listing_typestring
  • property_typestring
  • titlestring

Contact

  • urlurl
  • seller_typestring

Location

  • area_m2integer
  • citystring

Reputation

  • photo_countinteger

Price

  • priceobject

Other

  • roomsinteger
  • bedroomsinteger
  • featuresstring[]
  • energyobject
  • updated_atstring
  • description_snippetstring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/paruvendu/agencies
area+1 optional
1 credit
GET/v1/paruvendu/agency
slug
1 credit
GET/v1/paruvendu/autocomplete
q
1 credit
GET/v1/paruvendu/listing
listing_id
1 credit
GET/v1/paruvendu/listing-location
listing_id
1 credit
GET/v1/paruvendu/reference
none
1 credit
GET/v1/paruvendu/search
place+13 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs