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.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
operation | string | Required | buy, sale, rent |
property_type | string | Optional | apartamentos, moradias, terrenos, lojas, escritorios, predios, armazens, quintas-e-herdades, imoveis-de-luxo, garagens, quartos |
location | string | Optional | Up to 150 characters |
bedrooms | integer | Optional | Any |
sort | string | Optional | price_asc, price_desc, newest, oldest, most_photos |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
area_min | integer | Optional | Any |
area_max | integer | Optional | Any |
seller_type | string | Optional | private, agency |
page | integer | Optional | Any |
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.