--- title: "Logic-Immo API: JSON data, 5 endpoints, 1 credit per call" description: "Logic-Immo API for French homes to buy or rent, listing details, agencies and place lookups as JSON. 1 credit per successful call, failed calls free." url: https://perceptlayer.com/apis/logic-immo --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Logic-Immo 1 credit per call 5 endpoints 30 datapoints # Logic-Immo API Logic-Immo API for French homes to buy or rent, listing details, agencies and place lookups as JSON. 1 credit per successful call, failed calls free. [Get a free API key](https://perceptlayer.com/signup) Run it below Logic-Immo GET /v1/logic-immo/search?place\_id=AD08FR31096&distribution=buy&estate\_types\[\]=apartment&order=PriceAsc&bedrooms\_min=2 ``` { "success": true, "data": { "results": [ { "id": "25FNCZCVDMLN", "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/25FNCZCVDMLN", "reference": "249731247", "status": "Published", "type": "PROFESSIONAL", "brand": "logicimmo", "portal": "logicimmo", "is_suggestion": false, "has_detail_page": true, "distribution": "BUY", "property_type": "APARTMENT", "price": { "value": 39500, "formatted": "Bouquet 39 500 €", "on_request": false, "per_sqm_text": "et 1 450 €/mois", "currency": "EUR" }, "surface": { "main_sqm": 61 }, "rooms": 3, "bedrooms": 2, "year_of_construction": 1970, "energy_class": "D", "address": { "city": "Paris 19ème arrondissement", "zip_code": "75019", "district": "Bassin de la Villette" }, "place_hierarchy": [ { "type_key": "AD09", "id": "AD09FR44" }, { "type_key": "AD08", "id": "AD08FR31096" }, { "type_key": "AD06", "id": "AD06FR76" } ], "transport": [ { "type": "METRO", "lines": [ "…", "…" ] }, { "type": "BUS", "lines": [ "…", "…", "…" ] } ], "title": "Appartement en viager • occupé", "short_title": "Appartement", "facts": [ { "type": "numberOfRooms", "value": "3 pièces", "label": "pièces" }, { "type": "numberOfBedrooms", "value": "2 chambres", "label": "chambres" }, { "type": "livingSpace", "value": "61 m²", "label": "m²" } ], "headline": "Viager Occupé - Paris 19e", "description": "Essentiel patrimoine et viager vous propose une belle opportunité d'investissement patrimonial au cœur du 19 € arrondissement de Paris. Situé dans un secteur en pleine évolution, à proximité immédiate des commerces, des transports en commun…", "images": [ { "url": "https://cdnihddipa.cloudimg.io/5/f/8/d/5f8d750e-74ca-4931-9b73-db5bb88d12f2.jpg?ci_seal=ee11869e1a90c89fe76b1e27d2d8e3f923d76b11", "alt": "Appartement en viager • occupé 39 500 € 3 pièces 2 chambres 61 m² Étage 7/9 Paris 19ème arrondissement 75019" }, { "url": "https://cdnihddipa.cloudimg.io/e/3/8/b/e38bdab9-90c7-4322-ba48-d786b79670e7.jpg?ci_seal=eb56d6eafe5a22756aa2d9811e4a8790f36861ab" }, { "url": "https://cdnihddipa.cloudimg.io/7/0/d/1/70d1ba8c-17c4-4377-8337-7a7625bfa828.jpg?ci_seal=f55ea388bd592738951586a960212cbf7df4d6d5" } ], "photo_count": 7, "tags": { "exclusive": true, "virtual_visit_3d": false, "brokerage_fee": false, "new": false }, "dates": { "created_at": "2025-09-10T23:54:00Z", "updated_at": "2026-11-05T02:56:09.644Z" }, "provider": { "agency_id": "KbpCjD9DiQgPJBUvYL8Rmj", "name": "ESSENTIEL PATRIMOINE ET VIAGER", "logo_url": "https://cdnihddipa.cloudimg.io/f/9/3/6/f936a70a-a77f-4a6f-8121-3456e7bfef64.jpg?ci_seal=20d318d79c98d23116e1427bc3ae9cad426dc4f7", "profile_url": "https://www.logic-immo.com/agences-immobilieres/KbpCjD9DiQgPJBUvYL8Rmj", "website": "http://www.essentielpatrimoine.com/", "phones": [ "0664846951" ], "address": "14 rue Paul Bert, 75011 PARIS", "publisher_type": "AGENCY", "private_owner": false, "legal_information": [ "SARL ESSENTIEL PATRIMOINE ET VIAGER", "Carte professionnelle CPI75012018000027152 délivrée par la Préfecture de PARIS", "Garantie financière GALIAN pour un montant de 120 000 €" ] } }, { "id": "26RNEHZHQHNH", "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26RNEHZHQHNH", "reference": "281776105", "status": "Published", "type": "PROFESSIONAL", "brand": "logicimmo", "portal": "logicimmo", "is_suggestion": false, "has_detail_page": true, "distribution": "BUY", "property_type": "APARTMENT", "price": { "value": 50000, "formatted": "Bouquet 50 000 €", "on_request": false, "per_sqm_text": "et 1 030 €/mois", "currency": "EUR" }, "surface": { "main_sqm": 61 }, "rooms": 3, "bedrooms": 2, "address": { "city": "Paris 19ème arrondissement", "zip_code": "75019" }, "place_hierarchy": [ { "type_key": "AD09", "id": "AD09FR44" }, { "type_key": "AD08", "id": "AD08FR31096" }, { "type_key": "AD06", "id": "AD06FR76" } ], "title": "Appartement en viager • occupé", "short_title": "Appartement", "facts": [ { "type": "numberOfRooms", "value": "3 pièces", "label": "pièces" }, { "type": "numberOfBedrooms", "value": "2 chambres", "label": "chambres" }, { "type": "livingSpace", "value": "61 m²", "label": "m²" } ], "headline": "Viager occupé 3 pièces 61m2", "description": "BOUQUET FAI: 50 000 e - RENTE: 1 030 e/mois Situé dans le 19ème arrondissement de Paris, le bien profite d'un environnement vivant et agréable, à proximité immédiate du canal de l'Ourcq et du Bassin de la Villette. Le quartier offre de nomb…", "images": [ { "url": "https://cdnihddipa.cloudimg.io/1/4/8/f/148fa8e8-9be2-4510-b1c6-8cd219ecfb38.jpg?ci_seal=612b48210c309e51825bbd082e99c2b9abed322d", "alt": "Appartement en viager • occupé 50 000 € 3 pièces 2 chambres 61 m² 7ème étage Paris 19ème arrondissement 75019" }, { "url": "https://cdnihddipa.cloudimg.io/9/c/8/c/9c8c160d-c8c3-488e-bd04-04fd112001a4.jpg?ci_seal=157fc3a9e54f605c70b96806047c38a40372e60c" }, { "url": "https://cdnihddipa.cloudimg.io/b/6/8/3/b683a040-715b-4d97-a08e-1d76725c423e.jpg?ci_seal=a953a8050ded80d00e19ce81d83fe26db152388a" } ], "photo_count": 6, "tags": { "exclusive": false, "virtual_visit_3d": false, "brokerage_fee": false, "new": false }, "dates": { "created_at": "2026-10-07T22:26:00Z", "updated_at": "2026-11-11T01:26:17.623Z" }, "provider": { "agency_id": "6Jj8zSCJcQtQ4QhDin5E6Z", "name": "BM FINANCE", "logo_url": "https://cdnihddipa.cloudimg.io/e/1/5/1/e15132da-12b6-4c24-a590-ab2fdb9620f7.jpg?ci_seal=8f035264c8fdc9d64bed366dba67d10e7f4f7a98", "profile_url": "https://www.logic-immo.com/agences-immobilieres/6Jj8zSCJcQtQ4QhDin5E6Z", "website": "http://www.bm-finance.fr/", "phones": [ "00669177000 / 0143434377" ], "address": "27 AV DE L OPERA, 75001 PARIS 1ER", "publisher_type": "AGENCY", "private_owner": false, "legal_information": [ "BM FINANCE", "Siège: 27 AVENUE DE L OPERA, 75001 PARIS", "RCS: 450419080" ] } }, { "id": "26SHMVIEIGM2", "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26SHMVIEIGM2", "reference": "279435407", "status": "Published", "type": "PROFESSIONAL", "brand": "logicimmo", "portal": "logicimmo", "is_suggestion": false, "has_detail_page": true, "distribution": "BUY", "property_type": "APARTMENT", "price": { "value": 62000, "formatted": "62 000 €", "on_request": false, "per_sqm_text": "8 857 €/m²", "currency": "EUR" }, "surface": { "main_sqm": 7 }, "rooms": 1, "bedrooms": 2, "year_of_construction": 1900, "address": { "city": "Paris 17ème arrondissement", "zip_code": "75017", "district": "Courcelles-Wagram" }, "place_hierarchy": [ { "type_key": "AD09", "id": "AD09FR42" }, { "type_key": "AD08", "id": "AD08FR31096" }, { "type_key": "AD06", "id": "AD06FR76" } ], "transport": [ { "type": "METRO", "lines": [ "…", "…" ] }, { "type": "BUS", "lines": [ "…", "…", "…" ] } ], "title": "Appartement à vendre", "short_title": "Appartement", "facts": [ { "type": "numberOfRooms", "value": "1 pièce", "label": "pièce" }, { "type": "numberOfBedrooms", "value": "2 chambres", "label": "chambres" }, { "type": "livingSpace", "value": "7 m²", "label": "m²" } ], "headline": "Appartement 2 pièces", "description": "Situées rue de Courcelles proche Parc Monceau, WAGRAM , dans un immeuble pierre de taille , partiellement vue tour Eiffel , au 6eme étage sans ascenseur, 2 chambres de service de 6,50M2 et 7,50m2 non réunissables mais face a face , A VENDRE…", "images": [ { "url": "https://cdnihddipa.cloudimg.io/0/a/0/d/0a0df5a5-bfab-4843-815c-4416c497605c.jpg?ci_seal=6cbbab5cfca9929aa4ce6c0869e8f202a79a918b", "alt": "Appartement à vendre 62 000 € 1 pièce 2 chambres 7 m² Étage 7/7 Paris 17ème arrondissement 75017" }, { "url": "https://cdnihddipa.cloudimg.io/c/0/1/4/c0144067-7e60-4c0a-abda-d7e932f9b5b7.jpg?ci_seal=46cbbab301dd69ebce34a35dd8ad30b40894e2ae" }, { "url": "https://cdnihddipa.cloudimg.io/a/5/2/e/a52eedd0-0138-4906-ab2f-03bea2f4bf6e.jpg?ci_seal=3cc5c5b8ef6c17cab5ada9700341bcd2d5d7b57f" } ], "photo_count": 6, "tags": { "exclusive": true, "virtual_visit_3d": false, "brokerage_fee": false, "new": false }, "dates": { "created_at": "2026-09-09T22:00:00Z", "updated_at": "2026-10-17T11:01:10.544Z" }, "provider": { "agency_id": "J8eVbkEC3BwoRMp7tCa7vo", "name": "L'IMMOBILIER INTERNATIONAL", "logo_url": "https://cdnihddipa.cloudimg.io/f/2/9/4/f2942f37-1ff3-4c06-bd33-a78f7fd2004a.jpg?ci_seal=df0be35b82906478ac8d90f870144742ddac5737", "profile_url": "https://www.logic-immo.com/agences-immobilieres/J8eVbkEC3BwoRMp7tCa7vo", "phones": [ "0609020655" ], "address": "71 boulevard Malesherbes, 75008 Paris", "publisher_type": "AGENCY", "private_owner": false, "legal_information": [ "Société à responsabilité limitée (sans autre indication) L'IMMOBILIER INTERNATIONAL", "Siège: 71 BOULEVARD MALESHERBES, 75008 PARIS", "RCS: 433488491" ] } } ], "total_count": 11577, "page": 1, "per_page": 25, "total_pages": 464, "place_id": "AD08FR31096", "order": "PriceAsc" }, "meta": { "endpoint_family": "search", "dropped": { "suggestion": 0, "filter_mismatch": 0, "missing_card": 0 }, "request_id": "req_04e4275a0bd641f0b4f66039033a19a9", "credits_charged": 1, "credits_remaining": 1846 } } ``` 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 string | url url | reference string | status string | type string | brand string | portal string | is\_suggestion boolean | has\_detail\_page boolean | distribution string | property\_type string | price object | surface object | rooms integer | bedrooms integer | year\_of\_construction number | energy\_class string | address object | place\_hierarchy object\[\] | transport object\[\] | title string | short\_title string | facts object\[\] | headline string | description string | images object\[\] | photo\_count integer | tags object | dates object | provider object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 25FNCZCVDMLN | https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/25FNCZCVDMLN | 249731247 | Published | PROFESSIONAL | logicimmo | logicimmo | false | true | BUY | APARTMENT | {5 fields} | {1 fields} | 3 | 2 | 1970 | D | {3 fields} | \[3 items\] | \[2 items\] | Appartement en viager • occupé | Appartement | \[3 items\] | Viager Occupé - Paris 19e | Essentiel patrimoine et viager vous propose une belle opportunité d'investissement patrimonial au cœur du 19 € arrondissement de Paris. Situé dans un secteur en pleine évolution, à proximité immédiate des commerces, des transports en commun… | \[3 items\] | 7 | {4 fields} | {2 fields} | {10 fields} | | 2 | 26RNEHZHQHNH | https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26RNEHZHQHNH | 281776105 | Published | PROFESSIONAL | logicimmo | logicimmo | false | true | BUY | APARTMENT | {5 fields} | {1 fields} | 3 | 2 | — | — | {2 fields} | \[3 items\] | — | Appartement en viager • occupé | Appartement | \[3 items\] | Viager occupé 3 pièces 61m2 | BOUQUET FAI: 50 000 e - RENTE: 1 030 e/mois Situé dans le 19ème arrondissement de Paris, le bien profite d'un environnement vivant et agréable, à proximité immédiate du canal de l'Ourcq et du Bassin de la Villette. Le quartier offre de nomb… | \[3 items\] | 6 | {4 fields} | {2 fields} | {10 fields} | | 3 | 26SHMVIEIGM2 | https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26SHMVIEIGM2 | 279435407 | Published | PROFESSIONAL | logicimmo | logicimmo | false | true | BUY | APARTMENT | {5 fields} | {1 fields} | 1 | 2 | 1900 | — | {3 fields} | \[3 items\] | \[2 items\] | Appartement à vendre | Appartement | \[3 items\] | Appartement 2 pièces | Situées rue de Courcelles proche Parc Monceau, WAGRAM , dans un immeuble pierre de taille , partiellement vue tour Eiffel , au 6eme étage sans ascenseur, 2 chambres de service de 6,50M2 et 7,50m2 non réunissables mais face a face , A VENDRE… | \[3 items\] | 6 | {4 fields} | {2 fields} | {9 fields} | Recorded from our API · 3 items shown · 30 datapoints per item GET /v1/logic-immo/search?place\_id=AD08FR31096&distribution=buy&estate\_types\[\]=apartment&order=PriceAsc&bedrooms\_min=2 30 datapoints ### Identity - id string - status string - type string - brand string - property\_type string - title string - short\_title string ### Contact - url url ### Location - address object ### Reputation - images object\[\] - photo\_count integer ### Price - price object ### Other - reference string - portal string - is\_suggestion boolean - has\_detail\_page boolean - distribution string - surface object - rooms integer - bedrooms integer - year\_of\_construction number - energy\_class string - place\_hierarchy object\[\] - transport object\[\] - facts object\[\] - headline string - description string - tags object - dates object - provider object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/logic-immo/search?place_id=AD08FR31096&distribution=buy&estate_types[]=apartment&order=PriceAsc&bedrooms_min=2" \ -H "X-API-Key: $API_KEY" ``` Logic-Immo · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/logic-immo/agency`](https://perceptlayer.com/apis/logic-immo/agency) | `id` | 1 credit | | [GET `/v1/logic-immo/autocomplete`](https://perceptlayer.com/apis/logic-immo/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/logic-immo/listing`](https://perceptlayer.com/apis/logic-immo/listing) | none +2 optional | 1 credit | | [GET `/v1/logic-immo/places`](https://perceptlayer.com/apis/logic-immo/places) | `ids` | 1 credit | | [GET `/v1/logic-immo/search`](https://perceptlayer.com/apis/logic-immo/search) | `place_id` +15 optional | 1 credit | Overview ## About the Logic-Immo API ## What you can get The Logic-Immo API returns Logic-Immo property data as JSON through 5 endpoints. - **Search:** `search` takes a `place_id`, with `distribution` (buy or rent), a repeatable `estate_types[]`, `new_build`, `year_built_min`, `order` (Default, PriceAsc, PriceDesc or DateDesc), `page`, `per_page`, `price_min`, `price_max`, `size_min`, `size_max`, `rooms_min`, `rooms_max`, `bedrooms_min` and `bedrooms_max`. - **Listings:** `listing` takes an `id` or a listing `url`. - **Agencies:** `agency` takes an `id`. - **Places:** `autocomplete` takes `q`, with `limit`; `places` takes `ids`. The recorded `search` for place `AD08FR31096` (apartments to buy, at least 2 bedrooms, sorted by `PriceAsc`) returns a `total_count` of 11,577, with `total_pages` and `per_page`. Each item in `results` carries `id`, `url`, `reference`, `distribution`, `property_type`, `price`, `surface`, `rooms`, `bedrooms`, `year_of_construction`, `energy_class`, `address`, `place_hierarchy`, `transport`, `title`, `description`, `photo_count`, `tags`, `dates` and `provider`. ## How a call works Search a place: `GET /v1/logic-immo/search?place_id=AD08FR31096&distribution=buy&estate_types[]=apartment&order=PriceAsc&bedrooms_min=2` with your key in the `X-API-Key` header. Each result's `id` is what `listing` takes, its `provider.agency_id` is what `agency` takes, and the ids in `place_hierarchy` go to `places`. 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 and rents for a French city or department `Use the Logic-Immo API to track asking prices and rents for a French city or department` ### Compare listings by \`energy\_class\` `` Use the Logic-Immo API to compare listings by `energy_class` `` ### Follow new builds with \`new\_build\` `` Use the Logic-Immo API to follow new builds with `new_build` `` ### Watch the newest listings with \`order=DateDesc\` `` Use the Logic-Immo API to watch the newest listings with `order=DateDesc` `` FAQ ## Questions **How much does the Logic-Immo 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 do I find a place\_id?** The ids in a result's \`place\_hierarchy\` share its format: the recorded search's own \`AD08FR31096\` is among them, and \`places\` resolves them. \`autocomplete\` looks places up by name with \`q\`. **Do I need a Logic-Immo account?** No. You call this Logic-Immo API with your Perceptlayer key in the \`X-API-Key\` header, with no Logic-Immo login. **Should I build a Logic-Immo scraper instead?** You can, but a Logic-Immo scraper is code you maintain: page changes break it, requests get blocked, and Logic-Immo's terms govern how you collect data. The Logic-Immo API gives you 5 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 Logic-Immo 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)