--- title: "Tecnocasa API: JSON data, 7 endpoints, 1 credit per call" description: "Tecnocasa API for homes for sale or rent in Italy and Spain, map results, listings, agencies and their stock, and places as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/tecnocasa --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Tecnocasa 1 credit per call 7 endpoints 14 datapoints # Tecnocasa API Tecnocasa API for homes for sale or rent in Italy and Spain, map results, listings, agencies and their stock, and places as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Tecnocasa GET /v1/tecnocasa/search?listing\_type=sale&city\_id=13800324507779&province=MI&min\_price=200000&max\_price=300000 ``` { "success": true, "data": { "search_parameters": { "country": "it", "listing_type": "sale", "city_id": "13800324507779", "province": "MI", "region": "lom", "min_price": "200000", "max_price": "300000", "page": 1, "limit": 15 }, "search_metadata": { "total_results": 334, "total_pages": 23, "page": 1, "limit": 15, "has_next_page": true, "page_out_of_range": false, "filtered_out": 0, "country": "it", "listing_type": "sale" }, "listings": [ { "id": 61299336, "title": "Monolocale in vendita", "subtitle": "Milano, Via Soperga - Loreto", "price": { "raw": "€ 225.000", "amount": 225000, "currency": "EUR" }, "surface": { "raw": "30 Mq", "m2": 30 }, "rooms": 1, "rooms_label": "1 locale", "bathrooms": 1, "bathrooms_label": "1 bagno", "agency_id": "micj5", "detail_url": "https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61299336.html", "images": [ { "id": 67185555, "order": 1, "thumbnail": "https://cdn-media.medialabtc.it/it/agencies/micj5/estates/61299336/images/67185555/card.jpeg", "medium": "https://cdn-media.medialabtc.it/it/agencies/micj5/estates/61299336/images/67185555/detail.jpeg", "large": "https://cdn-media.medialabtc.it/it/agencies/micj5/estates/61299336/images/67185555/gallery.jpeg" } ], "exclusive": false, "top": true }, { "id": 61283681, "title": "Mansarda in vendita", "subtitle": "Milano, Via della chiesa rossa - Gratosoglio", "price": { "raw": "€ 250.000", "amount": 250000, "currency": "EUR" }, "surface": { "raw": "64 Mq", "m2": 64 }, "rooms": 2, "rooms_label": "2 locali", "bathrooms": 1, "bathrooms_label": "1 bagno", "agency_id": "mice9", "detail_url": "https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61283681.html", "images": [ { "id": 66713491, "order": 1, "thumbnail": "https://cdn-media.medialabtc.it/it/agencies/mice9/estates/61283681/images/66713491/card.jpeg", "medium": "https://cdn-media.medialabtc.it/it/agencies/mice9/estates/61283681/images/66713491/detail.jpeg", "large": "https://cdn-media.medialabtc.it/it/agencies/mice9/estates/61283681/images/66713491/gallery.jpeg" } ], "virtual_tour": "https://www.smartvt360.it/pss/25fab3fd-5afe-43f8-9cb3-96fdbd08a6b0", "exclusive": false, "top": true }, { "id": 61294600, "title": "Loft in vendita", "subtitle": "Milano, Via Merula - Ronchetto Sul Naviglio", "price": { "raw": "€ 260.000", "amount": 260000, "currency": "EUR" }, "surface": { "raw": "92 Mq", "m2": 92 }, "rooms": 2, "rooms_label": "2 locali", "bathrooms": 1, "bathrooms_label": "1 bagno", "agency_id": "micp5", "detail_url": "https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61294600.html", "images": [ { "id": 67039759, "order": 1, "thumbnail": "https://cdn-media.medialabtc.it/it/agencies/micp5/estates/61294600/images/67039759/card.jpeg", "medium": "https://cdn-media.medialabtc.it/it/agencies/micp5/estates/61294600/images/67039759/detail.jpeg", "large": "https://cdn-media.medialabtc.it/it/agencies/micp5/estates/61294600/images/67039759/gallery.jpeg" } ], "virtual_tour": "https://www.smartvt360.it/pss/901ad48c-ea48-4378-a320-79f7de63d05b", "exclusive": false, "top": true } ] }, "meta": { "endpoint_family": "search", "request_id": "req_bd0cb4fa722f4c33a60f728cb9c7a395", "credits_charged": 1, "credits_remaining": 1807 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | title string | subtitle string | price object | surface object | rooms integer | rooms\_label string | bathrooms integer | bathrooms\_label string | agency\_id string | detail\_url url | images object\[\] | exclusive boolean | top boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 61299336 | Monolocale in vendita | Milano, Via Soperga - Loreto | {3 fields} | {2 fields} | 1 | 1 locale | 1 | 1 bagno | micj5 | https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61299336.html | \[1 item\] | false | true | | 2 | 61283681 | Mansarda in vendita | Milano, Via della chiesa rossa - Gratosoglio | {3 fields} | {2 fields} | 2 | 2 locali | 1 | 1 bagno | mice9 | https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61283681.html | \[1 item\] | false | true | | 3 | 61294600 | Loft in vendita | Milano, Via Merula - Ronchetto Sul Naviglio | {3 fields} | {2 fields} | 2 | 2 locali | 1 | 1 bagno | micp5 | https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61294600.html | \[1 item\] | false | true | Recorded from our API · 3 items shown · 14 datapoints per item GET /v1/tecnocasa/search?listing\_type=sale&city\_id=13800324507779&province=MI&min\_price=200000&max\_price=300000 14 datapoints ### Identity - id integer - title string - subtitle string - agency\_id string ### Contact - detail\_url url ### Reputation - images object\[\] ### Price - price object ### Other - surface object - rooms integer - rooms\_label string - bathrooms integer - bathrooms\_label string - exclusive boolean - top boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/tecnocasa/search?listing_type=sale&city_id=13800324507779&province=MI&min_price=200000&max_price=300000" \ -H "X-API-Key: $API_KEY" ``` Tecnocasa · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/tecnocasa/agency`](https://perceptlayer.com/apis/tecnocasa/agency) | none +3 optional | 1 credit | | [GET `/v1/tecnocasa/agency-listings`](https://perceptlayer.com/apis/tecnocasa/agency-listings) | `agency_id` `city_id` `province` +15 optional | 1 credit | | [GET `/v1/tecnocasa/geo`](https://perceptlayer.com/apis/tecnocasa/geo) | `type` +2 optional | 1 credit | | [GET `/v1/tecnocasa/listing`](https://perceptlayer.com/apis/tecnocasa/listing) | none +3 optional | 1 credit | | [GET `/v1/tecnocasa/locations`](https://perceptlayer.com/apis/tecnocasa/locations) | `q` +1 optional | 1 credit | | [GET `/v1/tecnocasa/search`](https://perceptlayer.com/apis/tecnocasa/search) | `city_id` `province` +16 optional | 1 credit | | [GET `/v1/tecnocasa/search-map`](https://perceptlayer.com/apis/tecnocasa/search-map) | `city_id` `province` +13 optional | 1 credit | Overview ## About the Tecnocasa API ## What you can get The Tecnocasa API returns Tecnocasa property data as JSON through 7 endpoints. Every endpoint takes an optional `country`: it or es. - **Search:** `search` and `search-map` take a `city_id` and a `province`, with `listing_type` (sale or rent), `region`, `min_price`, `max_price`, `min_surface`, `max_surface`, `min_rooms`, `max_rooms`, `bathrooms`, `property_type` (app, vil, cas, box or ter), `district_ids[]` (repeatable) and `agency_id`. `search` also takes `sort` (price\_asc, price\_desc, area\_asc, area\_desc, rooms\_asc or rooms\_desc), `page` and `limit`. - **Listings:** `listing` takes a `url` or `path`. - **Agencies:** `agency` takes a `url` or `path`; `agency-listings` takes an `agency_id`, `city_id` and `province`, with the same filters as `search`. - **Places:** `locations` takes a `q`; `geo` takes a `type` (regions, provinces or districts), with `city_id`. The recorded `search` for homes for sale in Milan ( `city_id=13800324507779`, `province=MI`) between €200,000 and €300,000 returns `search_metadata` with `total_results` (334), `total_pages`, `limit` (15) and `has_next_page`, and `listings`, each with `id`, `title`, `subtitle`, `price` ( `amount`, `currency`), `surface` ( `m2`), `rooms`, `bathrooms`, `agency_id`, `detail_url`, `images`, `exclusive` and `top`. ## How a call works Search a city: `GET /v1/tecnocasa/search?listing_type=sale&city_id=13800324507779&province=MI&min_price=200000&max_price=300000` with your key in the `X-API-Key` header. Each listing's `detail_url` is what `listing` takes as `url`, and its `agency_id` is what `agency-listings` takes. Check `has_next_page` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices by size and rooms in Italian and Spanish cities `Use the Tecnocasa API to track asking prices by size and rooms in Italian and Spanish cities` ### Narrow a city to districts with \`geo\` and \`district\_ids\[\]\` `` Use the Tecnocasa API to narrow a city to districts with `geo` and `district_ids[]` `` ### List one agency's stock with \`agency-listings\` `` Use the Tecnocasa API to list one agency's stock with `agency-listings` `` ### Plot listings on a map with \`search-map\` `` Use the Tecnocasa API to plot listings on a map with `search-map` `` FAQ ## Questions **Do I need a Tecnocasa account?** No. You call this Tecnocasa API with your Perceptlayer key in the \`X-API-Key\` header, with no Tecnocasa login. **How much does the Tecnocasa API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Which countries does it cover?** Set \`country\` to it for Italy or es for Spain. **Should I build a Tecnocasa scraper instead?** You can, but a Tecnocasa scraper is code you maintain: page changes break it, requests get blocked, and Tecnocasa's terms govern how you collect data. The Tecnocasa API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Tecnocasa API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)