Immobiliare.it API

Get Immobiliare.it data with one API

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

I
/immobiliare/v1

3 active endpoints, on 0 and 1 credit tiers.

  • POST/immobiliare/v1/search
  • POST/immobiliare/v1/detail
  • POST/immobiliare/v1/geography

What Immobiliare.it endpoints does ReefAPI ship?

3 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

3 endpoints

search

1 cr

Search Immobiliare.it property listings by location (for sale or for rent), with structured f…

required
location
optional
contract, category, sort, home_type, page, price_min, price_max, rooms_min, rooms_max, surface_min, surface_max, baths_min

detail

1 cr

Full record for a single listing by its Immobiliare id (from a search result's id, or the num…

required
id
optional
location

geography

0 cr

Location autocomplete.

required
query
optional

Every parameter, every allowed value →

Immobiliare.it API

3 of 3 endpoints, ready to run

View docs ↗

Search Immobiliare.it property listings by location (for sale or for rent), with structured f…

1 credit1 required · 0 optional
POST/immobiliare/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Immobiliare.it API works

Immobiliare.it is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 185 engines.

02
Call
POST /immobiliare/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

What one Immobiliare.it listing actually contains

A single search row, measured for Roma on 2026-08-26. Prices are plain euros here — no cents trick — and the location block is already split into city, province, region and neighbourhood so you do not have to parse an address string.

FieldExampleWhat it means
id / url130988676The listing id and its immobiliare.it/annunci/ URL.
contractsalesale or rent. price_eur is the sale price, or the monthly rent when contract is rent.
price_eur / price_formatted590000 / € 590.000The number to compute with, and the string the site displays.
typologyTrilocaleThe Italian property type as listed, with typology_id alongside it. Trilocale means three rooms.
rooms / bedrooms / bathrooms3 / 2 / 2Rooms is locali, the Italian count that includes living rooms — not the same as bedrooms.
surface_m281Living surface in square metres.
floor / floor_label / elevator5 / 5°, con ascensore / trueFloor number, the displayed label, and whether the building has a lift.
heating / conditionCentralizzato / OttimoHeating type and the listed state of repair, in the site's own wording.
primary_photo_url / photo_countpwm.im-cdn.it/image/1970422276/xxl.jpgThe lead photo on Immobiliare's image CDN, and how many photos the ad has.
locationVia Flaminia 443, Roma, Lazioaddress, city, province, region, macrozone, microzone, latitude, longitude, country.
agencyLeonardo Leo ImmobiliareThe listing agency: id, name, type, profile URL, logo, agent name and the office phone shown on the ad.

meta carries the size of the market you just queried: total (24,889 properties for sale in Roma on 2026-08-26), 25 results per page and max_pages (996), plus the resolved geo block — label Roma, type comune, geo_id 6737 with coordinates.

What people build with Immobiliare.it

The jobs this data is most often used for.

3

endpoints

0/1

credits per call

01

Investors call search to track Italian listing prices.

02

Dashboards use detail to enrich a property.

03

Analysts use geography and typology to size a market.

What Immobiliare.it data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 185 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/immobiliare/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Roma"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Immobiliare.it.

Get a free key →
What is pwm.im-cdn.it, and how do I get Immobiliare photo URLs?

pwm.im-cdn.it is Immobiliare.it's image CDN — every listing photo is served from it. You do not have to construct those URLs: each search result returns primary_photo_url ready to use (for example https://pwm.im-cdn.it/image/1970422276/xxl.jpg, measured 2026-08-26) plus photo_count, and detail returns the rest of the gallery. Agency logos come from a sibling host, pic.im-cdn.it. The xxl segment is the size variant the site itself serves.

Do I need Immobiliare's internal geo-ids to search a city?

No. Pass location as a plain name — Roma, Milano, Napoli, Toscana — and it is resolved to the site's geo-ids for you, down to the most specific match. The response tells you what it resolved to, so you can check: Roma came back as type comune with geo_id 6737 on 2026-08-26. City, province and region all work, so you can widen or narrow without learning a second id system.

What does trilocale mean, and is rooms the same as bedrooms?

They are not the same, and mixing them up is the classic mistake on Italian listings. Rooms is locali, the Italian count that includes living rooms — the measured example was a trilocale (three locali) with 2 bedrooms and 2 bathrooms across 81 m². The API returns rooms, bedrooms, bathrooms and surface_m2 as separate fields, and rooms_min treats 3 as three-or-more.

Can I search rentals as well as properties for sale?

Yes — set contract to rent. price_eur then carries the monthly rent instead of the sale price, and price_min and price_max are read the same way. Everything else stays put, so the same code handles both markets.

How much Italian inventory is there, and how do I page through it?

More than you will want in one go. A sale search for Roma matched 24,889 properties on 2026-08-26, returned 25 per page over 996 pages. Page with page += 1, and narrow first with price_min, price_max, rooms_min, surface_min, baths_min and home_type (apartment, penthouse, villa, townhouse, farmhouse, garage and more) rather than walking the whole set. sort takes newest, price_low, price_high or surface_high.

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 an 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 an 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.

11 Real Estate APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Immobiliare.it, you are one call away from the rest of the category — no second contract, no second integration.

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 184 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts.