APIs / Real estate / immobilier.notaires.fr

1 credit per call7 endpoints24 datapoints

immobilier.notaires.fr API

immobilier.notaires.fr API for French notary sales, rentals and auctions, listings, notary offices and localities as JSON. 1 credit per successful call.

immobilier.notaires.fr
GET/v1/notaires-immo/search?transaction=sale&department=75&max_price=300000&property_type=APP&sort=price_asc&per_page=5
{
  "success": true,
  "listings": [
    {
      "id": 2077443,
      "property_id": 2307300,
      "reference": "AVI",
      "agency_id": "75230",
      "created_at": "2026-09-04T13:30:50Z",
      "updated_at": "2026-09-29T13:18:01Z",
      "transaction": "sale",
      "transaction_type": "VENTE",
      "property_type": "APP",
      "property_type_label": "Apartment",
      "price": 36000,
      "price_total": 46200,
      "currency": "EUR",
      "fees": {
        "amount": 10200,
        "percent": 6,
        "paid_by": "ACQUEREUR"
      },
      "location": {
        "locality_id": "32468",
        "locality": "PARIS 12",
        "city": "Paris 12e Arrondissement",
        "postal_code": "75012",
        "insee_code": "75112",
        "department_code": "75",
        "department": "Paris",
        "region_code": "11",
        "region": "Île-de-France"
      },
      "rooms": 1,
      "condition": "old",
      "viager": true,
      "description": "EN VIAGER, STUDIO AVEC BALCON BOULEVARD DE LA BASTILLE, EXPOSITION OUEST",
      "image": "https://media.immobilier.notaires.fr/inotr/media/0/75230/2077443/62158407_VGA.jpg",
      "photo_count": 5,
      "phone": "0652747779",
      "url": "https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-12-75012/2077443",
      "url_en": "https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-12-75012/2077443"
    },
    {
      "id": 2013677,
      "property_id": 2241923,
      "reference": "92010-1355",
      "agency_id": "92010",
      "created_at": "2026-06-19T16:19:32Z",
      "updated_at": "2026-11-09T10:37:25Z",
      "transaction": "sale",
      "transaction_type": "VENTE",
      "property_type": "APP",
      "property_type_label": "Apartment",
      "price": 53500,
      "price_total": 58000,
      "currency": "EUR",
      "fees": {
        "amount": 4500,
        "percent": 8.4,
        "paid_by": "ACQUEREUR"
      },
      "location": {
        "locality_id": "32463",
        "locality": "PARIS 7",
        "city": "Paris 7e Arrondissement",
        "postal_code": "75007",
        "insee_code": "75107",
        "department_code": "75",
        "department": "Paris",
        "region_code": "11",
        "region": "Île-de-France"
      },
      "surface": 5.5600000000000005,
      "rooms": 1,
      "bedrooms": 0,
      "condition": "old",
      "viager": false,
      "description": "PARIS 7eme - RUE SAINT DOMINIQUE - METRO SOLFERINO - PETITE CHAMBRE A VENDRE -",
      "image": "https://media.immobilier.notaires.fr/inotr/media/29/92010/2013677/b4f265f3_VGA.jpg",
      "photo_count": 10,
      "phone": "0660124411",
      "url": "https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-07-75007/2013677",
      "url_en": "https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-07-75007/2013677"
    },
    {
      "id": 1766488,
      "property_id": 1984478,
      "reference": "72",
      "agency_id": "35149",
      "created_at": "2025-06-05T06:51:56Z",
      "updated_at": "2026-11-12T07:42:40Z",
      "transaction": "sale",
      "transaction_type": "VENTE",
      "property_type": "APP",
      "property_type_label": "Apartment",
      "price": 70000,
      "price_total": 75000,
      "currency": "EUR",
      "fees": {
        "amount": 5000,
        "percent": 7.1,
        "paid_by": "ACQUEREUR"
      },
      "location": {
        "locality_id": "32471",
        "locality": "PARIS 15",
        "city": "Paris 15e Arrondissement",
        "postal_code": "75015",
        "insee_code": "75115",
        "department_code": "75",
        "department": "Paris",
        "region_code": "11",
        "region": "Île-de-France"
      },
      "rooms": 1,
      "bedrooms": 0,
      "condition": "old",
      "viager": false,
      "description": "A VENDRE A PARIS 15EME, CHAMBRE DE SERVICE AU 7EME ET DERNIER ETAGE, dans un immeuble de haut standing, d'une superficie habitable d'environ 6,55 m2, et d'environ 10,65 m2 au sol. Il se compose...",
      "image": "https://media.immobilier.notaires.fr/inotr/media/32/35149/1766488/5dc66d86_VGA.jpg",
      "photo_count": 8,
      "phone": "0299658131",
      "energy_rating_date": "2025-03-17",
      "url": "https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-15-75015/1766488",
      "url_en": "https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-15-75015/1766488"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "total_pages": 13,
    "total_results": 64,
    "has_next": true
  },
  "applied_filters": {
    "transaction": "sale",
    "department": [
      "75"
    ],
    "property_type": [
      "APP"
    ],
    "max_price": 300000,
    "sort": "price_asc"
  },
  "meta": {
    "endpoint_family": "search",
    "currency": "EUR",
    "returned": 5,
    "filtered_out_count": 0,
    "request_id": "req_195d2a1f4d154407bdfdd5c14bba34b4",
    "credits_charged": 1,
    "credits_remaining": 1835
  }
}
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.

#idintegerproperty_idintegerreferencestringagency_idstringcreated_atstringupdated_atstringtransactionstringtransaction_typestringproperty_typestringproperty_type_labelstringpriceintegerprice_totalintegercurrencystringfeesobjectlocationobjectroomsintegerconditionstringviagerbooleandescriptionstringimageurlphoto_countintegerphonestringurlurlurl_enurl
120774432307300AVI752302026-09-04T13:30:50Z2026-09-29T13:18:01ZsaleVENTEAPPApartment3600046200EUR{3 fields}{9 fields}1oldtrueEN VIAGER, STUDIO AVEC BALCON BOULEVARD DE LA BASTILLE, EXPOSITION OUESThttps://media.immobilier.notaires.fr/inotr/media/0/75230/2077443/62158407_VGA.jpg50652747779https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-12-75012/2077443https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-12-75012/2077443
22013677224192392010-1355920102026-06-19T16:19:32Z2026-11-09T10:37:25ZsaleVENTEAPPApartment5350058000EUR{3 fields}{9 fields}1oldfalsePARIS 7eme - RUE SAINT DOMINIQUE - METRO SOLFERINO - PETITE CHAMBRE A VENDRE -https://media.immobilier.notaires.fr/inotr/media/29/92010/2013677/b4f265f3_VGA.jpg100660124411https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-07-75007/2013677https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-07-75007/2013677
31766488198447872351492025-06-05T06:51:56Z2026-11-12T07:42:40ZsaleVENTEAPPApartment7000075000EUR{3 fields}{9 fields}1oldfalseA VENDRE A PARIS 15EME, CHAMBRE DE SERVICE AU 7EME ET DERNIER ETAGE, dans un immeuble de haut standing, d'une superficie habitable d'environ 6,55 m2, et d'environ 10,65 m2 au sol. Il se compose...https://media.immobilier.notaires.fr/inotr/media/32/35149/1766488/5dc66d86_VGA.jpg80299658131https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-15-75015/1766488https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-15-75015/1766488

Recorded from our API · 3 items shown · 24 datapoints per itemGET /v1/notaires-immo/search?transaction=sale&department=75&max_price=300000&property_type=APP&sort=price_asc&per_page=5

24 datapoints

Identity

  • idinteger
  • property_idinteger
  • agency_idstring
  • transaction_typestring
  • property_typestring
  • property_type_labelstring

Contact

  • phonestring
  • urlurl
  • url_enurl

Location

  • locationobject

Reputation

  • imageurl
  • photo_countinteger

Price

  • priceinteger
  • price_totalinteger
  • currencystring
  • feesobject

Other

  • referencestring
  • created_atstring
  • updated_atstring
  • transactionstring
  • roomsinteger
  • conditionstring
  • viagerboolean
  • descriptionstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/notaires-immo/search?transaction=sale&department=75&max_price=300000&property_type=APP&sort=price_asc&per_page=5" \
  -H "X-API-Key: $API_KEY"

immobilier.notaires.fr · 7 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/notaires-immo/agency
crpcen
1 credit
GET/v1/notaires-immo/autocomplete
q+2 optional
1 credit
GET/v1/notaires-immo/listing
annonce_id
1 credit
GET/v1/notaires-immo/listing-contact
annonce_id
1 credit
GET/v1/notaires-immo/locality
id
1 credit
GET/v1/notaires-immo/locality-group
id
1 credit
GET/v1/notaires-immo/search
none+21 optional
1 credit

Overview

About the immobilier.notaires.fr API

What you can get

The immobilier.notaires.fr API returns property data from French notaries as JSON through 7 endpoints.

  • Search: search takes a transaction (sale, rent or auction), with locality, department, radius_km, min_price, max_price, min_surface, max_surface, rooms, min_rooms, max_rooms, bedrooms, min_bedrooms, max_bedrooms, property_type, viager (true or false), crpcen, reference, sort (price_asc, price_desc, date_asc or date_desc), page and per_page.
  • Listings: listing and listing-contact take an annonce_id.
  • Notary offices: agency takes a crpcen.
  • Locations: autocomplete takes a q, with kind (locality, group, department or reference) and size; locality and locality-group take an id.

The recorded search for apartments (property_type=APP) for sale in department 75 (Paris), up to 300,000 and sorted by price_asc, returns listings with id, property_id, reference, agency_id, created_at, updated_at, transaction, transaction_type, property_type, property_type_label, price, price_total, currency, fees, location, rooms, condition, viager, description, image, photo_count, phone, url and url_en. It also returns pagination with total_pages, total_results (64) and has_next, and applied_filters.

How a call works

Search a department: GET /v1/notaires-immo/search?transaction=sale&department=75&max_price=300000&property_type=APP&sort=price_asc&per_page=5 with your key in the X-API-Key header. Each listing's id is the annonce_id that listing and listing-contact take. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

Use cases

Track notary asking prices by French department or locality

Use the immobilier.notaires.fr API to track notary asking prices by French department or locality

Compare `price` with `price_total` and the `fees` block, to see what the buyer pays on top

Use the immobilier.notaires.fr API to compare `price` with `price_total` and the `fees` block, to see what the buyer pays on top

Watch viager sales with `viager=true`

Use the immobilier.notaires.fr API to watch viager sales with `viager=true`

Follow notary auctions with `transaction=auction`

Use the immobilier.notaires.fr API to follow notary auctions with `transaction=auction`

FAQ

Questions

Do I need an immobilier.notaires.fr account?

No. You call this immobilier.notaires.fr API with your Perceptlayer key in the `X-API-Key` header, with no immobilier.notaires.fr login.

How much does the immobilier.notaires.fr 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.

Are notary fees included?

Each search listing carries `price`, `price_total` and a `fees` block with `amount`, `percent` and `paid_by`, so you can separate the two.

Should I build an immobilier.notaires.fr scraper instead?

You can, but an immobilier.notaires.fr scraper is code you maintain: page changes break it, requests get blocked, and immobilier.notaires.fr's terms govern how you collect data. The immobilier.notaires.fr 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 immobilier.notaires.fr API with 100 free credits

No credit card. Failed calls are never billed.