--- title: "Casa Sapo API: Search | Perceptlayer" description: "Search from Casa Sapo as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/casa-sapo/search --- [APIs](https://perceptlayer.com/apis) / [Casa Sapo](https://perceptlayer.com/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. | 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 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/casa-sapo?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.