Listing object returned by
/search.
Path Parameters
integer
required
Immobiliare agency id, e.g.
41235.Query Parameters
string
default:"it"
Market the agency belongs to. One of
it, es, gr, lu.string
default:"sale"
Contract type to list. One of
sale, rent.integer
default:"1"
Result page.
Response
integer
Echo of the requested agency id.
Listing[]
The agency’s listings for this page.
Show Listing
Show Listing
integer
Immobiliare listing id — feed to
/listings/{id}.string
Stable listing UUID.
string
Canonical listing URL on the market’s portal.
string
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
value, formatted, min_value, max_value, currency, visible,
price_per_sqm, loan_from.object
address, latitude, longitude, region, province, city,
macrozone, microzone, zipcode, nation_code, nation_name.string
e.g.
85 m².string
string
string
string
string
integer
boolean
Photo[]
id, caption, small, medium, large.object
id, type, display_name, label, url, is_paid, guaranteed,
show_logo, image_small, image_large, phones[].object
type, display_name, label, image_gender, image_url, phones[].integer
Number of units in this listing.
PropertyUnit[]
Per-unit breakdown:
is_main, surface, surface_value, rooms,
bathrooms, bedrooms, floor, elevator, garage, heating,
energy_class, condominium_fees, typology, category, caption,
description, price, features[{type,label,compact_label}],
ga4_features[], views[], 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
Echo of the requested page.
string
Echo of the requested market.
The full
Listing field reference — including the nested price,
location, photos[], agency, agent and properties[] shapes — is
documented on /search.Example
const res = await fetch(
"https://scrapebadger.com/v1/immobiliare/agencies/41235/listings?" +
new URLSearchParams({ market: "it", page: "1" }),
{ headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
import requests
res = requests.get(
"https://scrapebadger.com/v1/immobiliare/agencies/41235/listings",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"market": "it", "page": 1},
)
data = res.json()
curl "https://scrapebadger.com/v1/immobiliare/agencies/41235/listings?market=it&page=1" \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"agency_id": 41235,
"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...",
"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" }
],
"ga4_features": ["balcony", "cellar"],
"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,
"page": 1,
"market": "it"
}
Each agency-listings request costs 5 credits. Failed requests are not charged.