Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Tecnocasa

1 credit per call7 endpoints14 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 keyRun 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 OKJSONX-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.

#idintegertitlestringsubtitlestringpriceobjectsurfaceobjectroomsintegerrooms_labelstringbathroomsintegerbathrooms_labelstringagency_idstringdetail_urlurlimagesobject[]exclusivebooleantopboolean
161299336Monolocale in venditaMilano, Via Soperga - Loreto{3 fields}{2 fields}11 locale11 bagnomicj5https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61299336.html[1 item]falsetrue
261283681Mansarda in venditaMilano, Via della chiesa rossa - Gratosoglio{3 fields}{2 fields}22 locali11 bagnomice9https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61283681.html[1 item]falsetrue
361294600Loft in venditaMilano, Via Merula - Ronchetto Sul Naviglio{3 fields}{2 fields}22 locali11 bagnomicp5https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61294600.html[1 item]falsetrue

Recorded from our API · 3 items shown · 14 datapoints per itemGET /v1/tecnocasa/search?listing_type=sale&city_id=13800324507779&province=MI&min_price=200000&max_price=300000

14 datapoints

Identity

  • idinteger
  • titlestring
  • subtitlestring
  • agency_idstring

Contact

  • detail_urlurl

Reputation

  • imagesobject[]

Price

  • priceobject

Other

  • surfaceobject
  • roomsinteger
  • rooms_labelstring
  • bathroomsinteger
  • bathrooms_labelstring
  • exclusiveboolean
  • topboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/tecnocasa/agency
none+3 optional
1 credit
GET/v1/tecnocasa/agency-listings
agency_idcity_idprovince+15 optional
1 credit
GET/v1/tecnocasa/geo
type+2 optional
1 credit
GET/v1/tecnocasa/listing
none+3 optional
1 credit
GET/v1/tecnocasa/locations
q+1 optional
1 credit
GET/v1/tecnocasa/search
city_idprovince+16 optional
1 credit
GET/v1/tecnocasa/search-map
city_idprovince+13 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs