Sign inGet a free API keyDashboard
Menu

APIs / Real estate / QuintoAndar

1 credit per call7 endpoints31 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 keyRun 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 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.

#idintegeroriginstringurlurlfor_rentbooleanfor_salebooleantypestringpriceintegerrent_priceintegersale_pricenumbertotal_costintegeriptunumberiptu_plus_condominiumnumberareaintegerbedroomsintegerbathroomsintegersuitesintegerparking_spacesintegeris_furnishedbooleanhas_elevatorbooleanaddressstringneighbourhoodstringregionstringcitystringlatitudenumberlongitudenumbercover_imageurlimagesstring[]image_captionsstring[]amenitiesstring[]visit_statusstringtagsstring[]
1895722656TRANSACTIONALhttps://www.quintoandar.com.br/imovel/895722656/alugartruetrueCasa13001300390500137820201042101falsefalseRua Angélico TosinCampo de SantanaCampo de SantanaCuritiba-25.5966991-49.3461144https://www.quintoandar.com.br/img/original895722656-461.9241623519856IMG8929.jpg[3 items][3 items][3 items]ACCEPT_ALWAYS[1 item]
2895116632TRANSACTIONALhttps://www.quintoandar.com.br/imovel/895116632/alugartruefalseCasa16391639—1712——632101falsefalseRua Doutor Paulo Carbone JúniorAbranchesAbranchesCuritiba-25.3740759-49.2695808https://www.quintoandar.com.br/img/original895116632-867.7236148746625DSC0002.JPG[3 items][3 items][3 items]ACCEPT_NEW[2 items]
3894498486TRANSACTIONALhttps://www.quintoandar.com.br/imovel/894498486/alugartruefalseApartamento11701170—171913502482101falsefalseEstrada Delegado Bruno de AlmeidaTatuquaraCampo de SantanaCuritiba-25.5721279-49.3163963https://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 itemGET /v1/quintoandar/search?business=RENT&location=curitiba-pr-brasil&price_max=3000&bedrooms=2&sort=price_asc&rows=10

31 datapoints

Identity

  • idinteger
  • typestring
  • visit_statusstring

Contact

  • urlurl

Location

  • areainteger
  • addressstring
  • neighbourhoodstring
  • regionstring
  • citystring
  • latitudenumber
  • longitudenumber

Reputation

  • cover_imageurl
  • imagesstring[]
  • image_captionsstring[]

Price

  • priceinteger
  • rent_priceinteger
  • sale_pricenumber
  • total_costinteger

Other

  • originstring
  • for_rentboolean
  • for_saleboolean
  • iptunumber
  • iptu_plus_condominiumnumber
  • bedroomsinteger
  • bathroomsinteger
  • suitesinteger
  • parking_spacesinteger
  • is_furnishedboolean
  • has_elevatorboolean
  • amenitiesstring[]
  • tagsstring[]

Playground

Run this API

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

EndpointRequired parametersCost
GET/v1/quintoandar/autocomplete
q+1 optional
1 credit
GET/v1/quintoandar/condominium
hash_id
1 credit
GET/v1/quintoandar/filters
none+1 optional
1 credit
GET/v1/quintoandar/media
id
1 credit
GET/v1/quintoandar/property
id+1 optional
1 credit
GET/v1/quintoandar/search
businesslocation+19 optional
1 credit
GET/v1/quintoandar/similar
idbusiness+1 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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