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

[APIs](https://perceptlayer.com/apis) / [pisos.com](https://perceptlayer.com/apis/pisos-com) / Search

# pisos.com: Search

Search from pisos.com as JSON. 1 credit per successful call.

GET `/v1/pisos-com/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `operation` | string | Optional | sale, rent |
| `location` | string | Required | Any |
| `property_type` | string | Optional | pisos, casas, aticos, duplex, estudios, locales, garajes, terrenos, habitaciones |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `bedrooms` | integer | Optional | Any |
| `bathrooms` | integer | Optional | Any |
| `min_size` | integer | Optional | Any |
| `features[]` | list of string | Optional | terrace, elevator, garden, pool, parking, heating, air\_conditioning |
| `has_photo` | string | Optional | true, false, 1, 0 |
| `reduced_price` | string | Optional | true, false, 1, 0 |
| `sort` | string | Optional | relevance, newest, price\_asc, price\_desc, bedrooms\_asc, bedrooms\_desc, size\_asc, size\_desc |
| `page` | integer | Optional | Any |

## Example request

pisos.com

GET /v1/pisos-com/search?operation=sale&location=madrid&property\_type=pisos&max\_price=400000&bedrooms=3&sort=price\_asc 

```
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "62507207196",
        "listing_id": "62507207196.109800",
        "url": "https://www.pisos.com/comprar/casa_adosada-aoslos-62507207196_109800/",
        "path": "/comprar/casa_adosada-aoslos-62507207196_109800/",
        "title": "Casa adosada en calle de Castillejos, 11",
        "location": "Aoslos (Horcajo de la Sierra-Aoslos)",
        "operation": "sale",
        "price": 30000,
        "currency": "EUR",
        "bedrooms": 4,
        "bathrooms": 3,
        "area_m2": 130,
        "description": "Casa vieja, dos alturas más bajo cubierta. Luces delanteras y traseras. 69 m² por planta. Casco urbano, acometidas en la puerta",
        "photo_count": 7,
        "image": "https://fotos.imghs.net/mm-wp/1098/5596479/1098_1_foto_20260321095955294_62507207196.jpeg",
        "latitude": 41.067238,
        "longitude": -3.5843678,
        "locality": "Horcajo de la Sierra Aoslos",
        "region": "Madrid",
        "is_new_development": false,
        "is_promoted": false
      },
      {
        "id": "68382772500",
        "listing_id": "68382772500.534524",
        "url": "https://www.pisos.com/comprar/piso-san_martin_de_valdeiglesias_centro_urbano-68382772500_534524/",
        "path": "/comprar/piso-san_martin_de_valdeiglesias_centro_urbano-68382772500_534524/",
        "title": "Piso en calle del Doctor Romero, 8",
        "location": "San Martín de Valdeiglesias",
        "operation": "sale",
        "property_type": "piso",
        "price": 40000,
        "currency": "EUR",
        "bedrooms": 3,
        "bathrooms": 1,
        "area_m2": 139,
        "floor": "3ª planta",
        "description": "Venta de credito pendiente de que nos den la cesion de remate. La vivienda esta ocupada y no se puede visitar. Este piso en venta,...",
        "photo_count": 4,
        "image": "https://fotos.imghs.net/mm-wp/534524/68382772500.534524/534524_68382772500_8478cdbf-b78c-4f62-834e-5a5cbcf4648f.jpg",
        "latitude": 40.36227,
        "longitude": -4.398933,
        "locality": "San Martín de Valdeiglesias",
        "region": "Madrid",
        "agency": {
          "id": "534524",
          "slug": "gamisa_real_estate",
          "url": "https://www.pisos.com/inmobiliaria-gamisa_real_estate/"
        },
        "is_new_development": false,
        "is_promoted": false
      },
      {
        "id": "68349369538",
        "listing_id": "68349369538.109200",
        "url": "https://www.pisos.com/comprar/piso-estacion_de_santa_maria_de_la_alameda-68349369538_109200/",
        "path": "/comprar/piso-estacion_de_santa_maria_de_la_alameda-68349369538_109200/",
        "title": "Piso en Avenida del Doctor Fleming, 36",
        "location": "Estación de Santa María de la Alameda (Santa María de la Alameda)",
        "operation": "sale",
        "property_type": "piso",
        "price": 42280,
        "currency": "EUR",
        "bedrooms": 3,
        "bathrooms": 1,
        "area_m2": 71,
        "description": "Propiedad en proceso de subasta *accede a la web de grupinval para más información. Tendrás todas las características de la subas...",
        "photo_count": 6,
        "image": "https://fotos.imghs.net/mm-wp/1092/3230323631303331/0a4b4e09-d051-42cf-9c8c-f432abb298aa.jpg",
        "latitude": 40.5668,
        "longitude": -4.28688,
        "locality": "Santa María de la Alameda",
        "region": "Madrid",
        "agency": {
          "id": "109200",
          "slug": "grupinval",
          "url": "https://www.pisos.com/inmobiliaria-grupinval/"
        },
        "is_new_development": false,
        "is_promoted": false
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 30,
      "total": 4587,
      "total_pages": 153,
      "has_next_page": true
    },
    "items_dropped": 0,
    "total_includes_dropped": false,
    "applied_filters": {
      "operation": "sale",
      "location": "madrid",
      "property_type": "pisos",
      "max_price": "400000",
      "bedrooms": "3",
      "sort": "price_asc"
    }
  },
  "meta": {
    "endpoint_family": "search",
    "attempts": 1,
    "items_dropped": 0,
    "request_id": "req_b8893931002a4e068c1415513e53130c",
    "credits_charged": 1,
    "credits_remaining": 1830
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

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