Search Listings

Search a market’s portal for listings. Target an area either with free-text location (auto-resolved via autocomplete) or with precise geography ids (region_id / province_id / city_id, e.g. from /autocomplete).

Query Parameters

string

default:"it"

Market to search. One of it, es, gr, lu.

string

Free-text place, auto-resolved to a geography — e.g. Milano, Roma Trastevere. Provide either location or the id parameters below.

string

Region id (from /autocomplete). Alternative to location.

string

Province id (from /autocomplete).

string

City (comune) id (from /autocomplete).

string

default:"sale"

Contract type. One of sale, rent.

string

default:"residential"

Listing category. One of residential, commercial, garages, offices, land, buildings, warehouses.

integer

Minimum price (EUR).

integer

Maximum price (EUR).

integer

Minimum surface (m²).

integer

Maximum surface (m²).

integer

Minimum number of rooms.

integer

Maximum number of rooms.

integer

Minimum number of bathrooms.

string

default:"relevance"

Sort order. One of relevance, price_asc, price_desc, newest, oldest, surface_desc, surface_asc.

integer

default:"1"

Result page.

Response

Listing[]

Listing cards for this page.

Show Listing

integer

Immobiliare listing id — feed to /listings/{id}.

string

Stable listing UUID.

string

Canonical listing URL on the market’s portal.

string

sale or rent.

boolean

New construction.

boolean

Luxury (LuxuryEstate) listing.

boolean

Off-plan / development project.

boolean

Multi-unit “mosaic” listing grouping several units.

string

Paid visibility tier, e.g. premium, top, star.

string

Property typology, e.g. Apartment, Villa.

string

e.g. residential.

object

Show price

integer

Price in EUR (null when hidden).

string

e.g. € 285.000.

integer

Range lower bound (project/mosaic listings).

integer

Range upper bound.

string

Always EUR.

boolean

false = price on request.

string

e.g. 3.353 €/m².

string

Estimated loan installment, e.g. € 741/month.

object

Show location

string

number

string

e.g. IT.

string

e.g. 85 m².

string

integer

boolean

Photo[]

Show Photo

integer

string

Small image URL.

string

Medium image URL.

string

Large image URL.

object

Show agency

integer

Agency id — feed to /agencies/{id}.

string

e.g. agency, builder.

string

Agency profile URL on the portal.

boolean

string

string[]

object

Show agent

string

string[]

integer

Number of units in this listing.

PropertyUnit[]

Per-unit breakdown (a plain listing has one main unit; projects/mosaics have several).

Show PropertyUnit

boolean

string

e.g. 85 m².

number

Numeric surface (m²).

string

e.g. 3° floor, with lift.

boolean

string

e.g. 1 in garage/box.

string

e.g. Centralized, radiators, gas powered.

string

e.g. € 120/month.

string

Feature[]

Show Feature

string

e.g. balcony.

string

string[]

Machine-readable feature slugs.

string[]

Views, e.g. sea view.

Photo[]

Same shape as the listing-level photos[].

string

When the listing was published.

string

Last modification (UTC, ISO 8601).

string

Last modification (portal-local formatting).

string[]

All feature labels, flattened.

integer

Listings returned on this page.

integer

Total matching listings.

integer

Last available page.

boolean

true when the portal capped the result set — narrow the filters or split the area to get everything.

Portal-suggested related searches for this area.

string

Echo of the requested market.

string

Portal domain the data came from, e.g. www.immobiliare.it.

Example

const res = await fetch(
  "https://scrapebadger.com/v1/immobiliare/search?" +
    new URLSearchParams({
      location: "Milano",
      contract: "sale",
      category: "residential",
      price_max: "300000",
      rooms_min: "3",
      sort: "newest",
    }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();

import requests

res = requests.get(
    "https://scrapebadger.com/v1/immobiliare/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "location": "Milano",
        "contract": "sale",
        "category": "residential",
        "price_max": 300000,
        "rooms_min": 3,
        "sort": "newest",
    },
)
data = res.json()

curl "https://scrapebadger.com/v1/immobiliare/search?location=Milano&contract=sale&category=residential&price_max=300000&rooms_min=3&sort=newest" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "listings": [
    {
      "id": 121584766,
      "uuid": "c1f8a3f2-9a41-4a6e-bb3e-1e2f9d3a7c55",
      "url": "https://www.immobiliare.it/annunci/121584766/",
      "title": "Trilocale via Padova 120, Cimiano, Milano",
      "contract": "sale",
      "is_new": false,
      "luxury": false,
      "is_project": false,
      "is_mosaic": false,
      "visibility": "premium",
      "typology": "Apartment",
      "category": "residential",
      "price": {
        "value": 285000,
        "formatted": "€ 285.000",
        "min_value": null,
        "max_value": null,
        "currency": "EUR",
        "visible": true,
        "price_per_sqm": "3.353 €/m²",
        "loan_from": "€ 741/month"
      },
      "location": {
        "address": "via Padova, 120",
        "latitude": 45.4972,
        "longitude": 9.2296,
        "region": "Lombardia",
        "province": "Milano",
        "city": "Milano",
        "macrozone": "Cimiano, Crescenzago, Adriano",
        "microzone": "Padova",
        "zipcode": "20127",
        "nation_code": "IT",
        "nation_name": "Italia"
      },
      "surface": "85 m²",
      "rooms": "3",
      "bathrooms": "2",
      "floor": "3",
      "energy_class": "E",
      "description": "Luminoso trilocale al terzo piano con ascensore, doppia esposizione, balcone e cantina...",
      "photo_count": 24,
      "has_virtual_tour": true,
      "photos": [
        {
          "id": 987654321,
          "caption": "soggiorno",
          "small": "https://pic.im-cdn.it/image/987654321/xsmall.jpg",
          "medium": "https://pic.im-cdn.it/image/987654321/medium.jpg",
          "large": "https://pic.im-cdn.it/image/987654321/large.jpg"
        }
      ],
      "agency": {
        "id": 41235,
        "type": "agency",
        "display_name": "Tecnocasa Milano Crescenzago",
        "label": "Tecnocasa",
        "url": "https://www.immobiliare.it/agenzie-immobiliari/41235/tecnocasa-milano/",
        "is_paid": true,
        "guaranteed": true,
        "show_logo": true,
        "image_small": "https://pic.im-cdn.it/agency/41235/small.png",
        "image_large": "https://pic.im-cdn.it/agency/41235/large.png",
        "phones": ["+39 02 2846120"]
      },
      "agent": {
        "type": "agent",
        "display_name": "Marco Rossi",
        "label": "Agente",
        "image_gender": "male",
        "image_url": "https://pic.im-cdn.it/agent/998877/photo.jpg",
        "phones": ["+39 340 5512347"]
      },
      "properties_count": 1,
      "properties": [
        {
          "is_main": true,
          "surface": "85 m²",
          "surface_value": 85,
          "rooms": "3",
          "bathrooms": "2",
          "bedrooms": "2",
          "floor": "3° floor, with lift",
          "elevator": true,
          "garage": null,
          "heating": "Centralized, radiators, gas powered",
          "energy_class": "E",
          "condominium_fees": "€ 120/month",
          "typology": "Apartment",
          "category": "Residential",
          "caption": "Main unit",
          "description": "Luminoso trilocale al terzo piano con ascensore...",
          "price": "€ 285.000",
          "features": [
            { "type": "balcony", "label": "Balcony", "compact_label": "Balcony" },
            { "type": "cellar", "label": "Cellar", "compact_label": "Cellar" }
          ],
          "ga4_features": ["balcony", "cellar", "external_exposure"],
          "views": [],
          "photos": []
        }
      ],
      "creation_date": "2026-05-18",
      "last_modified_utc": "2026-07-02T09:14:05Z",
      "last_modified_at": "2026-07-02 11:14",
      "features_full": ["balcony", "cellar", "fitted wardrobes", "concierge"]
    }
  ],
  "count": 25,
  "total_ads": 3417,
  "current_page": 1,
  "max_pages": 137,
  "is_results_limit_reached": false,
  "related_searches": [
    { "label": "Case in vendita Sesto San Giovanni", "url": "/vendita-case/sesto-san-giovanni/" }
  ],
  "market": "it",
  "source": "www.immobiliare.it"
}

Each search request costs 5 credits. Failed requests are not charged.

Overview

Search

Listings

Agencies

Insights

Reference

Query Parameters

Response

Example

​Query Parameters

​Response

​Example

Query Parameters

Response

Example