--- title: "QuintoAndar API: JSON data, 7 endpoints, 1 credit per call" description: "QuintoAndar API for Brazilian homes to rent or buy, with total monthly cost, photos, condominiums and similar homes as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/quintoandar --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / QuintoAndar 1 credit per call 7 endpoints 31 datapoints # QuintoAndar API QuintoAndar API for Brazilian homes to rent or buy, with total monthly cost, photos, condominiums and similar homes as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below QuintoAndar GET /v1/quintoandar/search?business=RENT&location=curitiba-pr-brasil&price\_max=3000&bedrooms=2&sort=price\_asc&rows=10 ``` { "success": true, "total": 103, "total_transactional": 103, "total_classified": 0, "page": 1, "rows": 10, "returned": 10, "has_more": true, "resolved_location": { "slug": "curitiba-pr-brasil", "type": "CITY", "name": "Curitiba", "city": "Curitiba", "state_code": "PR", "formatted_name": "Curitiba, PR, Brasil", "latitude": -25.480876, "longitude": -49.304425 }, "applied_filters": { "business": "RENT", "location": "curitiba-pr-brasil", "sort": "price_asc", "price_max": 3000, "bedrooms": 2 }, "listings": [ { "id": 895722656, "origin": "TRANSACTIONAL", "url": "https://www.quintoandar.com.br/imovel/895722656/alugar", "for_rent": true, "for_sale": true, "type": "Casa", "price": 1300, "rent_price": 1300, "sale_price": 390500, "total_cost": 1378, "iptu": 20, "iptu_plus_condominium": 20, "area": 104, "bedrooms": 2, "bathrooms": 1, "suites": 0, "parking_spaces": 1, "is_furnished": false, "has_elevator": false, "address": "Rua Angélico Tosin", "neighbourhood": "Campo de Santana", "region": "Campo de Santana", "city": "Curitiba", "latitude": -25.5966991, "longitude": -49.3461144, "cover_image": "https://www.quintoandar.com.br/img/original895722656-461.9241623519856IMG8929.jpg", "images": [ "https://www.quintoandar.com.br/img/original895722656-461.9241623519856IMG8929.jpg", "https://www.quintoandar.com.br/img/895722656-490.97610398248537IMG8930.jpg", "https://www.quintoandar.com.br/img/original895722656-34.812945516386804IMG8931.jpg" ], "image_captions": [ "Sala/Cozinha", "Sala/Cozinha", "Sala/Cozinha" ], "amenities": [ "VISTA_LIVRE", "QUARTOS_E_CORREDORES_COM_PORTAS_AMPLAS", "BOX" ], "visit_status": "ACCEPT_ALWAYS", "tags": [ "NEW_AD" ] }, { "id": 895116632, "origin": "TRANSACTIONAL", "url": "https://www.quintoandar.com.br/imovel/895116632/alugar", "for_rent": true, "for_sale": false, "type": "Casa", "price": 1639, "rent_price": 1639, "total_cost": 1712, "area": 63, "bedrooms": 2, "bathrooms": 1, "suites": 0, "parking_spaces": 1, "is_furnished": false, "has_elevator": false, "address": "Rua Doutor Paulo Carbone Júnior", "neighbourhood": "Abranches", "region": "Abranches", "city": "Curitiba", "latitude": -25.3740759, "longitude": -49.2695808, "cover_image": "https://www.quintoandar.com.br/img/original895116632-867.7236148746625DSC0002.JPG", "images": [ "https://www.quintoandar.com.br/img/original895116632-867.7236148746625DSC0002.JPG", "https://www.quintoandar.com.br/img/original895116632-147.36241284572483DSC0003.JPG", "https://www.quintoandar.com.br/img/original895116632-648.9663048719282DSC0004.JPG" ], "image_captions": [ "Sala", "Sala", "Sala" ], "amenities": [ "QUARTOS_E_CORREDORES_COM_PORTAS_AMPLAS", "RUA_SILENCIOSA", "GARDEN" ], "installations": [ "AREA_VERDE" ], "visit_status": "ACCEPT_NEW", "special_conditions": [ "Exclusivity" ], "tags": [ "RENT_ON_TERMINATION", "RENT_ON_TERMINATION_RENTFLOW_ENABLED" ] }, { "id": 894498486, "origin": "TRANSACTIONAL", "url": "https://www.quintoandar.com.br/imovel/894498486/alugar", "for_rent": true, "for_sale": false, "type": "Apartamento", "price": 1170, "rent_price": 1170, "total_cost": 1719, "condominium_fee": 489, "iptu": 13, "iptu_plus_condominium": 502, "area": 48, "bedrooms": 2, "bathrooms": 1, "suites": 0, "parking_spaces": 1, "is_furnished": false, "has_elevator": false, "address": "Estrada Delegado Bruno de Almeida", "neighbourhood": "Tatuquara", "region": "Campo de Santana", "city": "Curitiba", "latitude": -25.5721279, "longitude": -49.3163963, "cover_image": "https://www.quintoandar.com.br/img/894498486-887.4021843543766DSC0003.JPG", "images": [ "https://www.quintoandar.com.br/img/894498486-887.4021843543766DSC0003.JPG", "https://www.quintoandar.com.br/img/894498486-748.5976984585407DSC0001.JPG", "https://www.quintoandar.com.br/img/894498486-090-319.3665074985449DSC0004.JPG" ], "image_captions": [ "Sala", "Sala", "Sala" ], "amenities": [ "VISTA_LIVRE", "QUARTOS_E_CORREDORES_COM_PORTAS_AMPLAS", "RUA_SILENCIOSA" ], "installations": [ "CORRIMAO", "SALAO_DE_FESTAS", "VAGA_DE_GARAGEM_ACESSIVEL" ], "visit_status": "ACCEPT_NEW", "special_conditions": [ "Exclusivity" ], "tags": [ "RENT_ON_TERMINATION", "RENT_ON_TERMINATION_RENTFLOW_ENABLED" ] } ], "meta": { "attempts": 1, "last_status": 200, "endpoint_family": "search", "filtered_out": 0, "request_id": "req_f4cd086131ff4a43b2cfedc071f343ad", "credits_charged": 1, "credits_remaining": 1820 } } ``` 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 integer | origin string | url url | for\_rent boolean | for\_sale boolean | type string | price integer | rent\_price integer | sale\_price number | total\_cost integer | iptu number | iptu\_plus\_condominium number | area integer | bedrooms integer | bathrooms integer | suites integer | parking\_spaces integer | is\_furnished boolean | has\_elevator boolean | address string | neighbourhood string | region string | city string | latitude number | longitude number | cover\_image url | images string\[\] | image\_captions string\[\] | amenities string\[\] | visit\_status string | tags string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 895722656 | TRANSACTIONAL | https://www.quintoandar.com.br/imovel/895722656/alugar | true | true | Casa | 1300 | 1300 | 390500 | 1378 | 20 | 20 | 104 | 2 | 1 | 0 | 1 | false | false | Rua Angélico Tosin | Campo de Santana | Campo de Santana | Curitiba | \-25.5966991 | \-49.3461144 | https://www.quintoandar.com.br/img/original895722656-461.9241623519856IMG8929.jpg | \[3 items\] | \[3 items\] | \[3 items\] | ACCEPT\_ALWAYS | \[1 item\] | | 2 | 895116632 | TRANSACTIONAL | https://www.quintoandar.com.br/imovel/895116632/alugar | true | false | Casa | 1639 | 1639 | — | 1712 | — | — | 63 | 2 | 1 | 0 | 1 | false | false | Rua Doutor Paulo Carbone Júnior | Abranches | Abranches | Curitiba | \-25.3740759 | \-49.2695808 | https://www.quintoandar.com.br/img/original895116632-867.7236148746625DSC0002.JPG | \[3 items\] | \[3 items\] | \[3 items\] | ACCEPT\_NEW | \[2 items\] | | 3 | 894498486 | TRANSACTIONAL | https://www.quintoandar.com.br/imovel/894498486/alugar | true | false | Apartamento | 1170 | 1170 | — | 1719 | 13 | 502 | 48 | 2 | 1 | 0 | 1 | false | false | Estrada Delegado Bruno de Almeida | Tatuquara | Campo de Santana | Curitiba | \-25.5721279 | \-49.3163963 | https://www.quintoandar.com.br/img/894498486-887.4021843543766DSC0003.JPG | \[3 items\] | \[3 items\] | \[3 items\] | ACCEPT\_NEW | \[2 items\] | Recorded from our API · 3 items shown · 31 datapoints per item GET /v1/quintoandar/search?business=RENT&location=curitiba-pr-brasil&price\_max=3000&bedrooms=2&sort=price\_asc&rows=10 31 datapoints ### Identity - id integer - type string - visit\_status string ### Contact - url url ### Location - area integer - address string - neighbourhood string - region string - city string - latitude number - longitude number ### Reputation - cover\_image url - images string\[\] - image\_captions string\[\] ### Price - price integer - rent\_price integer - sale\_price number - total\_cost integer ### Other - origin string - for\_rent boolean - for\_sale boolean - iptu number - iptu\_plus\_condominium number - bedrooms integer - bathrooms integer - suites integer - parking\_spaces integer - is\_furnished boolean - has\_elevator boolean - amenities string\[\] - tags string\[\] Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/quintoandar/search?business=RENT&location=curitiba-pr-brasil&price_max=3000&bedrooms=2&sort=price_asc&rows=10" \ -H "X-API-Key: $API_KEY" ``` QuintoAndar · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/quintoandar/autocomplete`](https://perceptlayer.com/apis/quintoandar/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/quintoandar/condominium`](https://perceptlayer.com/apis/quintoandar/condominium) | `hash_id` | 1 credit | | [GET `/v1/quintoandar/filters`](https://perceptlayer.com/apis/quintoandar/filters) | none +1 optional | 1 credit | | [GET `/v1/quintoandar/media`](https://perceptlayer.com/apis/quintoandar/media) | `id` | 1 credit | | [GET `/v1/quintoandar/property`](https://perceptlayer.com/apis/quintoandar/property) | `id` +1 optional | 1 credit | | [GET `/v1/quintoandar/search`](https://perceptlayer.com/apis/quintoandar/search) | `business` `location` +19 optional | 1 credit | | [GET `/v1/quintoandar/similar`](https://perceptlayer.com/apis/quintoandar/similar) | `id` `business` +1 optional | 1 credit | Overview ## About the QuintoAndar API ## What you can get The QuintoAndar API returns QuintoAndar property data as JSON through 7 endpoints. - **Search:** `search` takes a `business` (RENT or SALE) and a `location`, with `price_min`, `price_max`, `bedrooms`, `bedrooms_max`, `bathrooms`, `bathrooms_max`, `parking_spaces`, `suites`, `area_min`, `area_max`, `property_type`, `furnished`, `amenities`, `installations`, `availability` (ANY or IMMEDIATE), `origin` (HYBRID, TRANSACTIONAL or CLASSIFIED), `sort` (relevance, price\_asc, price\_desc, newest or highest\_rent), `rows` and `page`. `filters` takes a `business`. - **Properties:** `property` takes an `id`, with `origin` (TRANSACTIONAL or CLASSIFIED); `media` takes an `id`; `similar` takes an `id` and a `business`, with `type` (neighbourhood, nearby or condominium). - **Condominiums:** `condominium` takes a `hash_id`. - **Autocomplete:** `autocomplete` takes a `q`, with `limit`. The recorded `search` for two-bedroom rentals in Curitiba up to 3,000, sorted by `price_asc` with 10 `rows`, returns `listings` with `id`, `origin`, `url`, `for_rent`, `for_sale`, `type`, `price`, `rent_price`, `sale_price`, `total_cost`, `iptu`, `iptu_plus_condominium`, `area`, `bedrooms`, `bathrooms`, `suites`, `parking_spaces`, `is_furnished`, `has_elevator`, `address`, `neighbourhood`, `city`, `latitude`, `longitude`, `images`, `amenities`, `visit_status` and `tags`. It also returns `total` (103), `total_transactional`, `total_classified`, `has_more` and `resolved_location`. ## How a call works Search a city: `GET /v1/quintoandar/search?business=RENT&location=curitiba-pr-brasil&price_max=3000&bedrooms=2&sort=price_asc&rows=10` with your key in the `X-API-Key` header. Each listing's `id` is what `property`, `media` and `similar` take, and its `origin` is the `origin` that `property` takes. Use `autocomplete` to find a `location` slug. 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 rents and sale prices in Curitiba or another Brazilian city `Use the QuintoAndar API to track rents and sale prices in Curitiba or another Brazilian city` ### Compare the full monthly \`total\_cost\`, including \`iptu\` and condominium fees, against the rent `` Use the QuintoAndar API to compare the full monthly `total_cost`, including `iptu` and condominium fees, against the rent `` ### Find homes available now with \`availability=IMMEDIATE\` `` Use the QuintoAndar API to find homes available now with `availability=IMMEDIATE` `` ### Pull similar homes in the same neighbourhood, nearby or in the same condominium with \`similar\` `` Use the QuintoAndar API to pull similar homes in the same neighbourhood, nearby or in the same condominium with `similar` `` FAQ ## Questions **Do I need a QuintoAndar account?** No. You call this QuintoAndar API with your Perceptlayer key in the \`X-API-Key\` header, with no QuintoAndar login. **How much does the QuintoAndar 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. **Does the price include IPTU and condominium fees?** Each listing carries \`rent\_price\`, \`iptu\`, \`iptu\_plus\_condominium\` and \`total\_cost\`, so you can compare the rent with the full monthly cost. **Should I build a QuintoAndar scraper instead?** You can, but a QuintoAndar scraper is code you maintain: page changes break it, requests get blocked, and QuintoAndar's terms govern how you collect data. The QuintoAndar API gives you 7 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 QuintoAndar 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)