--- title: "immobilier.notaires.fr API: 7 endpoints, 1 credit per call" description: "immobilier.notaires.fr API for French notary sales, rentals and auctions, listings, notary offices and localities as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/notaires-immo --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / immobilier.notaires.fr 1 credit per call 7 endpoints 24 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. [Get a free API key](https://perceptlayer.com/signup) Run it below 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 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. | # | id integer | property\_id integer | reference string | agency\_id string | created\_at string | updated\_at string | transaction string | transaction\_type string | property\_type string | property\_type\_label string | price integer | price\_total integer | currency string | fees object | location object | rooms integer | condition string | viager boolean | description string | image url | photo\_count integer | phone string | url url | url\_en url | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 2077443 | 2307300 | AVI | 75230 | 2026-09-04T13:30:50Z | 2026-09-29T13:18:01Z | sale | VENTE | APP | Apartment | 36000 | 46200 | EUR | {3 fields} | {9 fields} | 1 | old | true | EN VIAGER, STUDIO AVEC BALCON BOULEVARD DE LA BASTILLE, EXPOSITION OUEST | https://media.immobilier.notaires.fr/inotr/media/0/75230/2077443/62158407\_VGA.jpg | 5 | 0652747779 | https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-12-75012/2077443 | https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-12-75012/2077443 | | 2 | 2013677 | 2241923 | 92010-1355 | 92010 | 2026-06-19T16:19:32Z | 2026-11-09T10:37:25Z | sale | VENTE | APP | Apartment | 53500 | 58000 | EUR | {3 fields} | {9 fields} | 1 | old | false | PARIS 7eme - RUE SAINT DOMINIQUE - METRO SOLFERINO - PETITE CHAMBRE A VENDRE - | https://media.immobilier.notaires.fr/inotr/media/29/92010/2013677/b4f265f3\_VGA.jpg | 10 | 0660124411 | https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-07-75007/2013677 | https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-07-75007/2013677 | | 3 | 1766488 | 1984478 | 72 | 35149 | 2025-06-05T06:51:56Z | 2026-11-12T07:42:40Z | sale | VENTE | APP | Apartment | 70000 | 75000 | EUR | {3 fields} | {9 fields} | 1 | old | false | 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... | https://media.immobilier.notaires.fr/inotr/media/32/35149/1766488/5dc66d86\_VGA.jpg | 8 | 0299658131 | https://www.immobilier.notaires.fr/fr/annonce-immo/vente/appartement/paris-15-75015/1766488 | https://www.immobilier.notaires.fr/en/real-estate-advert/sale/apartment/paris-15-75015/1766488 | Recorded from our API · 3 items shown · 24 datapoints per item GET /v1/notaires-immo/search?transaction=sale&department=75&max\_price=300000&property\_type=APP&sort=price\_asc&per\_page=5 24 datapoints ### Identity - id integer - property\_id integer - agency\_id string - transaction\_type string - property\_type string - property\_type\_label string ### Contact - phone string - url url - url\_en url ### Location - location object ### Reputation - image url - photo\_count integer ### Price - price integer - price\_total integer - currency string - fees object ### Other - reference string - created\_at string - updated\_at string - transaction string - rooms integer - condition string - viager boolean - description string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/notaires-immo/agency`](https://perceptlayer.com/apis/notaires-immo/agency) | `crpcen` | 1 credit | | [GET `/v1/notaires-immo/autocomplete`](https://perceptlayer.com/apis/notaires-immo/autocomplete) | `q` +2 optional | 1 credit | | [GET `/v1/notaires-immo/listing`](https://perceptlayer.com/apis/notaires-immo/listing) | `annonce_id` | 1 credit | | [GET `/v1/notaires-immo/listing-contact`](https://perceptlayer.com/apis/notaires-immo/listing-contact) | `annonce_id` | 1 credit | | [GET `/v1/notaires-immo/locality`](https://perceptlayer.com/apis/notaires-immo/locality) | `id` | 1 credit | | [GET `/v1/notaires-immo/locality-group`](https://perceptlayer.com/apis/notaires-immo/locality-group) | `id` | 1 credit | | [GET `/v1/notaires-immo/search`](https://perceptlayer.com/apis/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 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 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. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)