APIs / Casa Sapo / Search

Casa Sapo: Search

Search from Casa Sapo as JSON. 1 credit per successful call.

GET /v1/casa-sapo/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
operationstringRequiredbuy, sale, rent
property_typestringOptionalapartamentos, moradias, terrenos, lojas, escritorios, predios, armazens, quintas-e-herdades, imoveis-de-luxo, garagens, quartos
locationstringOptionalUp to 150 characters
bedroomsintegerOptionalAny
sortstringOptionalprice_asc, price_desc, newest, oldest, most_photos
price_minintegerOptionalAny
price_maxintegerOptionalAny
area_minintegerOptionalAny
area_maxintegerOptionalAny
seller_typestringOptionalprivate, agency
pageintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.