Skip to content
Scrappa Get API key
Logic-Immo API 1 credit/request

Logic-Immo Search API Documentation

GET https://scrappa.co/api/logic-immo/search

Logic-Immo Search API lists French properties for sale or for rent in one place. Find a place_id with the autocomplete route, then add price, size, room, bedroom, type, new-build and year filters. Every result has the price in EUR with the text form and the price per square meter, living and plot area, rooms, bedrooms, address with district, public transport, photos, floor plans, headline, description, energy class, place hierarchy, tags, dates and the agency block with phones and address. The response has total_count, page, per_page and total_pages.

Good to know:

  • Every filter is checked. A card that breaks a numeric filter is never returned, and meta.dropped counts what was removed.
  • There is no bathrooms filter on Logic-Immo, so bathrooms_min and similar parameters return 422. Bathroom counts are on the listing route.
  • A price of null or 1 EUR is returned as price.on_request: true with a null value. It is never shown as a real price.
  • Page 2 is really page 2. A page past total_pages returns an empty list, never page 1 again.
  • Suggested listings that Logic-Immo mixes in are removed.
  • Some results come from partner sites and have has_detail_page: false.
  • Totals move by a few listings between calls because the listings are live.
  • A valid empty result is a successful, billed answer. Failed requests are not billed.
Logic-Immo Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/logic-immo/search
Auth header
x-api-key
Cost
1 credit/request
place_id = 1234567890
Response preview
200 OK
{
    "data": {
        "page": 1,
        "order": "PriceDesc",
        "results": [
            {
                "id": "263GWUMK8M3F",
                "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/263GWUMK8M3F",
                "tags": {
                    "new": true,
                    "exclusive": true,
                    "brokerage_fee": false,
                    "virtual_visit_3d": true
                },
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

15 optional filters available.

place_id string Required

Place id from the autocomplete route. Example: AD08FR31096 for Paris. Required.

Example value 1234567890
distribution string Optional

buy (default) or rent.

Example value example
estate_types string Optional

apartment, house, plot, parking, office, trading, building or miscellaneous, comma separated. Leave empty for all types.

Example value example
new_build boolean Optional

true for new-build projects only.

Example value true
price_min integer Optional

Minimum price in EUR. For rent this is the monthly rent.

Example value 10
price_max integer Optional

Maximum price in EUR.

Example value 10
size_min integer Optional

Minimum living area in square meters.

Example value 10
size_max integer Optional

Maximum living area in square meters.

Example value 10
rooms_min integer Optional

Minimum number of rooms.

Example value 10
rooms_max integer Optional

Maximum number of rooms.

Example value 10
bedrooms_min integer Optional

Minimum number of bedrooms.

Example value 10
bedrooms_max integer Optional

Maximum number of bedrooms.

Example value 10
year_built_min integer Optional

Earliest year of construction.

Example value 10
order string Optional

Default, PriceAsc, PriceDesc or DateDesc.

Example value example
page integer Optional

One-based page number, default 1.

Example value 1
per_page integer Optional

Results per page, 1 to 50, default 25.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "page": 1,
        "order": "PriceDesc",
        "results": [
            {
                "id": "263GWUMK8M3F",
                "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/263GWUMK8M3F",
                "tags": {
                    "new": true,
                    "exclusive": true,
                    "brokerage_fee": false,
                    "virtual_visit_3d": true
                },
                "type": "PROFESSIONAL",
                "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": {
                    "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",
                "images": [
                    {
                        "alt": "Appartement \u00e0 vendre 600\u202f000\u00a0\u20ac 4 pi\u00e8ces 2 chambres 50 m\u00b2 \u00c9tage 4/4 Paris 4\u00e8me arrondissement 75004",
                        "url": "https://cdnihddipa.cloudimg.io/c/a/0/3/ca0367ce-9ff0-4d3e-b7af-7e987a5adeaa.jpg?ci_seal=2630d2a658f20f22d0f254fecb1852909df9b9e2",
                        "class": null
                    },
                    {
                        "alt": null,
                        "url": "https://cdnihddipa.cloudimg.io/5/2/e/d/52ed4b17-837b-4e28-8127-33f4bc383795.jpg?ci_seal=64727f857c31e6d0dfb905f1bf4631fdf5694240",
                        "class": null
                    }
                ],
                "portal": "logicimmo",
                "status": "Published",
                "address": {
                    "city": "Paris 4\u00e8me arrondissement",
                    "district": "Arsenal",
                    "zip_code": "75004"
                },
                "surface": {
                    "main_sqm": 50,
                    "plot_sqm": null
                },
                "bedrooms": 2,
                "headline": "Exclusivit\u00e9. Paris 4\u00e8me - Dernier \u00e9tage - 2 chambres",
                "provider": {
                    "name": "PARIS MARAIS SOTHEBY S IR",
                    "phones": [
                        "+33100000000"
                    ],
                    "address": "39 RUE DE TURENNE, 75003 PARIS",
                    "fee_url": "https://www.parisouest-sothebysrealty.com/fr/mentions-legales-bareme/",
                    "website": null,
                    "logo_url": "https://cdnihddipa.cloudimg.io/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",
                    "private_owner": false,
                    "publisher_type": "AGENCY"
                },
                "reference": "281513823",
                "transport": [
                    {
                        "type": "METRO",
                        "lines": [
                            {
                                "name": "1",
                                "color": "#ffcd00"
                            }
                        ]
                    }
                ],
                "floorplans": [],
                "description": "Exclusivit\u00e9. Paris 4\u00e8me. Dernier \u00e9tage. Charme et calme absolu. Au 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 luminosit\u00e9",
                "photo_count": 12,
                "short_title": "Appartement",
                "distribution": "BUY",
                "energy_class": "E",
                "is_suggestion": false,
                "property_type": "APARTMENT",
                "has_detail_page": true,
                "place_hierarchy": [
                    {
                        "id": "AD09FR29",
                        "type_key": "AD09"
                    }
                ],
                "year_of_construction": null
            },
            {
                "id": "26L28ASL8JFR",
                "url": "https://www.logic-immo.com/detail-annonce/vente/ile-de-france/paris-75/paris-75000/26L28ASL8JFR",
                "tags": {
                    "new": true,
                    "exclusive": true,
                    "brokerage_fee": false,
                    "virtual_visit_3d": false
                },
                "type": "PROFESSIONAL",
                "brand": "logicimmo",
                "dates": {
                    "created_at": "2026-06-26T17:27:00Z",
                    "updated_at": "2026-10-25T00:56:19.094Z"
                },
                "facts": [
                    {
                        "type": "numberOfRooms",
                        "label": "pi\u00e8ces",
                        "value": "3 pi\u00e8ces"
                    }
                ],
                "price": {
                    "value": 600000,
                    "currency": "EUR",
                    "formatted": "600\u202f000\u00a0\u20ac",
                    "on_request": false,
                    "per_sqm_text": "8\u202f333,33\u00a0\u20ac/m\u00b2"
                },
                "rooms": 3,
                "title": "Appartement \u00e0 vendre",
                "images": [
                    {
                        "alt": "Appartement \u00e0 vendre 600\u202f000\u00a0\u20ac 3 pi\u00e8ces 2 chambres 72 m\u00b2 \u00c9tage 2/6 Paris 18\u00e8me arrondissement 75018",
                        "url": "https://cdnihddipa.cloudimg.io/d/2/6/d/d26dffe6-5f23-4864-b980-ddf0e776c2d6.jpg?ci_seal=d4a10d29b23b91db34d6f1cb118b79c49edcdd0c",
                        "class": null
                    },
                    {
                        "alt": null,
                        "url": "https://cdnihddipa.cloudimg.io/7/c/3/0/7c30b61c-15a4-478e-9d82-7afce9b7c19b.jpg?ci_seal=70255d6fbca7b55a96e32dafdf267bd2e19b07ce",
                        "class": null
                    }
                ],
                "portal": "logicimmo",
                "status": "Published",
                "address": {
                    "city": "Paris 18\u00e8me arrondissement",
                    "district": "La Chapelle-Marx Dormoy",
                    "zip_code": "75018"
                },
                "surface": {
                    "main_sqm": 72,
                    "plot_sqm": null
                },
                "bedrooms": 2,
                "headline": "Exclusivit\u00e9 - Paris XVIII, Marx Dormoy - Appartement 72 m\u00b2 / 2 c",
                "provider": {
                    "name": "Engel & V\u00f6lkers Marais",
                    "phones": [
                        "0159302026"
                    ],
                    "address": "19 rue du Roi de Sicile, 75004 Paris",
                    "fee_url": "https://www.engelvoelkers.com:443/fr-fr/paris/doc/honoraires.png",
                    "website": "https://www.engelvoelkers.com/fr-fr/paris/",
                    "logo_url": "https://cdnihddipa.cloudimg.io/6/8/b/9/68b9d292-1d71-4a3e-8b29-78da2ac79732.jpg?ci_seal=1c6378781b1ad4539ea1eb0662b9a79d858a9afe",
                    "agency_id": "XmnC3qsf4J5XgsHNMmaA7h",
                    "profile_url": "https://www.logic-immo.com/agences-immobilieres/XmnC3qsf4J5XgsHNMmaA7h",
                    "private_owner": false,
                    "publisher_type": "AGENCY"
                },
                "reference": "273496995",
                "transport": [
                    {
                        "type": "METRO",
                        "lines": [
                            {
                                "name": "12",
                                "color": "#007a53"
                            }
                        ]
                    }
                ],
                "floorplans": [],
                "description": "\u00c0 deux pas du m\u00e9tro Marx Dormoy, Engel & V\u00f6lkers vous pr\u00e9sente en exclusivit\u00e9 ce magnifique appartement de 72,06 m\u00b2 Carrez et 74,35 m\u00b2 au sol, situ\u00e9 au 2 \u20ac \u00e9tage d'une petite copropri\u00e9t\u00e9 bien entretenue. Traversant et baign\u00e9 de lumi\u00e8re, cet appartement cl\u00e9 en main a b\u00e9n\u00e9fici\u00e9 d'une r\u00e9novation r\u00e9cent",
                "photo_count": 11,
                "short_title": "Appartement",
                "distribution": "BUY",
                "energy_class": "D",
                "is_suggestion": false,
                "property_type": "APARTMENT",
                "has_detail_page": true,
                "place_hierarchy": [
                    {
                        "id": "AD09FR43",
                        "type_key": "AD09"
                    }
                ],
                "year_of_construction": 1801
            }
        ],
        "per_page": 5,
        "place_id": "AD08FR31096",
        "total_count": 1863,
        "total_pages": 373
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

The place id is missing or malformed, a value is outside its allowed list, a range is reversed, or a bathrooms filter was sent. This response is not billable.

{
    "errors": {
        "q": [
            "The q field is required."
        ]
    },
    "message": "The request validation failed"
}
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.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "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.