--- title: "Casa Sapo API: JSON data, 6 endpoints, 1 credit per call" description: "Casa Sapo API for Portuguese homes, land and shops to buy or rent, listing details, agencies and their listings as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/casa-sapo --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Casa Sapo 1 credit per call 6 endpoints 21 datapoints # Casa Sapo API Casa Sapo API for Portuguese homes, land and shops to buy or rent, listing details, agencies and their listings as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Casa Sapo GET /v1/casa-sapo/search?operation=buy&property\_type=apartamentos&location=lisboa&bedrooms=3&price\_max=600000 ``` { "success": true, "data": { "total": 828, "pagination": { "page": 1, "per_page": 25, "has_next_page": true }, "filters": { "operation": "buy", "property_type": "apartamentos", "location": "lisboa", "bedrooms": 3, "price_max": 600000 }, "listings": [ { "id": "6d99ed09-4c5c-11f0-a463-060000000052", "g3pid": "1098421", "url": "https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-6d99ed09-4c5c-11f0-a463-060000000052.html", "title": "Apartamento T3 Penha de França, Lisboa", "property_type": "Apartamento T3", "category": "Apartamentos", "transaction": "sale", "typology": "T3", "bedrooms": 3, "condition": "Usado", "area_m2": 60, "price": 459900, "currency": "EUR", "price_text": "459.900 €", "location": { "text": "Penha de França, Lisboa, Distrito de Lisboa", "freguesia": "Penha de França", "concelho": "Lisboa", "distrito": "Distrito de Lisboa", "country": "PT", "latitude": 38.72176, "longitude": -9.13053 }, "description": "Bairro familiar, residencial e com novos pontos de comércio e serviços. Comércio tradicional, lojas de design e mobiliário, cafés e restaurantes Zona central, facilidade de acessos, proximidade de transportes públicos, e vários equipamentos…", "images": [ "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C5403/P27221708/Tphoto/IDcc5e9f01-0000-0500-0000-00001902d341.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C5403/P27221708/Tphoto/IDcc5e9f01-0000-0500-0000-00001902d351.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C5403/P27221708/Tphoto/IDcc5e9f01-0000-0500-0000-00001902d35f.jpg" ], "has_video": true, "has_virtual_tour": false, "seller_type": "agency", "advertiser": { "type": "agency", "name": "Acrosscoast", "id": "14084", "slug": "acrosscoast", "profile_url": "https://casa.sapo.pt/agencia/acrosscoast/?cl=14084&sys=5", "logo": "https://media.egorealestate.com/150x70/b21c984d-cb95-42df-8066-48713bdd4218.png", "website": "http://acrosscoast.pt", "address": "Rua Barão de Sabrosa, 317A" } }, { "id": "b8401c4c-e37d-11f0-a463-060000000052", "g3pid": "1096084", "url": "https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-b8401c4c-e37d-11f0-a463-060000000052.html", "title": "Apartamento T3 Penha de França, Lisboa", "property_type": "Apartamento T3", "category": "Apartamentos", "transaction": "sale", "typology": "T3", "bedrooms": 3, "condition": "Novo", "area_m2": 65, "price": 459900, "currency": "EUR", "price_text": "459.900 €", "location": { "text": "Penha de França, Lisboa, Distrito de Lisboa", "freguesia": "Penha de França", "concelho": "Lisboa", "distrito": "Distrito de Lisboa", "country": "PT", "latitude": 38.72176, "longitude": -9.13053 }, "description": "Apartamento T3 Remodelado, Equipado e Mobilado na Penha de França\n\nSeja para viver ou rentabilizar, um escolha segura de investimento.\nDescrição: :\n\nHall de entrada\n-cozinha com 10m², totalmente renovada e equipada\n-Sala cim 20 m2 ideal par…", "images": [ "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C9849/P29028188/Tphoto/ID5cefba01-0000-0500-0000-00001a264bba.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C9849/P29028188/Tphoto/ID5cefba01-0000-0500-0000-00001a264bbb.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C9849/P29028188/Tphoto/ID5cefba01-0000-0500-0000-00001a264bbc.jpg" ], "has_video": false, "has_virtual_tour": false, "seller_type": "agency", "advertiser": { "type": "agency", "name": "Carla Moniz Soares - Mediação Imobiliária, Sociedade Unipessoal Lda", "id": "18549", "slug": "carla-moniz-soares-mediacao-imobiliaria-sociedade-unipessoal-lda", "profile_url": "https://casa.sapo.pt/agencia/carla-moniz-soares-mediacao-imobiliaria-sociedade-unipessoal-lda/?cl=18549&sys=5", "logo": "https://media.egorealestate.com/150x70/4502af99-fa80-41dc-972e-741a3715825d.png", "address": "Rua do Recife nº. 4, 5º" } }, { "id": "159557a0-ce28-11f1-b6e5-060000000058", "g3pid": "1095791", "url": "https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-avenida-general-rocadas-159557a0-ce28-11f1-b6e5-060000000058.html", "title": "Apartamento T3 Avenida General Roçadas, Penha de França, Lisboa", "property_type": "Apartamento T3", "category": "Apartamentos", "transaction": "sale", "typology": "T3", "bedrooms": 3, "condition": "Recuperado", "area_m2": 80, "price": 479000, "currency": "EUR", "price_text": "479.000 €", "location": { "text": "Avenida General Roçadas, Penha de França, Lisboa, Distrito de Lisboa", "street": "Avenida General Roçadas", "freguesia": "Penha de França", "concelho": "Lisboa", "distrito": "Distrito de Lisboa", "country": "PT", "latitude": 38.72707, "longitude": -9.12847 }, "description": "Apartamento T3, com 80m², totalmente recuperado com materiais de elevada qualidade, situado na Avenida General Roçadas, em Penha de França, Lisboa. O imóvel localiza-se no primeiro andar de um prédio de traça antiga bem conservado.\n\nO apart…", "images": [ "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C996/P31278739/Tphoto/ID9346dd01-0000-0500-0000-00001aaf9614.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C996/P31278739/Tphoto/ID9346dd01-0000-0500-0000-00001aaf209a.jpg", "https://media.casasapo.pt/Z1440x1080/OAYES/S5/C996/P31278739/Tphoto/ID9346dd01-0000-0500-0000-00001aaf209b.jpg" ], "has_video": false, "has_virtual_tour": false, "seller_type": "agency", "advertiser": { "type": "agency", "name": "Valor de Mercado - Sociedade de Mediação Imobiliária, Lda", "id": "9663", "slug": "valor-de-mercado-sociedade-de-mediacao-imobiliaria-lda", "profile_url": "https://casa.sapo.pt/agencia/valor-de-mercado-sociedade-de-mediacao-imobiliaria-lda/?cl=9663&sys=5", "logo": "https://media.egorealestate.com/150x70/20862da1-66d6-4f60-a645-fda005f99f66.png", "website": "http://valordemercado.com", "address": "RUA DR. AUGUSTO JOSE DA CUNHA Nº3 I, Alges" } } ] }, "meta": { "endpoint_family": "search", "request_id": "req_deba0e635c3b4f23bae5bfe284ab00cf", "credits_charged": 1, "credits_remaining": 1884 } } ``` 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 | g3pid string | url url | title string | property\_type string | category string | transaction string | typology string | bedrooms integer | condition string | area\_m2 integer | price integer | currency string | price\_text string | location object | description string | images string\[\] | has\_video boolean | has\_virtual\_tour boolean | seller\_type string | advertiser object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 6d99ed09-4c5c-11f0-a463-060000000052 | 1098421 | https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-6d99ed09-4c5c-11f0-a463-060000000052.html | Apartamento T3 Penha de França, Lisboa | Apartamento T3 | Apartamentos | sale | T3 | 3 | Usado | 60 | 459900 | EUR | 459.900 € | {7 fields} | Bairro familiar, residencial e com novos pontos de comércio e serviços. Comércio tradicional, lojas de design e mobiliário, cafés e restaurantes Zona central, facilidade de acessos, proximidade de transportes públicos, e vários equipamentos… | \[3 items\] | true | false | agency | {8 fields} | | 2 | b8401c4c-e37d-11f0-a463-060000000052 | 1096084 | https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-b8401c4c-e37d-11f0-a463-060000000052.html | Apartamento T3 Penha de França, Lisboa | Apartamento T3 | Apartamentos | sale | T3 | 3 | Novo | 65 | 459900 | EUR | 459.900 € | {7 fields} | Apartamento T3 Remodelado, Equipado e Mobilado na Penha de França Seja para viver ou rentabilizar, um escolha segura de investimento. Descrição: : Hall de entrada -cozinha com 10m², totalmente renovada e equipada -Sala cim 20 m2 ideal par… | \[3 items\] | false | false | agency | {7 fields} | | 3 | 159557a0-ce28-11f1-b6e5-060000000058 | 1095791 | https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-avenida-general-rocadas-159557a0-ce28-11f1-b6e5-060000000058.html | Apartamento T3 Avenida General Roçadas, Penha de França, Lisboa | Apartamento T3 | Apartamentos | sale | T3 | 3 | Recuperado | 80 | 479000 | EUR | 479.000 € | {8 fields} | Apartamento T3, com 80m², totalmente recuperado com materiais de elevada qualidade, situado na Avenida General Roçadas, em Penha de França, Lisboa. O imóvel localiza-se no primeiro andar de um prédio de traça antiga bem conservado. O apart… | \[3 items\] | false | false | agency | {8 fields} | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/casa-sapo/search?operation=buy&property\_type=apartamentos&location=lisboa&bedrooms=3&price\_max=600000 21 datapoints ### Identity - id string - g3pid string - title string - property\_type string - category string ### Contact - url url - seller\_type string ### Location - area\_m2 integer - location object ### Reputation - images string\[\] ### Price - price integer - currency string - price\_text string ### Other - transaction string - typology string - bedrooms integer - condition string - description string - has\_video boolean - has\_virtual\_tour boolean - advertiser object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/casa-sapo/search?operation=buy&property_type=apartamentos&location=lisboa&bedrooms=3&price_max=600000" \ -H "X-API-Key: $API_KEY" ``` Casa Sapo · 6 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/casa-sapo/agencies`](https://perceptlayer.com/apis/casa-sapo/agencies) | none +1 optional | 1 credit | | [GET `/v1/casa-sapo/agency`](https://perceptlayer.com/apis/casa-sapo/agency) | `id` | 1 credit | | [GET `/v1/casa-sapo/agency-listings`](https://perceptlayer.com/apis/casa-sapo/agency-listings) | `id` +1 optional | 1 credit | | [GET `/v1/casa-sapo/listing`](https://perceptlayer.com/apis/casa-sapo/listing) | `id` | 1 credit | | [GET `/v1/casa-sapo/locations`](https://perceptlayer.com/apis/casa-sapo/locations) | `query` | 1 credit | | [GET `/v1/casa-sapo/search`](https://perceptlayer.com/apis/casa-sapo/search) | `operation` +10 optional | 1 credit | Overview ## About the Casa Sapo API ## What you can get The Casa Sapo API returns Casa Sapo property data for Portugal as JSON through 6 endpoints. - **Search:** `search` takes an `operation` (buy, sale or rent), with `property_type` (apartamentos, moradias, terrenos, lojas, escritorios, predios, armazens, quintas-e-herdades, imoveis-de-luxo, garagens or quartos), `location`, `bedrooms`, `price_min`, `price_max`, `area_min`, `area_max`, `seller_type` (private or agency), `sort` (price\_asc, price\_desc, newest, oldest or most\_photos) and `page`. - **Listings:** `listing` takes an `id`. - **Agencies:** `agencies` takes a `page`; `agency` and `agency-listings` take an `id`, and `agency-listings` also takes `page`. - **Locations:** `locations` takes a `query`. The recorded `search` ( `operation=buy`, `property_type=apartamentos`, `location=lisboa`, `bedrooms=3`, `price_max=600000`) returns `listings`, each with `id`, `url`, `title`, `property_type`, `category`, `transaction`, `typology` (such as T3), `bedrooms`, `condition`, `area_m2`, `price`, `currency`, `price_text`, `location` ( `freguesia`, `concelho`, `distrito`, `latitude`, `longitude`), `images`, `has_virtual_tour`, `seller_type` and `advertiser`. It also returns `total` (828) and `pagination` with `per_page` and `has_next_page`. ## How a call works Search three-bedroom flats for sale in Lisbon: `GET /v1/casa-sapo/search?operation=buy&property_type=apartamentos&location=lisboa&bedrooms=3&price_max=600000` with your key in the `X-API-Key` header. Each listing's `id` goes to `listing`, and its `advertiser.id` goes to `agency` and `agency-listings`. 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 in euros by freguesia and concelho in Lisbon and the rest of Portugal `Use the Casa Sapo API to track asking prices in euros by freguesia and concelho in Lisbon and the rest of Portugal` ### Compare prices by \`typology\`, such as T3, and by \`condition\` `` Use the Casa Sapo API to compare prices by `typology`, such as T3, and by `condition` `` ### Separate private sellers from agencies with \`seller\_type\` `` Use the Casa Sapo API to separate private sellers from agencies with `seller_type` `` ### Pull an agency's listings with \`agency-listings\` `` Use the Casa Sapo API to pull an agency's listings with `agency-listings` `` FAQ ## Questions **Do I need a Casa Sapo account?** No. You call this Casa Sapo API with your Perceptlayer key in the \`X-API-Key\` header, with no Casa Sapo login. **How much does the Casa Sapo 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 the property types in Portuguese?** Yes. \`property\_type\` takes the site's Portuguese slugs, such as apartamentos for flats, moradias for houses and terrenos for land. **Should I build a Casa Sapo scraper instead?** You can, but a Casa Sapo scraper is code you maintain: page changes break it, requests get blocked, and Casa Sapo's terms govern how you collect data. The Casa Sapo API gives you 6 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 Casa Sapo 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)