Real Estate

Immobiliare.it API

The Immobiliare API returns Italian real-estate listings as clean JSON.

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns listings with id, URL, price (EUR), contract, typology, rooms, bedrooms, bathrooms, surface (m2) and floor, and you can pull a detail and geography. It is built for real-estate tools and Italian property analytics that need Immobiliare data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/immobiliare/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "location": "Roma"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "immobiliare",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2230.7,
    "record_count": 25,
    "bytes": 184955,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "method": "api_next_json",
    "locale": "it-IT",
    "currency": "EUR",
    "total": 26272,
    "count": 25,
    "page": 1,
    "max_pages": 1051,
    "geo_label": "Roma",
    "filters_applied": {}
  },
  "data": {
    "results": [
      {
        "id": 130672636,
        "uuid": "f049a34a-15dc-51ad-94a3-0fe76373d76a",
        "url": "https://www.immobiliare.it/annunci/[redacted-phone]/",
        "contract": "sale",
        "title": "Trilocale via Flaminia, 443, Flaminio, Roma",
        "price_eur": 435000,
        "price_formatted": "€ 435.000",
        "is_new": true,
        "is_luxury": true,
        "typology": "Trilocale",
        "typology_id": 14,
        "category": "Residenziale",
        "rooms": 3,
        "bedrooms": 2,
        "bathrooms": 1,
        "surface_m2": 63,
        "floor": "5",
        "floor_label": "5°, con ascensore",
        "elevator": true,
        "heating": "Autonomo",
        "condition": "Ottimo / Ristrutturato",
        "views": [],
        "features": [
          "3 locali",
          "63 m²",
          "1 bagno"
        ],
        "photo_count": 23,
        "primary_photo_url": "https://pwm.im-cdn.it/image/[redacted-phone]/xxl.jpg",
        "description_preview": "VIVERE IL NUOVO NEL QUARTIERE FLAMINIO. QUINTO PIANO TRILOCALE 63 MQ PRONTO PER ESSERE ABITATO Flaminio, a ridosso di Ponte Milvio e Piazzale Cardinale Consalvi, proponiamo un nuovo, elegante e moderno appartamento posto al quinto piano di un bel palazzo di fine anni' 40 con ascensore. Luminoso e silenzioso, composto da: ingresso, accogliente soggiorno con cucina a vista e accesso su un balcone di 5 mq, due camere da letto e un bagno finestrato. Possibilità di cantina. Riscaldamento autonomo. MODALITA' D'ACQUISTO: OFFERTE A PARTIRE DA € 435.000,00 PREZZO DI VENDITA € 455.000,00 ZONA FLAMINI",
        "description_truncated": true,
        "location": {
          "address": "Via Flaminia, 443",
          "city": "Roma",
          "province": "Roma",
          "region": "Lazio",
          "macrozone": "Parioli, Flaminio",
          "microzone": "Flaminio",
          "latitude": 41.9333,
          "longitude": 12.467,
          "country": "Italia"
        },
        "agency": {
          "id": 474184,
          "name": "[redacted-name]",
          "type": "agency",
          "url": "https://www.immobiliare.it/agenzie-immobiliari/474184/leonardo-leo-immobiliare/",
          "logo_url": "https://pic.im-cdn.it/imagenoresize/[redacted-phone].jpg",
          "is_paid": true
        }
      },
      {
        "id": 130988676,
        "uuid": "7a18acbf-6775-5a1d-87fb-6b50d597e6d5",
        "url": "https://www.immobiliare.it/annunci/[redacted-phone]/",
        "contract": "sale",
        "title": "Trilocale via Flaminia, 443, Flaminio, Roma",
        "price_eur": 590000,
        "price_formatted": "€ 590.000",
        "is_new": true,
        "is_luxury": true,
        "typology": "Trilocale",
        "typology_id": 14,
        "category": "Residenziale",
        "rooms": 3,
        "bedrooms": 2,
        "bathrooms": 2,
        "surface_m2": 81,
        "floor": "5",
        "floor_label": "5°, con ascensore",
        "elevator": true,
        "heating": "Autonomo",
        "condition": "Ottimo / Ristrutturato",
        "views": [],
        "features": [
          "3 locali",
          "81 m²",
          "2 bagni"
        ],
        "photo_count": 27,
        "primary_photo_url": "https://pwm.im-cdn.it/image/[redacted-phone]/xxl.jpg",
        "description_preview": "QUINTO PIANO TRILOCALE 81 MQ CON BALCONE VIVERE IL NUOVO NEL QUARTIERE FLAMINIO. QUINTO PIANO TRILOCALE 81 MQ PRONTO PER ESSERE ABITATO Flaminio, a ridosso di Ponte Milvio e Piazzale Cardinale Consalvi, proponiamo un nuovo, elegante e moderno appartamento posto al quinto piano di un bel palazzo di fine anni' 40 con ascensore. Luminoso e silenzioso, composto da: ingresso, accogliente soggiorno con cucina a vista e accesso su un balcone vivibile di 10 mq, due camere da letto matrimoniali e due bagni. Possibilità di cantina. Riscaldamento autonomo. MODALITA' D'ACQUISTO: OFFERTE A PARTIRE DA € 590",
        "description_truncated": true,
        "location": {
          "address": "Via Flaminia, 443",
          "city": "Roma",
          "province": "Roma",
          "region": "Lazio",
          "macrozone": "Parioli, Flaminio",
          "microzone": "Flaminio",
          "latitude": 41.9333,
          "longitude": 12.467,
          "country": "Italia"
        },
        "agency": {
          "id": 474184,
          "name": "[redacted-name]",
          "type": "agency",
          "url": "https://www.immobiliare.it/agenzie-immobiliari/474184/leonardo-leo-immobiliare/",
          "logo_url": "https://pic.im-cdn.it/imagenoresize/[redacted-phone].jpg",
          "is_paid": true
        }
      },
      {
        "id": 126254147,
        "uuid": "66b[redacted-phone]a-5d5b-9b3f-3b6e5cf00d92",
        "url": "https://www.immobiliare.it/annunci/[redacted-phone]/",
        "contract": "sale",
        "title": "Appartamenti di nuova costruzione a Roma",
        "price_eur": 439000,
        "price_formatted": "€ 439.000 - € [redacted-phone]",
        "is_new": false,
        "is_luxury": false,
        "typology": "Progetto",
        "typology_id": 276,
        "category": "Nuove costruzioni",
        "rooms": null,
        "bedrooms": null,
        "bathrooms": null,
        "surface_m2": 47,
        "floor": null,
        "floor_label": null,
        "elevator": null,
        "heating": "Autonomo",
        "condition": null,
        "views": [
          "db_feature.view.id_9"
        ],
        "features": [
          "2 - 4 locali",
          "da 47 m²",
          "6 tipologie"
        ],
        "photo_count": 20,
        "primary_photo_url": "https://pwm.im-cdn.it/image/[redacted-phone]/xxl.jpg",
        "description_preview": "Nove appartamenti di pregio in vendita a Villa Torlonia, immersi nella quiete tra ville storiche e viali alberati, in una delle zone più comode e servite di Roma, in consegna a partire da Dicembre 2026. Un progetto firmato Kish Group di riqualificazione integrale che unisce design contemporaneo e comfort su misura, creando appartamenti eleganti e luminosi, con tagli variati e dettagli curati in ogni ambiente. Alcune unità dispongono di terrazze private che ampliano gli spazi interni, offrendo angoli di relax in totale privacy. Gli appartamenti sono dotati di impianti avanzati di riscaldament",
        "description_truncated": true,
        "location": {
          "address": "Via Forlì, 31",
          "city": "Roma",
          "province": "Roma",
          "region": "Lazio",
          "macrozone": "Bologna, Policlinico",
          "microzone": "Policlinico",
          "latitude": 41.9102,
          "longitude": 12.5153,
          "country": "Italia"
        },
        "agency": {
          "id": 467085,
          "name": "[redacted-name]",
          "type": "constructor",
          "url": "https://www.immobiliare.it/imprese-edili/467085/casina-forli/",
          "logo_url": null,
          "is_paid": true
        }
      }
    ],
    "total": 26272,
    "count": 25,
    "page": 1,
    "max_pages": 1051,
    "geo": {
      "label": "Roma",
      "type": "comune",
      "geo_id": "6737",
      "latitude": 41.8955,
      "longitude": 12.4823,
      "search_params": {
        "idComune": "6737"
      }
    },
    "filters_applied": {}
  }
}

