APIs / Real estate / Logic-Immo

1 credit per call5 endpoints30 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.

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

#idstringurlurlreferencestringstatusstringtypestringbrandstringportalstringis_suggestionbooleanhas_detail_pagebooleandistributionstringproperty_typestringpriceobjectsurfaceobjectroomsintegerbedroomsintegeryear_of_constructionnumberenergy_classstringaddressobjectplace_hierarchyobject[]transportobject[]titlestringshort_titlestringfactsobject[]headlinestringdescriptionstringimagesobject[]photo_countintegertagsobjectdatesobjectproviderobject
125FNCZCVDMLNhttps://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/25FNCZCVDMLN249731247PublishedPROFESSIONALlogicimmologicimmofalsetrueBUYAPARTMENT{5 fields}{1 fields}321970D{3 fields}[3 items][2 items]Appartement en viager • occupéAppartement[3 items]Viager Occupé - Paris 19eEssentiel 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}
226RNEHZHQHNHhttps://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26RNEHZHQHNH281776105PublishedPROFESSIONALlogicimmologicimmofalsetrueBUYAPARTMENT{5 fields}{1 fields}32——{2 fields}[3 items]—Appartement en viager • occupéAppartement[3 items]Viager occupé 3 pièces 61m2BOUQUET 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}
326SHMVIEIGM2https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26SHMVIEIGM2279435407PublishedPROFESSIONALlogicimmologicimmofalsetrueBUYAPARTMENT{5 fields}{1 fields}121900—{3 fields}[3 items][2 items]Appartement à vendreAppartement[3 items]Appartement 2 piècesSitué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 itemGET /v1/logic-immo/search?place_id=AD08FR31096&distribution=buy&estate_types[]=apartment&order=PriceAsc&bedrooms_min=2

30 datapoints

Identity

  • idstring
  • statusstring
  • typestring
  • brandstring
  • property_typestring
  • titlestring
  • short_titlestring

Contact

  • urlurl

Location

  • addressobject

Reputation

  • imagesobject[]
  • photo_countinteger

Price

  • priceobject

Other

  • referencestring
  • portalstring
  • is_suggestionboolean
  • has_detail_pageboolean
  • distributionstring
  • surfaceobject
  • roomsinteger
  • bedroomsinteger
  • year_of_constructionnumber
  • energy_classstring
  • place_hierarchyobject[]
  • transportobject[]
  • factsobject[]
  • headlinestring
  • descriptionstring
  • tagsobject
  • datesobject
  • providerobject

Playground

Run this API

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

EndpointRequired parametersCost
GET/v1/logic-immo/agency
id
1 credit
GET/v1/logic-immo/autocomplete
q+1 optional
1 credit
GET/v1/logic-immo/listing
none+2 optional
1 credit
GET/v1/logic-immo/places
ids
1 credit
GET/v1/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 estateJSONRESTMCP

More real estate APIs

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.