# Casa.it Listing Search Search Casa.it residential listings for sale (vendita) or rent (affitto) in an Italian town, province or region. Each listing has its id, url, title, description (Markdown and plain text), transaction, property type, price as an integer in euros, surface in square meters, rooms, bathrooms, floor, energy class, location with coordinates, publisher, images and flags for video and floor plan. Casa.it returns 20 listings per page and serves at most 80 pages per search, so narrow large cities with price_min, price_max and rooms. Get the location slug from the locations endpoint. A valid search without matches is a successful empty list. Unknown locations answer 404 and are not billed. - **Documentation:** [https://scrappa.co/docs/casa-it-api/casa_it_search](https://scrappa.co/docs/casa-it-api/casa_it_search) - **API group:** Casa.it API - **Endpoint:** `GET https://scrappa.co/api/casa_it/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `transaction` | string | Yes | vendita (sale) or affitto (rent). The English words sale and rent also work. Example: vendita. | | `location` | string | Yes | Casa.it slug of a town, province or region from the locations endpoint, e.g. roma, milano or lazio. | | `page` | integer | No | Page number, 1 to 80, 20 listings per page. Default: 1 | | `price_min` | integer | No | Minimum price in euros (monthly rent for affitto). | | `price_max` | integer | No | Maximum price in euros (monthly rent for affitto). Must not be below price_min. | | `rooms` | integer | No | Exact number of rooms, 1 to 4. | ## Example request ```bash #!/bin/bash curl -X GET \ -H "x-api-key: YOUR_API_KEY_HERE" \ "https://scrappa.co/api/casa_it/search?transaction=vendita&location=roma" ``` ## Example response ```json { "success": true, "data": { "total": 20448, "pagination": { "page": 1, "per_page": 20, "total_pages": 80, "total": 20448 }, "listings": [ { "id": 54994089, "url": "https://www.casa.it/immobili/54994089/", "title": "Bilocale in Via di Monte del Gallo", "description": "SAN PIETRO - GREGORIO VII RISTRUTTURATO San Pietro adiacenze e precisamente in Via Monte Del Gallo in signorile palazzina d'epoca di soli 3 piani proponiamo in vendita un appartamento posto al primo piano con affacci...", "description_text": "SAN PIETRO - GREGORIO VII RISTRUTTURATO San Pietro adiacenze e precisamente in Via Monte Del Gallo in signorile palazzina d'epoca di soli 3 piani proponiamo in vendita un appartamento posto al primo piano con affaccio...", "transaction": "vendita", "property_group": "case", "property_type": "appartamento", "price": 285000, "currency": "EUR", "surface_sqm": 35, "rooms": 2, "bathrooms": 1, "floor": "1\u00b0 piano", "location": { "street": "Via di Monte del Gallo", "district": "Gregorio VII, Baldo degli Ubaldi", "neighborhood": "Gregorio VII", "city": "Roma", "province": "RM", "province_name": "Roma", "region": "Lazio", "latitude": 41.896132, "longitude": 12.452044 }, "publisher": { "id": 59770, "type": "agency", "name": "CASAINCONTRO SRL", "address": "Roma, Via Orti della Farnesina 146", "phone": "0685871328", "website": "http://www.casaincontro.com", "url": "https://www.casa.it/agenzie/casaincontro-srl-59770/" }, "images": [ "https://images-1.casa.it/800x600/listing/0/1e/20/b3/848233198.jpg", "https://images-1.casa.it/800x600/listing/0/2b/26/54/848233199.jpg", "https://images-1.casa.it/800x600/listing/0/72/d0/ec/848233200.jpg" ], "has_video": false, "has_floorplan": true }, { "id": 54737192, "url": "https://www.casa.it/immobili/54737192/", "title": "Trilocale in Via di Monte del Gallo", "description": "GREGORIO VII AD. SAN PIETRO in contesto tranquillo e silenzioso, proponiamo in vendita una porzione di villino d\u2019epoca degli anni \u201920, situata in posizione riservata e non fronte strada con affaccio su gradevoli giard...", "description_text": "GREGORIO VII AD. SAN PIETRO in contesto tranquillo e silenzioso, proponiamo in vendita una porzione di villino d\u2019epoca degli anni \u201920, situata in posizione riservata e non fronte strada con affaccio su gradevoli giard...", "transaction": "vendita", "property_group": "case", "property_type": "appartamento", "price": 399000, "currency": "EUR", "surface_sqm": 80, "rooms": 3, "bathrooms": 1, "floor": "1\u00b0 piano", "location": { "street": "Via di Monte del Gallo", "district": "Gregorio VII, Baldo degli Ubaldi", "neighborhood": "Gregorio VII", "city": "Roma", "province": "RM", "province_name": "Roma", "region": "Lazio", "latitude": 41.896132, "longitude": 12.452044 }, "publisher": { "id": 59770, "type": "agency", "name": "CASAINCONTRO SRL", "address": "Roma, Via Orti della Farnesina 146", "phone": "0685871328", "website": "http://www.casaincontro.com", "url": "https://www.casa.it/agenzie/casaincontro-srl-59770/" }, "images": [ "https://images-1.casa.it/800x600/listing/0/3c/2f/b7/840002274.jpg", "https://images-1.casa.it/800x600/listing/0/19/c8/8f/840002079.jpg", "https://images-1.casa.it/800x600/listing/0/31/46/7e/837677891.jpg" ], "has_video": false, "has_floorplan": true } ] }, "meta": { "endpoint_family": "search", "billable": true } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. | | 404 | Resource Not Found | The Casa.it location does not exist. This response is not billable. | | 503 | Source Temporarily Blocked | The upstream service is temporarily unavailable. Please retry shortly. | | 503 | Service Unavailable | Casa.it could not be reached or answered with a page that no longer matches the documented contract. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)