Logic-Immo Listing API returns the full record of one listing: title, full description, price with fee and charge lines, living area, rooms, bedrooms, bathrooms, address, coordinates, public transport, nearby schools, feature groups, DPE and GES energy classes with values, co-ownership data, all photos, floor plans, virtual tours, place hierarchy, tags, dates and the agency with phones, rating and legal lines.
Good to know:
- Send
idfrom search results, orurlfrom the search result to skip one extra lookup. The price stays one credit either way. - Bathrooms are only available here. Search cannot filter by bathrooms.
- A price of null or 1 EUR is shown as
on_request, never as a real price. - An unknown, expired or partner-site listing returns 404 and is not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
2 optional filters available.
string
Optional
Listing id from search results. Example: 263GWUMK8M3F. Required unless url is sent.
1234567890
string
Optional
The listing page URL from a search result. Replaces id and saves one lookup.
https://example.com/product
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "263GWUMK8M3F",
"keys": [
{
"label": "Identifiant",
"value": "263GWUMK8M3F"
},
{
"label": "R\u00e9f\u00e9rence annonce",
"value": "PO5-3124"
}
],
"tags": {
"new": true,
"exclusive": true,
"brokerage_fee": false,
"virtual_visit_3d": true
},
"brand": "logicimmo",
"dates": {
"created_at": "2026-10-05T11:52:00Z",
"updated_at": "2026-10-23T10:31:07.489Z"
},
"facts": [
{
"type": "numberOfRooms",
"label": "pi\u00e8ces",
"value": "4 pi\u00e8ces"
}
],
"price": {
"lines": [
{
"note": null,
"label": "Prix du bien",
"value": "600\u202f000\u00a0\u20ac"
},
{
"note": "Les frais de notaire repr\u00e9sentent environ 8% du prix du bien dans l'ancien et 3% dans le neuf. Le montant estim\u00e9 est donn\u00e9 \u00e0 titre indicatif.",
"label": "Frais de notaires estim\u00e9s",
"value": "48\u202f000\u00a0\u20ac"
}
],
"value": 600000,
"currency": "EUR",
"formatted": "600\u202f000\u00a0\u20ac",
"on_request": false,
"per_sqm_text": "12\u202f000\u00a0\u20ac/m\u00b2"
},
"rooms": 4,
"title": "Appartement \u00e0 vendre",
"energy": {
"scales": [
{
"name": "Diagnostic de performance \u00e9nerg\u00e9tique (DPE)",
"type": "FR_ENERGY_AFTER_2021",
"class": "E",
"values": [
{
"label": "Consommation (\u00e9nergie primaire)",
"value": "278 kWh/m\u00b2.an"
},
{
"label": "\u00c9missions",
"value": "10 kg CO\u2082/m\u00b2.an"
}
]
},
{
"name": "Indice d'\u00e9mission de gaz \u00e0 effet de serre (GES)",
"type": "FR_GHG_AFTER_2021",
"class": "B",
"values": [
{
"label": "\u00c9missions",
"value": "10 kg CO\u2082/m\u00b2.an"
}
]
}
],
"features": [
{
"label": "Type de chauffage",
"value": "Chauffage individuel: Radiateur"
},
{
"label": "Sources d'\u00e9nergie",
"value": "\u00c9lectrique"
}
],
"dpe_class": "E",
"ges_class": "B",
"certificate_details": [
{
"label": "Estimation de la facture \u00e9nerg\u00e9tique",
"value": "entre 960 et 1340 \u20ac/an"
},
{
"label": "Diagnostic r\u00e9alis\u00e9",
"value": "Apr\u00e8s le 1er juillet 2021"
}
]
},
"images": [
{
"alt": "Appartement \u00e0 vendre 600\u202f000\u00a0\u20ac 4 pi\u00e8ces 2 chambres 50 m\u00b2 \u00c9tage 4/4 Arsenal Paris 4\u00e8me arrondissement 75004",
"url": "https://mms.logic-immo.com/c/a/0/3/ca0367ce-9ff0-4d3e-b7af-7e987a5adeaa.jpg?ci_seal=2630d2a658f20f22d0f254fecb1852909df9b9e2",
"class": "LIVING_ROOM"
},
{
"alt": null,
"url": "https://mms.logic-immo.com/5/2/e/d/52ed4b17-837b-4e28-8127-33f4bc383795.jpg?ci_seal=64727f857c31e6d0dfb905f1bf4631fdf5694240",
"class": "EMPTY_ROOM"
}
],
"videos": [],
"address": {
"city": "Paris 4\u00e8me arrondissement",
"country": "FRA",
"district": "Arsenal",
"zip_code": "75004",
"published": true
},
"schools": {
"public": [
{
"name": "\u00c9cole \u00c9l\u00e9mentaire Publique Neuve St Pierre",
"type": "PRIMARY",
"distance": "285 m",
"walk_time": "5 min"
},
{
"name": "\u00c9cole Primaire Publique Fauconnier",
"type": "PRIMARY",
"distance": "514 m",
"walk_time": "8 min"
}
],
"private": [
{
"name": "\u00c9cole Maternelle Priv\u00e9e Douces Maternelles Bastille",
"type": "PRIMARY",
"distance": "< 100 m",
"walk_time": "1 min"
},
{
"name": "\u00c9cole Primaire Priv\u00e9e Massillon",
"type": "PRIMARY",
"distance": "126 m",
"walk_time": "2 min"
}
]
},
"bedrooms": 2,
"features": {
"categories": [
{
"title": "Informations g\u00e9n\u00e9rales",
"elements": [
{
"icon": "calm",
"value": "Calme"
},
{
"icon": "Orientation",
"value": "Exposition: ouest, est"
}
]
},
{
"title": "Accessibilit\u00e9",
"elements": [
{
"icon": "barrier-free",
"value": "Non accessible aux personnes \u00e0 mobilit\u00e9 r\u00e9duite"
},
{
"icon": "elevator",
"value": "Pas d'ascenseur"
}
]
}
],
"highlights": [
{
"icon": "floors",
"value": "Dernier \u00e9tage, \u00c9tage 4\u00e8me / 4"
},
{
"icon": "kitchen",
"value": "Cuisine ouverte"
}
]
},
"headline": "Exclusivit\u00e9. Paris 4\u00e8me - Dernier \u00e9tage - 2 chambres",
"provider": {
"name": "PARIS MARAIS SOTHEBY S IR",
"phones": [
"+33100000000"
],
"rating": 4.7,
"address": "39 RUE DE TURENNE, 75003 PARIS",
"fee_url": "https://www.parisouest-sothebysrealty.com/fr/mentions-legales-bareme/",
"website": null,
"logo_url": "https://mms.logic-immo.com/9/7/9/c/979cd793-ab50-4385-b043-060b1fe71d97.jpg?ci_seal=20b9d6786fadbfb2af562b6a072218691d99c168",
"agency_id": "B6HPBdNxeEw1nSFC7vJnzm",
"profile_url": "https://www.logic-immo.com/agences-immobilieres/B6HPBdNxeEw1nSFC7vJnzm",
"review_count": 91,
"private_owner": false,
"publisher_type": "AGENCY",
"legal_information": [
"SARL PARIS OUEST REALTY au capital de 10\u202f000\u00a0\u20ac",
"Garantie financi\u00e8re GALIAN pour un montant de 120\u202f000\u00a0\u20ac"
]
},
"bathrooms": 1,
"reference": "281513823",
"transport": [
{
"type": "METRO",
"lines": [
{
"name": "1",
"color": "#ffcd00"
}
]
}
],
"floorplans": [],
"breadcrumbs": [
{
"url": "https://www.logic-immo.com/",
"name": "Immobilier",
"position": 1
},
{
"url": "https://www.logic-immo.com/recherche-immo/vente/appartement/piece-4/france/ad02fr1",
"name": "A vendre appartement 4 pi\u00e8ces France",
"position": 2
}
],
"coordinates": {
"latitude": 48.85285412866809,
"longitude": 2.364320912038374
},
"description": "Exclusivit\u00e9. Paris 4\u00e8me. Dernier \u00e9tage. Charme et calme absolu. \r\n\r\nAu c\u0153ur du tr\u00e8s recherch\u00e9 4e arrondissement de Paris, entre la mythique Place des Vosges et les quais de Seine, d\u00e9couvrez cet appartement plein de charme, nich\u00e9 au calme absolu, sans aucun vis-\u00e0-vis et b\u00e9n\u00e9ficiant d'une belle lumino",
"short_title": "Appartement",
"surface_sqm": 50,
"co_ownership": [
{
"label": "Nombre de lots",
"value": "15"
},
{
"label": "Charges de copropri\u00e9t\u00e9",
"value": "1\u202f368\u00a0\u20ac/an"
}
],
"distribution": "BUY",
"property_type": "APARTMENT",
"virtual_tours": [
{
"url": "https://vimeo.com/1235013869/54ad1d78d0?share=copy&fl=sv&fe=ci",
"type": "VIRTUAL_TOUR"
}
],
"place_hierarchy": [
{
"id": "AD09FR29",
"type_key": "AD09"
}
],
"property_type_label": "Appartement",
"is_new_build_project": false,
"distribution_sub_type": {
"buy": "RESALE"
}
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Neither id nor a valid Logic-Immo listing URL was sent. This response is not billable.
{
"errors": {
"q": [
"The q field is required."
]
},
"message": "The request validation failed"
}Not Found
The listing is unknown, expired, or lives on a partner site. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Logic-Immo could not be reached, or returned data that does not match the expected shape. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Logic-Immo could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.