---
title: "Tecnocasa API: Search | Perceptlayer"
description: "Search from Tecnocasa as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/tecnocasa/search
---

[APIs](https://perceptlayer.com/apis) / [Tecnocasa](https://perceptlayer.com/apis/tecnocasa) / Search

# Tecnocasa: Search

Search from Tecnocasa as JSON. 1 credit per successful call.

GET `/v1/tecnocasa/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `country` | string | Optional | it, es |
| `listing_type` | string | Optional | sale, rent |
| `city_id` | integer | Required | Any |
| `province` | string | Required | Up to 3 characters |
| `region` | string | Optional | Up to 4 characters |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_surface` | integer | Optional | Any |
| `max_surface` | integer | Optional | Any |
| `min_rooms` | integer | Optional | Any |
| `max_rooms` | integer | Optional | Any |
| `bathrooms` | integer | Optional | Any |
| `property_type` | string | Optional | app, vil, cas, box, ter |
| `district_ids[]` | list of integer | Optional | Any |
| `agency_id` | string | Optional | Any |
| `sort` | string | Optional | price\_asc, price\_desc, area\_asc, area\_desc, rooms\_asc, rooms\_desc |
| `page` | integer | Optional | Any |
| `limit` | integer | Optional | Any |

## Example request

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.

[Run this endpoint in the playground](https://perceptlayer.com/apis/tecnocasa?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.