# Logic-Immo Search API Documentation
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.
- **Documentation:** [https://scrappa.co/docs/logic-immo-api/logic_immo_search](https://scrappa.co/docs/logic-immo-api/logic_immo_search)
- **API group:** Logic-Immo API
- **Endpoint:** `GET https://scrappa.co/api/logic-immo/search`
## 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 |
| --- | --- | --- | --- |
| `place_id` | string | Yes | Place id from the autocomplete route. Example: AD08FR31096 for Paris. Required. |
| `distribution` | string | No | buy (default) or rent. |
| `estate_types` | string | No | apartment, house, plot, parking, office, trading, building or miscellaneous, comma separated. Leave empty for all types. |
| `new_build` | boolean | No | true for new-build projects only. |
| `price_min` | integer | No | Minimum price in EUR. For rent this is the monthly rent. |
| `price_max` | integer | No | Maximum price in EUR. |
| `size_min` | integer | No | Minimum living area in square meters. |
| `size_max` | integer | No | Maximum living area in square meters. |
| `rooms_min` | integer | No | Minimum number of rooms. |
| `rooms_max` | integer | No | Maximum number of rooms. |
| `bedrooms_min` | integer | No | Minimum number of bedrooms. |
| `bedrooms_max` | integer | No | Maximum number of bedrooms. |
| `year_built_min` | integer | No | Earliest year of construction. |
| `order` | string | No | Default, PriceAsc, PriceDesc or DateDesc. |
| `page` | integer | No | One-based page number, default 1. |
| `per_page` | integer | No | Results per page, 1 to 50, default 25. |
## Example response
```json
{
"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
| Status | Error | Description |
| --- | --- | --- |
| 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. |
| 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)