# Logic-Immo Listing API Documentation

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:

- **Documentation:** [https://scrappa.co/docs/logic-immo-api/logic_immo_listing](https://scrappa.co/docs/logic-immo-api/logic_immo_listing) - **API group:** Logic-Immo API - **Endpoint:** `GET https://scrappa.co/api/logic-immo/listing` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | No | Listing id from search results. Example: 263GWUMK8M3F. Required unless url is sent. | | `url` | string | No | The listing page URL from a search result. Replaces id and saves one lookup. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | Neither id nor a valid Logic-Immo listing URL was sent. This response is not billable. | | 404 | Not Found | The listing is unknown, expired, or lives on a partner site. This response is not billable. | | 503 | 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. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)