Sign inGet a free API keyDashboard
Menu

APIs / Real estate / pisos.com

1 credit per call5 endpoints21 datapoints

pisos.com API

pisos.com API for Spanish flats, houses, garages and land for sale or rent, listings and agency listings as JSON. Five endpoints, 1 credit per successful call.

Get a free API keyRun it below
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 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.

#idstringlisting_idstringurlurlpathstringtitlestringlocationstringoperationstringpriceintegercurrencystringbedroomsintegerbathroomsintegerarea_m2integerdescriptionstringphoto_countintegerimageurllatitudenumberlongitudenumberlocalitystringregionstringis_new_developmentbooleanis_promotedboolean
16250720719662507207196.109800https://www.pisos.com/comprar/casa_adosada-aoslos-62507207196_109800//comprar/casa_adosada-aoslos-62507207196_109800/Casa adosada en calle de Castillejos, 11Aoslos (Horcajo de la Sierra-Aoslos)sale30000EUR43130Casa vieja, dos alturas más bajo cubierta. Luces delanteras y traseras. 69 m² por planta. Casco urbano, acometidas en la puerta7https://fotos.imghs.net/mm-wp/1098/5596479/1098_1_foto_20260321095955294_62507207196.jpeg41.067238-3.5843678Horcajo de la Sierra AoslosMadridfalsefalse
26838277250068382772500.534524https://www.pisos.com/comprar/piso-san_martin_de_valdeiglesias_centro_urbano-68382772500_534524//comprar/piso-san_martin_de_valdeiglesias_centro_urbano-68382772500_534524/Piso en calle del Doctor Romero, 8San Martín de Valdeiglesiassale40000EUR31139Venta de credito pendiente de que nos den la cesion de remate. La vivienda esta ocupada y no se puede visitar. Este piso en venta,...4https://fotos.imghs.net/mm-wp/534524/68382772500.534524/534524_68382772500_8478cdbf-b78c-4f62-834e-5a5cbcf4648f.jpg40.36227-4.398933San Martín de ValdeiglesiasMadridfalsefalse
36834936953868349369538.109200https://www.pisos.com/comprar/piso-estacion_de_santa_maria_de_la_alameda-68349369538_109200//comprar/piso-estacion_de_santa_maria_de_la_alameda-68349369538_109200/Piso en Avenida del Doctor Fleming, 36Estación de Santa María de la Alameda (Santa María de la Alameda)sale42280EUR3171Propiedad en proceso de subasta *accede a la web de grupinval para más información. Tendrás todas las características de la subas...6https://fotos.imghs.net/mm-wp/1092/3230323631303331/0a4b4e09-d051-42cf-9c8c-f432abb298aa.jpg40.5668-4.28688Santa María de la AlamedaMadridfalsefalse

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/pisos-com/search?operation=sale&location=madrid&property_type=pisos&max_price=400000&bedrooms=3&sort=price_asc

21 datapoints

Identity

  • idstring
  • listing_idstring
  • titlestring

Contact

  • urlurl

Location

  • locationstring
  • area_m2integer
  • latitudenumber
  • longitudenumber
  • regionstring

Reputation

  • photo_countinteger
  • imageurl

Price

  • priceinteger
  • currencystring

Other

  • pathstring
  • operationstring
  • bedroomsinteger
  • bathroomsinteger
  • descriptionstring
  • localitystring
  • is_new_developmentboolean
  • is_promotedboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/pisos-com/search?operation=sale&location=madrid&property_type=pisos&max_price=400000&bedrooms=3&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

pisos.com · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/pisos-com/agency
slug
1 credit
GET/v1/pisos-com/agency-listings
slug+3 optional
1 credit
GET/v1/pisos-com/autocomplete
query+1 optional
1 credit
GET/v1/pisos-com/listing
none+2 optional
1 credit
GET/v1/pisos-com/search
location+12 optional
1 credit

Overview

What you can get

The pisos.com API returns pisos.com property data as JSON through 5 endpoints.

  • Search: search takes a location, with operation (sale or rent), property_type (pisos, casas, aticos, duplex, estudios, locales, garajes, terrenos or habitaciones), min_price, max_price, bedrooms, bathrooms, min_size, features[] (repeatable), has_photo, reduced_price, sort (relevance, newest, price_asc, price_desc, bedrooms_asc, bedrooms_desc, size_asc or size_desc) and page.
  • Listings: listing takes a url or an id.
  • Agencies: agency takes a slug; agency-listings takes a slug, with operation, the same sort values and page.
  • Autocomplete: autocomplete takes a query, with operation.

The recorded search for flats (pisos) for sale in Madrid, up to 400,000 with three bedrooms and sorted by price_asc, returns items with id, listing_id, url, path, title, location, operation, price, currency, bedrooms, bathrooms, area_m2, description, photo_count, image, latitude, longitude, locality, region, is_new_development and is_promoted. It also returns pagination with total (4,587), total_pages and has_next_page, and applied_filters.

How a call works

Search a city: GET /v1/pisos-com/search?operation=sale&location=madrid&property_type=pisos&max_price=400000&bedrooms=3&sort=price_asc with your key in the X-API-Key header. Each item's listing_id is the id that listing takes, or pass its url. Page with page while has_next_page is true. 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 for flats and houses in a Spanish city or province

Use the pisos.com API to track asking prices for flats and houses in a Spanish city or province

Watch price cuts with `reduced_price=true`

Use the pisos.com API to watch price cuts with `reduced_price=true`

Compare new developments with resale homes using `is_new_development`

Use the pisos.com API to compare new developments with resale homes using `is_new_development`

Pull an agency's stock with `agency-listings`

Use the pisos.com API to pull an agency's stock with `agency-listings`

FAQ

Questions

Do I need a pisos.com account?

No. You call this pisos.com API with your Perceptlayer key in the `X-API-Key` header, with no pisos.com login.

How much does the pisos.com 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.

Are property types in Spanish?

Yes. `property_type` takes the site's own terms: pisos, casas, aticos, duplex, estudios, locales, garajes, terrenos or habitaciones.

Should I build a pisos.com scraper instead?

You can, but a pisos.com scraper is code you maintain: page changes break it, requests get blocked, and pisos.com's terms govern how you collect data. The pisos.com API gives you 5 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 pisos.com API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs