--- title: "pisos.com API: JSON data, 5 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/pisos-com --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / pisos.com 1 credit per call 5 endpoints 21 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 key](https://perceptlayer.com/signup) Run 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 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 string | listing\_id string | url url | path string | title string | location string | operation string | price integer | currency string | bedrooms integer | bathrooms integer | area\_m2 integer | description string | photo\_count integer | image url | latitude number | longitude number | locality string | region string | is\_new\_development boolean | is\_promoted boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 62507207196 | 62507207196.109800 | https://www.pisos.com/comprar/casa\_adosada-aoslos-62507207196\_109800/ | /comprar/casa\_adosada-aoslos-62507207196\_109800/ | Casa adosada en calle de Castillejos, 11 | Aoslos (Horcajo de la Sierra-Aoslos) | sale | 30000 | EUR | 4 | 3 | 130 | Casa vieja, dos alturas más bajo cubierta. Luces delanteras y traseras. 69 m² por planta. Casco urbano, acometidas en la puerta | 7 | https://fotos.imghs.net/mm-wp/1098/5596479/1098\_1\_foto\_20260321095955294\_62507207196.jpeg | 41.067238 | \-3.5843678 | Horcajo de la Sierra Aoslos | Madrid | false | false | | 2 | 68382772500 | 68382772500.534524 | https://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, 8 | San Martín de Valdeiglesias | sale | 40000 | EUR | 3 | 1 | 139 | 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,... | 4 | https://fotos.imghs.net/mm-wp/534524/68382772500.534524/534524\_68382772500\_8478cdbf-b78c-4f62-834e-5a5cbcf4648f.jpg | 40.36227 | \-4.398933 | San Martín de Valdeiglesias | Madrid | false | false | | 3 | 68349369538 | 68349369538.109200 | https://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, 36 | Estación de Santa María de la Alameda (Santa María de la Alameda) | sale | 42280 | EUR | 3 | 1 | 71 | 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... | 6 | https://fotos.imghs.net/mm-wp/1092/3230323631303331/0a4b4e09-d051-42cf-9c8c-f432abb298aa.jpg | 40.5668 | \-4.28688 | Santa María de la Alameda | Madrid | false | false | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/pisos-com/search?operation=sale&location=madrid&property\_type=pisos&max\_price=400000&bedrooms=3&sort=price\_asc 21 datapoints ### Identity - id string - listing\_id string - title string ### Contact - url url ### Location - location string - area\_m2 integer - latitude number - longitude number - region string ### Reputation - photo\_count integer - image url ### Price - price integer - currency string ### Other - path string - operation string - bedrooms integer - bathrooms integer - description string - locality string - is\_new\_development boolean - is\_promoted boolean Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/pisos-com/agency`](https://perceptlayer.com/apis/pisos-com/agency) | `slug` | 1 credit | | [GET `/v1/pisos-com/agency-listings`](https://perceptlayer.com/apis/pisos-com/agency-listings) | `slug` +3 optional | 1 credit | | [GET `/v1/pisos-com/autocomplete`](https://perceptlayer.com/apis/pisos-com/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/pisos-com/listing`](https://perceptlayer.com/apis/pisos-com/listing) | none +2 optional | 1 credit | | [GET `/v1/pisos-com/search`](https://perceptlayer.com/apis/pisos-com/search) | `location` +12 optional | 1 credit | Overview ## About the pisos.com API ## 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 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 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)