QuintoAndar: Search

Search from QuintoAndar as JSON. 1 credit per successful call.

GET /v1/quintoandar/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`business`	string	Required	RENT, SALE
`location`	string	Required	Up to 120 characters
`price_min`	number	Optional	Any
`price_max`	number	Optional	Any
`bedrooms`	integer	Optional	Any
`bedrooms_max`	integer	Optional	Any
`bathrooms`	integer	Optional	Any
`bathrooms_max`	integer	Optional	Any
`parking_spaces`	integer	Optional	Any
`suites`	integer	Optional	Any
`area_min`	number	Optional	Any
`area_max`	number	Optional	Any
`property_type`	string	Optional	Any
`furnished`	string	Optional	true, false, 1, 0
`amenities`	string	Optional	Any
`installations`	string	Optional	Any
`availability`	string	Optional	ANY, IMMEDIATE
`origin`	string	Optional	HYBRID, TRANSACTIONAL, CLASSIFIED
`sort`	string	Optional	relevance, price_asc, price_desc, newest, highest_rent
`rows`	integer	Optional	Any
`page`	integer	Optional	Any

Example request

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.

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