Actions

What the Immobiliare.it API does

Action	Description	Concrete use case	Key params
search	Search Immobiliare.it property listings by location (for sale or for rent), with structured filters: price (EUR), rooms, surface (m²), bathrooms, property type and sort. Each result carries price, rooms, bathrooms, surface, floor, typology, features, agency, map coordinates and the primary photo. Paginate with page.	Real-estate investors call search to search Immobiliare.it property listings by location (for sale or for rent), with structured f….	location, contract, category, sort, home_type, ...
detail	Full record for a single listing by its Immobiliare id (from a search result's `id`, or the number in an immobiliare.it/annunci/<id>/ URL). Returns every structured field plus all photos at full resolution. Note: the long description text is the portal preview (~600 chars); the complete prose lives on the DataDome-protected listing page.	Brokerage tools call detail to get full record for a single listing by its Immobiliare id (from a search result's `id`, or the n….	id, location
geography	Location autocomplete — resolve a free-text Italian place name to Immobiliare's geo-ids (comune / province / region) with centre coordinates. Use it to power a search box or to get the exact ids the search needs. Returns ready-to-use search_params for each match.	Property dashboards call geography to get location autocomplete.	query

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/immobiliare/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Roma"}'

import requests

r = requests.post(
    "https://api.reefapi.com/immobiliare/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "location": "Roma"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/immobiliare/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "location": "Roma"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.immobiliare.search with {"location":"Roma"}.

Use cases

Who uses this API and why

Investors call search to track Italian listing prices.
Dashboards use detail to enrich a property.
Analysts use geography and typology to size a market.

FAQ

Questions developers ask before integrating

What is the Immobiliare.it API?

Immobiliare.it API is a ReefAPI endpoint group for immobiliare.it It returns live JSON through POST requests under /immobiliare/v1.

Is the Immobiliare.it API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Immobiliare.it calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Immobiliare.it login or account?

No login to Immobiliare.it is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Immobiliare.it data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Immobiliare.it API use?

Immobiliare.it actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Immobiliare.it from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call immobiliare actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Immobiliare.it API a Immobiliare.it scraper?

It is the managed alternative to a DIY Immobiliare.it scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same immobiliare.it back as clean JSON.

Why does my Immobiliare.it scraper keep getting blocked?

Most Immobiliare.it scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / immobiliare

Immobiliare.it

base /immobiliare/v13 endpoints

post/immobiliare/v1/search1 credit

Search Immobiliare.it property listings by location (for sale or for rent), with structured filters: price (EUR), rooms, surface (m²), bathrooms, property type and sort. Each result carries price, rooms, bathrooms, surface, floor, typology, features, agency, map coordinates and the primary photo. Paginate with page.

Parameter		Allowed / range	Description
location	required	—	Where to search — an Italian city, province or region ('Roma', 'Milano', 'Napoli', 'Toscana'). Resolved to Immobiliare's geo-ids automatically (deepest match: city > province > region).
contract = sale	optional	sale · rent	Listing type.
category = residential	optional	residential · rooms	Property category.
sort = relevance	optional	relevance · newest · price_low · price_high · surface_high	Result ordering.
home_type	optional	—	Property typology — one or several comma-separated: apartment, penthouse, villa, villa_terraced, townhouse, farmhouse, building, garage. e.g. 'apartment,penthouse'.
page = 1	optional	1–	Result page (25 listings per page; paginate with page += 1).
price_min	optional	0–	Minimum price in EUR (sale price, or monthly rent when contract=rent).
price_max	optional	0–	Maximum price in EUR.
rooms_min	optional	1–20	Minimum number of rooms (locali). 3 = 3+.
rooms_max	optional	1–20	Maximum number of rooms (locali).
surface_min	optional	0–	Minimum living surface in square metres (m²).
surface_max	optional	0–	Maximum living surface in square metres (m²).
baths_min	optional	1–10	Minimum number of bathrooms. 2 = 2+.

Try in playground →

post/immobiliare/v1/detail1 credit

Full record for a single listing by its Immobiliare id (from a search result's `id`, or the number in an immobiliare.it/annunci/<id>/ URL). Returns every structured field plus all photos at full resolution. Note: the long description text is the portal preview (~600 chars); the complete prose lives on the DataDome-protected listing page.

Parameter		Allowed / range	Description
id	required	—	Immobiliare listing id (the number in an immobiliare.it/annunci/<id>/ URL, or a search result's `id`).
location	optional	—	Optional hint of the listing's city to speed up the lookup (otherwise the listing's own city is resolved from search).

Try in playground →

post/immobiliare/v1/geographyfree

Location autocomplete — resolve a free-text Italian place name to Immobiliare's geo-ids (comune / province / region) with centre coordinates. Use it to power a search box or to get the exact ids the search needs. Returns ready-to-use search_params for each match.

Parameter		Allowed / range	Description
query	required	—	Free-text Italian place to autocomplete — a partial city, province or region ('Rom', 'Mil', 'Tosc').
limit = 10	optional	1–20	Max suggestions to return (1-20).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/immobiliare/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Roma"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}