docs / immobiliare

Immobiliare.it API scraper

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
}