Skip to main content
Fetch a single listing’s complete detail by its numeric id (from /search or a portal URL such as immobiliare.it/annunci/121584766/). The response is the full Listing object — everything the search card has, plus the full description, all photos and the complete per-unit properties[] breakdown.

Path Parameters

id
integer
required
Immobiliare listing id, e.g. 121584766.

Query Parameters

market
string
default:"it"
Market the listing belongs to. One of it, es, gr, lu.

Response

The full Listing:
id
integer
Immobiliare listing id.
uuid
string
Stable listing UUID.
url
string
Canonical listing URL on the market’s portal.
title
string
contract
string
sale or rent.
is_new
boolean
New construction.
luxury
boolean
Luxury (LuxuryEstate) listing.
is_project
boolean
Off-plan / development project.
is_mosaic
boolean
Multi-unit “mosaic” listing grouping several units.
visibility
string
Paid visibility tier, e.g. premium, top, star.
typology
string
Property typology, e.g. Apartment, Villa.
category
string
e.g. residential.
price
object
location
object
surface
string
e.g. 85 m².
rooms
string
bathrooms
string
floor
string
energy_class
string
description
string
Full listing description.
photo_count
integer
has_virtual_tour
boolean
photos
Photo[]
All listing photos.
agency
object
agent
object
properties_count
integer
Number of units in this listing.
properties
PropertyUnit[]
Per-unit breakdown (a plain listing has one main unit; projects/mosaics have several).
creation_date
string
When the listing was published.
last_modified_utc
string
Last modification (UTC, ISO 8601).
last_modified_at
string
Last modification (portal-local formatting).
features_full
string[]
All feature labels, flattened.

Example

const res = await fetch(
  "https://api.scrapebadger.com/v1/immobiliare/listings/121584766?market=it",
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const listing = await res.json();
Response
{
  "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 est/ovest, composto da soggiorno con balcone, cucina abitabile, due camere, doppi servizi e cantina. Riscaldamento centralizzato con contabilizzatori, portineria mezza giornata.",
  "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"
    },
    {
      "id": 987654322,
      "caption": "cucina",
      "small": "https://pic.im-cdn.it/image/987654322/xsmall.jpg",
      "medium": "https://pic.im-cdn.it/image/987654322/medium.jpg",
      "large": "https://pic.im-cdn.it/image/987654322/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": "1 in garage/box",
      "heating": "Centralized, radiators, gas powered",
      "energy_class": "E",
      "condominium_fees": "€ 120/month",
      "typology": "Apartment",
      "category": "Residential",
      "caption": "Main unit",
      "description": "Trilocale ristrutturato nel 2021...",
      "price": "€ 285.000",
      "features": [
        { "type": "balcony", "label": "Balcony", "compact_label": "Balcony" },
        { "type": "cellar", "label": "Cellar", "compact_label": "Cellar" },
        { "type": "fitted_wardrobes", "label": "Fitted wardrobes", "compact_label": "Wardrobes" }
      ],
      "ga4_features": ["balcony", "cellar", "fitted_wardrobes", "external_exposure"],
      "views": [],
      "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"
        }
      ]
    }
  ],
  "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"]
}
Each listing-detail request costs 10 credits. Failed requests are not charged.