{
  "openapi": "3.0.1",
  "info": {
    "title": "Immobiliare.it Listings Scraper",
    "description": "Scrape Immobiliare.it (Italy) property listings for sale and rent by city, province, region, map area or search URL: price, size, rooms, GPS, agency and phone, photos, plus optional energy class and costs. Export to JSON, CSV or Excel.",
    "version": "0.0",
    "x-build-id": "swnz9sqkCk5UuOs6q"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nice_dev~immobiliare-listings-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nice_dev-immobiliare-listings-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nice_dev~immobiliare-listings-scraper/runs": {
      "post": {
        "operationId": "runs-sync-nice_dev-immobiliare-listings-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nice_dev~immobiliare-listings-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-nice_dev-immobiliare-listings-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "operation": {
            "title": "Operation",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "For sale or for rent. Ignored for pasted URLs (they keep their own).",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "homes",
              "newDevelopments",
              "rooms",
              "offices",
              "commercial",
              "garages",
              "storageRooms",
              "sheds",
              "lands",
              "buildings"
            ],
            "type": "string",
            "description": "Category searched, as in the site's menu. Ignored for pasted URLs.",
            "default": "homes"
          },
          "homeTypes": {
            "title": "Home types",
            "uniqueItems": true,
            "type": "array",
            "description": "Only these kinds of homes (Property type = Homes). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "penthouse",
                "detachedHouse",
                "villa",
                "loft"
              ],
              "enumTitles": [
                "Apartment",
                "Penthouse (attico)",
                "Detached house",
                "Villa",
                "Loft"
              ]
            },
            "default": []
          },
          "location": {
            "title": "Location",
            "maxLength": 200,
            "type": "string",
            "description": "Italian city, province or region, as typed on the site (e.g. `Bologna`, `Provincia di Milano`, `Toscana`). The first match of the site's own suggestions is used; the run log says which one. A name several towns share: add the province (`Samone, Trento` or `Samone (TN)`)."
          },
          "locations": {
            "title": "More locations",
            "maxItems": 100,
            "uniqueItems": true,
            "type": "array",
            "description": "Several locations in one run: one search per location (times each keyword below, max 500 searches). Added to **Location**.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "query": {
            "title": "Keyword",
            "maxLength": 100,
            "type": "string",
            "description": "Word that must appear in the listing (the site's own keyword filter, e.g. `terrazzo`, `vista mare`). Empty = no keyword."
          },
          "searchQueries": {
            "title": "More keywords",
            "maxItems": 50,
            "uniqueItems": true,
            "type": "array",
            "description": "Several keywords in one run: one search per keyword (times each location). Added to **Keyword**; listings found by several searches are saved once.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "maxItems": 1000,
            "type": "array",
            "description": "Immobiliare.it search-result URLs (every filter set on the site is kept, pagination is automatic, map searches too) or single listing URLs (`https://www.immobiliare.it/annunci/123456789/`). When this list is not empty, Location, Keyword, point and polygon are ignored; the filters below still apply to search URLs. Max 1 000 URLs.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "listingIds": {
            "title": "Listing IDs",
            "maxItems": 1000,
            "uniqueItems": true,
            "type": "array",
            "description": "Listing numbers (the digits of `/annunci/<id>/`). Each one is read with its details (charged as a listing plus its details). Given alone, only these listings are returned.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "latitude": {
            "title": "Latitude (point search)",
            "minimum": 35,
            "maximum": 48,
            "type": "number",
            "description": "Search around a point instead of a location: latitude in decimal degrees, e.g. 45.4642 (Milan). Needs Longitude; Radius sets the distance."
          },
          "longitude": {
            "title": "Longitude (point search)",
            "minimum": 6,
            "maximum": 19,
            "type": "number",
            "description": "Longitude in decimal degrees, e.g. 9.19 (Milan)."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0.1,
            "maximum": 50,
            "type": "number",
            "description": "Distance around the point, in kilometres.",
            "default": 2
          },
          "polygon": {
            "title": "Polygon (map search)",
            "maxLength": 4000,
            "type": "string",
            "description": "Draw your own area: corner points as `latitude,longitude` separated by `;` (at least 3, at most 100), e.g. `45.47,9.17;45.47,9.21;45.45,9.21;45.45,9.17`."
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "maximum": 200000,
            "type": "integer",
            "description": "Maximum number of listings to save for the whole run (after deduplication and filters). 0 = no limit.",
            "default": 100
          },
          "maxItemsPerQuery": {
            "title": "Max listings per search",
            "minimum": 0,
            "maximum": 200000,
            "type": "integer",
            "description": "Cap for EACH search (location × keyword, or search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.",
            "default": 0
          },
          "splitLargeSearches": {
            "title": "Get every listing of large searches",
            "type": "boolean",
            "description": "The site shows at most 2 000 listings per search. On: a larger search is cut into price bands, each under that limit, so that every listing is returned (duplicates removed). Off: the first 2 000 only.",
            "default": true
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "oldest",
              "priceLow",
              "priceHigh",
              "sizeLarge",
              "sizeSmall",
              "roomsMost",
              "roomsLeast"
            ],
            "type": "string",
            "description": "Order of the results, as on the site. With **Only new listings**, Relevance becomes Newest first, so that a search can stop at the listings already delivered.",
            "default": "relevance"
          },
          "language": {
            "title": "Language of the results",
            "enum": [
              "it",
              "en",
              "de",
              "es",
              "fr",
              "pt",
              "el"
            ],
            "type": "string",
            "description": "Language of titles, typologies and floors, and of the description when the advertiser gave a translation (the site's own translations); otherwise the listing page shows, and the Actor returns with details, the original text. Italian = the site default.",
            "default": "it"
          },
          "includeDetails": {
            "title": "Include listing details",
            "type": "boolean",
            "description": "Open each listing page for the full description, energy class and performance, condominium and heating costs, publication and update dates, building year, condition, all features, agency reference and price per m². Charged per listing with details (see Pricing). Off = the search-result fields only (price, size, rooms, GPS, zone, agency and phones, 600-character description).",
            "default": false
          },
          "includeAgencyProfile": {
            "title": "Include agency profile",
            "type": "boolean",
            "description": "Adds each listing's agency profile: its own website, office address and position, direct phone numbers (landline and mobile), presentation, opening hours, listings on sale and sold. One lookup per agency. Charged per listing delivered with it (see Pricing); never for a private seller.",
            "default": false
          },
          "enrichEmails": {
            "title": "Find agency e-mails",
            "type": "boolean",
            "description": "Visits each agency's own website (home page + contact / legal pages, 3 pages max) and adds the e-mail addresses published there. Slower. Charged per listing delivered with an e-mail (see Pricing); never when none is found.",
            "default": false
          },
          "minPrice": {
            "title": "Min price (€)",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Lowest price, in euros (monthly rent for rentals)."
          },
          "maxPrice": {
            "title": "Max price (€)",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Highest price, in euros (monthly rent for rentals)."
          },
          "minSize": {
            "title": "Min size (m²)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Smallest surface, in square metres."
          },
          "maxSize": {
            "title": "Max size (m²)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Largest surface, in square metres."
          },
          "minRooms": {
            "title": "Min rooms (locali)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Fewest rooms, counted like the site (`locali`: bedrooms + living rooms, kitchen excluded)."
          },
          "maxRooms": {
            "title": "Max rooms (locali)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Most rooms (`locali`)."
          },
          "minBedrooms": {
            "title": "Min bedrooms",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Fewest bedrooms."
          },
          "maxBedrooms": {
            "title": "Max bedrooms",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Most bedrooms."
          },
          "bathrooms": {
            "title": "Bathrooms",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4+"
            ],
            "type": "string",
            "description": "Exact number of bathrooms, as on the site.",
            "default": ""
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "",
              "new",
              "renovated",
              "good",
              "toRenovate"
            ],
            "type": "string",
            "description": "State of the property.",
            "default": ""
          },
          "floors": {
            "title": "Floor",
            "uniqueItems": true,
            "type": "array",
            "description": "Ground floor, intermediate floors and/or top floor. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "ground",
                "intermediate",
                "top"
              ],
              "enumTitles": [
                "Ground floor",
                "Intermediate floors",
                "Top floor"
              ]
            },
            "default": []
          },
          "garden": {
            "title": "Garden",
            "uniqueItems": true,
            "type": "array",
            "description": "Private and/or shared garden. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "private",
                "shared"
              ],
              "enumTitles": [
                "Private garden",
                "Shared garden"
              ]
            },
            "default": []
          },
          "garage": {
            "title": "Garage / parking",
            "uniqueItems": true,
            "type": "array",
            "description": "Single garage, double garage and/or parking space. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "single",
                "double",
                "parkingSpace"
              ],
              "enumTitles": [
                "Single garage",
                "Double garage",
                "Parking space"
              ]
            },
            "default": []
          },
          "heating": {
            "title": "Heating",
            "uniqueItems": true,
            "type": "array",
            "description": "Independent heating, central heating and/or air conditioning. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "independent",
                "central",
                "airConditioning"
              ],
              "enumTitles": [
                "Independent (autonomo)",
                "Central (centralizzato)",
                "Air conditioning"
              ]
            },
            "default": []
          },
          "balconyTerrace": {
            "title": "Balcony / terrace",
            "uniqueItems": true,
            "type": "array",
            "description": "With a balcony and/or a terrace. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "balcony",
                "terrace"
              ],
              "enumTitles": [
                "Balcony",
                "Terrace"
              ]
            },
            "default": []
          },
          "ownership": {
            "title": "Ownership",
            "enum": [
              "",
              "full",
              "bare",
              "partial",
              "usufruct",
              "timeshare",
              "landLease"
            ],
            "type": "string",
            "description": "Kind of ownership sold.",
            "default": ""
          },
          "hasElevator": {
            "title": "Elevator",
            "type": "boolean",
            "description": "Only listings with an elevator.",
            "default": false
          },
          "hasBasement": {
            "title": "Cellar",
            "type": "boolean",
            "description": "Only listings with a cellar (cantina).",
            "default": false
          },
          "hasSwimmingPool": {
            "title": "Swimming pool",
            "type": "boolean",
            "description": "Only listings with a swimming pool.",
            "default": false
          },
          "furnished": {
            "title": "Furnished",
            "type": "boolean",
            "description": "Only furnished properties.",
            "default": false
          },
          "virtualTourOnly": {
            "title": "With virtual tour",
            "type": "boolean",
            "description": "Only listings with a virtual tour.",
            "default": false
          },
          "excludeAuctions": {
            "title": "Exclude auctions",
            "type": "boolean",
            "description": "Leave out properties sold at auction (aste).",
            "default": false
          },
          "rentedOnly": {
            "title": "Rented (investment) only",
            "type": "boolean",
            "description": "Only properties sold with a tenant in place (a reddito).",
            "default": false
          },
          "postedAfter": {
            "title": "Posted after",
            "type": "string",
            "description": "Only listings first published on or after this date (the date the listing page gives, so it needs **Include listing details**): `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too)."
          },
          "postedBefore": {
            "title": "Posted before",
            "type": "string",
            "description": "Only listings first published on or before this date (the whole day is included), or older than a period such as `30 days`. Needs **Include listing details**."
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "maxItems": 50,
            "uniqueItems": true,
            "type": "array",
            "description": "Drop the listings whose title or description contains one of these words (case and accents ignored).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "privateSellersOnly": {
            "title": "Private sellers only",
            "type": "boolean",
            "description": "Only listings posted by private owners (no agency).",
            "default": false
          },
          "agenciesOnly": {
            "title": "Agencies only",
            "type": "boolean",
            "description": "Only listings posted by an agency or a builder.",
            "default": false
          },
          "requirePhone": {
            "title": "With phone number only",
            "type": "boolean",
            "description": "Only listings that show at least one phone number.",
            "default": false
          },
          "excludeNewDevelopments": {
            "title": "Exclude new developments",
            "type": "boolean",
            "description": "Leave out the new-build projects that group several units in one listing.",
            "default": false
          },
          "onlyPriceDrops": {
            "title": "Price drops only",
            "type": "boolean",
            "description": "Only listings whose price was lowered (the site shows the former price).",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Min price drop (%)",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "Only listings whose price dropped by at least this percentage (setting it switches **Price drops only** on by itself)."
          },
          "onlyNew": {
            "title": "Only new listings",
            "type": "boolean",
            "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged. First run = everything is new. Works best with **Sort by** = Newest first.",
            "default": false
          },
          "stateKey": {
            "title": "Memory key",
            "pattern": "^[a-zA-Z0-9_-]{1,64}$",
            "maxLength": 64,
            "type": "string",
            "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `milano-rentals`) so that they do not share their memory. Letters, digits, `-` and `_`.",
            "default": "default"
          },
          "resetState": {
            "title": "Reset the memory",
            "type": "boolean",
            "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.",
            "default": {
              "useApifyProxy": true
            }
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of result pages read in parallel.",
            "default": 4
          },
          "maxRequestsPerMinute": {
            "title": "Max requests per minute",
            "minimum": 10,
            "maximum": 1000,
            "type": "integer",
            "description": "Budget of requests per minute for the whole run.",
            "default": 150
          },
          "minRequestIntervalMs": {
            "title": "Min delay between requests",
            "minimum": 0,
            "maximum": 60000,
            "type": "integer",
            "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute budget, this spreads the requests evenly. 0 = no gap.",
            "default": 300
          },
          "maxRequestRetries": {
            "title": "Max request retries",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Retries per request before it is marked as failed. A request the site turns away is also retried at once on a new proxy session up to 10 times without using up these retries.",
            "default": 5
          },
          "debugLog": {
            "title": "Debug log",
            "type": "boolean",
            "description": "Include debug messages in the run log.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}