> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Listings > Search Immobiliare Group listings — sale / rent, all categories, with price, surface, rooms and bathrooms filters. 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`](/api-reference/endpoint/immobiliare/autocomplete)). ## Query Parameters Market to search. One of `it`, `es`, `gr`, `lu`. Free-text place, auto-resolved to a geography — e.g. `Milano`, `Roma Trastevere`. Provide either `location` **or** the id parameters below. Region id (from `/autocomplete`). Alternative to `location`. Province id (from `/autocomplete`). City (comune) id (from `/autocomplete`). Contract type. One of `sale`, `rent`. Listing category. One of `residential`, `commercial`, `garages`, `offices`, `land`, `buildings`, `warehouses`. Minimum price (EUR). Maximum price (EUR). Minimum surface (m²). Maximum surface (m²). Minimum number of rooms. Maximum number of rooms. Minimum number of bathrooms. Sort order. One of `relevance`, `price_asc`, `price_desc`, `newest`, `oldest`, `surface_desc`, `surface_asc`. Result page. ## Response Listing cards for this page. Immobiliare listing id — feed to [`/listings/{id}`](/api-reference/endpoint/immobiliare/get-listing). Stable listing UUID. Canonical listing URL on the market's portal. `sale` or `rent`. New construction. Luxury (LuxuryEstate) listing. Off-plan / development project. Multi-unit "mosaic" listing grouping several units. Paid visibility tier, e.g. `premium`, `top`, `star`. Property typology, e.g. `Apartment`, `Villa`. e.g. `residential`. Price in EUR (null when hidden). e.g. `€ 285.000`. Range lower bound (project/mosaic listings). Range upper bound. Always `EUR`. `false` = price on request. e.g. `3.353 €/m²`. Estimated loan installment, e.g. `€ 741/month`. e.g. `IT`. e.g. `85 m²`. Small image URL. Medium image URL. Large image URL. Agency id — feed to [`/agencies/{id}`](/api-reference/endpoint/immobiliare/get-agency). e.g. `agency`, `builder`. Agency profile URL on the portal. Number of units in this listing. Per-unit breakdown (a plain listing has one main unit; projects/mosaics have several). e.g. `85 m²`. Numeric surface (m²). e.g. `3° floor, with lift`. e.g. `1 in garage/box`. e.g. `Centralized, radiators, gas powered`. e.g. `€ 120/month`. e.g. `balcony`. Machine-readable feature slugs. Views, e.g. `sea view`. Same shape as the listing-level `photos[]`. When the listing was published. Last modification (UTC, ISO 8601). Last modification (portal-local formatting). All feature labels, flattened. Listings returned on this page. Total matching listings. Last available page. `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. Echo of the requested market. Portal domain the data came from, e.g. `www.immobiliare.it`. ## Example ```javascript Node.js theme={null} const res = await fetch( "https://api.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(); ``` ```python Python theme={null} import requests res = requests.get( "https://api.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() ``` ```bash cURL theme={null} curl "https://api.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" ``` ```json Response theme={null} { "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.