Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Casa Sapo

1 credit per call6 endpoints21 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 keyRun 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 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.

#idstringg3pidstringurlurltitlestringproperty_typestringcategorystringtransactionstringtypologystringbedroomsintegerconditionstringarea_m2integerpriceintegercurrencystringprice_textstringlocationobjectdescriptionstringimagesstring[]has_videobooleanhas_virtual_tourbooleanseller_typestringadvertiserobject
16d99ed09-4c5c-11f0-a463-0600000000521098421https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-6d99ed09-4c5c-11f0-a463-060000000052.htmlApartamento T3 Penha de França, LisboaApartamento T3ApartamentossaleT33Usado60459900EUR459.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]truefalseagency{8 fields}
2b8401c4c-e37d-11f0-a463-0600000000521096084https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-b8401c4c-e37d-11f0-a463-060000000052.htmlApartamento T3 Penha de França, LisboaApartamento T3ApartamentossaleT33Novo65459900EUR459.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]falsefalseagency{7 fields}
3159557a0-ce28-11f1-b6e5-0600000000581095791https://casa.sapo.pt/comprar-apartamento-t3-lisboa-penha-de-franca-avenida-general-rocadas-159557a0-ce28-11f1-b6e5-060000000058.htmlApartamento T3 Avenida General Roçadas, Penha de França, LisboaApartamento T3ApartamentossaleT33Recuperado80479000EUR479.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]falsefalseagency{8 fields}

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/casa-sapo/search?operation=buy&property_type=apartamentos&location=lisboa&bedrooms=3&price_max=600000

21 datapoints

Identity

  • idstring
  • g3pidstring
  • titlestring
  • property_typestring
  • categorystring

Contact

  • urlurl
  • seller_typestring

Location

  • area_m2integer
  • locationobject

Reputation

  • imagesstring[]

Price

  • priceinteger
  • currencystring
  • price_textstring

Other

  • transactionstring
  • typologystring
  • bedroomsinteger
  • conditionstring
  • descriptionstring
  • has_videoboolean
  • has_virtual_tourboolean
  • advertiserobject

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/casa-sapo/agencies
none+1 optional
1 credit
GET/v1/casa-sapo/agency
id
1 credit
GET/v1/casa-sapo/agency-listings
id+1 optional
1 credit
GET/v1/casa-sapo/listing
id
1 credit
GET/v1/casa-sapo/locations
query
1 credit
GET/v1/casa-sapo/search
operation+10 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs