Dataspryva
Actors/Brazil Rental & Sale Listings by City (QuintoAndar)

Brazil Rental & Sale Listings by City (QuintoAndar)

Search Brazilian rental and sale property listings by city and transaction type: price breakdown, bedrooms, bathrooms, area, furnishing, and address across 15 major cities.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredSearch rentals, search properties for sale, or load specific listings by URL or ID.
citystringoptionalQuintoAndar location to search (mode=rent or buy).
neighborhoodstringoptionalOptional neighborhood inside the selected city, e.g. Pinheiros or Copacabana (mode=rent or buy).
Show all input fields
FieldTypeRequiredDescription
modestringrequiredSearch rentals, search properties for sale, or load specific listings by URL or ID.
citystringoptionalQuintoAndar location to search (mode=rent or buy).
neighborhoodstringoptionalOptional neighborhood inside the selected city, e.g. Pinheiros or Copacabana (mode=rent or buy).
propertyTypestringoptionalRestrict results to one property type (mode=rent or buy).
priceBasisstringoptionalWhether price filters apply to the base rent or the total monthly cost (mode=rent). Buy mode always uses the sale price.
priceMinintegeroptionalLowest price to include, in Brazilian reais.
priceMaxintegeroptionalHighest price to include, in Brazilian reais.
areaMinintegeroptionalSmallest usable area to include, in square metres.
areaMaxintegeroptionalLargest usable area to include, in square metres.
bedroomsMinintegeroptionalFewest bedrooms a listing may have.
bedroomsMaxintegeroptionalMost bedrooms a listing may have.
bathroomsMinintegeroptionalFewest bathrooms a listing may have.
bathroomsMaxintegeroptionalMost bathrooms a listing may have.
parkingMinintegeroptionalFewest parking spaces a listing may have.
parkingMaxintegeroptionalMost parking spaces a listing may have.
suitesMinintegeroptionalFewest suites a listing may have.
suitesMaxintegeroptionalMost suites a listing may have.
furnishedstringoptionalInclude only furnished listings, only unfurnished listings, or both.
acceptsPetsstringoptionalInclude only listings that accept pets, or all listings.
nearSubwaystringoptionalInclude only listings marked close to a metro or train station, or all listings.
amenitiesarrayoptionalProperty feature codes that must all be present, e.g. VARANDA, AR_CONDICIONADO (mode=rent or buy).
installationsarrayoptionalBuilding facility codes that must all be present, e.g. PISCINA, ACADEMIA (mode=rent or buy).
availabilitystringoptionalWhen the property can be occupied (mode=rent).
sortBystringoptionalOrder of the returned listings. Cheapest and most expensive use total monthly cost; highest rental return is the investor yield order.
developmentsOnlybooleanoptionalShow only new-development listings (mode=buy).
exactCityOnlybooleanoptionalDrop listings from neighbouring municipalities that QuintoAndar includes in a city search.
includeDetailsbooleanoptionalLoad each listing's detail page for description, separate condo fee and IPTU, ZIP code, coordinates and full photo captions.
listingUrlsarrayoptionalQuintoAndar listing links or numeric property IDs (mode=byUrls). Duplicates are ignored.
maxItemsintegeroptionalHard cap on the number of listings returned (1-5000). Values above 1000 use price-slice partitioning.

Download the published input schema

View complete JSON
{
  "description": "Choose a location or paste listing URLs, then narrow by price, size, rooms, amenities and more.",
  "properties": {
    "acceptsPets": {
      "default": "any",
      "description": "Include only listings that accept pets, or all listings.",
      "editor": "select",
      "enum": [
        "any",
        "yes"
      ],
      "enumTitles": [
        "Any",
        "Accepts pets only"
      ],
      "prefill": "any",
      "title": "Accepts pets",
      "type": "string"
    },
    "amenities": {
      "description": "Property feature codes that must all be present, e.g. VARANDA, AR_CONDICIONADO (mode=rent or buy).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Unit amenities",
      "type": "array"
    },
    "areaMax": {
      "description": "Largest usable area to include, in square metres.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Maximum area (m²)",
      "type": "integer"
    },
    "areaMin": {
      "description": "Smallest usable area to include, in square metres.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Minimum area (m²)",
      "type": "integer"
    },
    "availability": {
      "default": "any",
      "description": "When the property can be occupied (mode=rent).",
      "editor": "select",
      "enum": [
        "any",
        "immediate",
        "soon"
      ],
      "enumTitles": [
        "Any",
        "Available immediately",
        "Available soon"
      ],
      "prefill": "any",
      "title": "Availability",
      "type": "string"
    },
    "bathroomsMax": {
      "description": "Most bathrooms a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Maximum bathrooms",
      "type": "integer"
    },
    "bathroomsMin": {
      "description": "Fewest bathrooms a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Minimum bathrooms",
      "type": "integer"
    },
    "bedroomsMax": {
      "description": "Most bedrooms a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Maximum bedrooms",
      "type": "integer"
    },
    "bedroomsMin": {
      "description": "Fewest bedrooms a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Minimum bedrooms",
      "type": "integer"
    },
    "city": {
      "default": "sao-paulo-sp-brasil",
      "description": "QuintoAndar location to search (mode=rent or buy).",
      "editor": "select",
      "enum": [
        "sao-paulo-sp-brasil",
        "rio-de-janeiro-rj-brasil",
        "belo-horizonte-mg-brasil",
        "porto-alegre-rs-brasil",
        "brasilia-df-brasil",
        "curitiba-pr-brasil",
        "goiania-go-brasil",
        "campinas-sp-brasil",
        "canoas-rs-brasil",
        "guarulhos-sp-brasil",
        "jundiai-sp-brasil",
        "nova-lima-mg-brasil",
        "novo-hamburgo-rs-brasil",
        "niteroi-rj-brasil",
        "osasco-sp-brasil",
        "santo-andre-sp-brasil",
        "sao-bernardo-do-campo-sp-brasil",
        "sao-caetano-do-sul-sp-brasil",
        "barueri-sp-brasil",
        "sao-leopoldo-rs-brasil",
        "florianopolis-sc-brasil",
        "sao-jose-sc-brasil",
        "palhoca-sc-brasil",
        "contagem-mg-brasil",
        "taboao-da-serra-sp-brasil",
        "diadema-sp-brasil",
        "sao-jose-dos-pinhais-pr-brasil",
        "varzea-paulista-sp-brasil",
        "pinhais-pr-brasil",
        "santana-de-parnaiba-sp-brasil",
        "santos-sp-brasil",
        "salvador-ba-brasil",
        "mogi-das-cruzes-sp-brasil",
        "sao-jose-dos-campos-sp-brasil",
        "cotia-sp-brasil",
        "ribeirao-preto-sp-brasil",
        "sorocaba-sp-brasil",
        "uberlandia-mg-brasil",
        "maua-sp-brasil",
        "valinhos-sp-brasil",
        "vinhedo-sp-brasil",
        "indaiatuba-sp-brasil",
        "nova-iguacu-rj-brasil",
        "americana-sp-brasil",
        "hortolandia-sp-brasil",
        "paulinia-sp-brasil",
        "praia-grande-sp-brasil",
        "guaruja-sp-brasil",
        "carapicuiba-sp-brasil",
        "votorantim-sp-brasil",
        "sao-vicente-sp-brasil",
        "duque-de-caxias-rj-brasil",
        "sao-goncalo-rj-brasil",
        "betim-mg-brasil",
        "aparecida-de-goiania-go-brasil",
        "suzano-sp-brasil",
        "itaquaquecetuba-sp-brasil",
        "sumare-sp-brasil",
        "embu-das-artes-sp-brasil",
        "ferraz-de-vasconcelos-sp-brasil",
        "poa-sp-brasil",
        "gravatai-rs-brasil",
        "viamao-rs-brasil",
        "alvorada-rs-brasil",
        "belford-roxo-rj-brasil",
        "nilopolis-rj-brasil",
        "mesquita-rj-brasil",
        "taubate-sp-brasil",
        "jacarei-sp-brasil",
        "ribeirao-das-neves-mg-brasil",
        "ribeirao-pires-sp-brasil",
        "brumadinho-mg-brasil",
        "itabirito-mg-brasil",
        "lagoa-santa-mg-brasil",
        "sabara-mg-brasil",
        "vespasiano-mg-brasil",
        "rio-acima-mg-brasil",
        "santa-luzia-mg-brasil",
        "marica-rj-brasil",
        "cabo-frio-rj-brasil",
        "petropolis-rj-brasil",
        "sapucaia-do-sul-rs-brasil",
        "macae-rj-brasil",
        "cachoeirinha-rs-brasil",
        "juiz-de-fora-mg-brasil",
        "rio-das-ostras-rj-brasil",
        "sao-carlos-sp-brasil",
        "piracicaba-sp-brasil",
        "limeira-sp-brasil",
        "montes-claros-mg-brasil",
        "londrina-pr-brasil",
        "maringa-pr-brasil",
        "ponta-grossa-pr-brasil",
        "volta-redonda-rj-brasil",
        "santa-maria-rs-brasil",
        "caxias-do-sul-rs-brasil",
        "uberaba-mg-brasil",
        "campos-dos-goytacazes-rj-brasil",
        "anapolis-go-brasil"
      ],
      "enumTitles": [
        "São Paulo",
        "Rio de Janeiro",
        "Belo Horizonte",
        "Porto Alegre",
        "Brasília",
        "Curitiba",
        "Goiânia",
        "Campinas",
        "Canoas",
        "Guarulhos",
        "Jundiaí",
        "Nova Lima",
        "Novo Hamburgo",
        "Niterói",
        "Osasco",
        "Santo André",
        "São Bernardo do Campo",
        "São Caetano do Sul",
        "Barueri",
        "São Leopoldo",
        "Florianópolis",
        "São José",
        "Palhoça",
        "Contagem",
        "Taboão da Serra",
        "Diadema",
        "São José dos Pinhais",
        "Várzea Paulista",
        "Pinhais",
        "Santana de Parnaíba",
        "Santos",
        "Salvador",
        "Mogi das Cruzes",
        "São José dos Campos",
        "Cotia",
        "Ribeirão Preto",
        "Sorocaba",
        "Uberlândia",
        "Mauá",
        "Valinhos",
        "Vinhedo",
        "Indaiatuba",
        "Nova Iguaçu",
        "Americana",
        "Hortolândia",
        "Paulínia",
        "Praia Grande",
        "Guarujá",
        "Carapicuíba",
        "Votorantim",
        "São Vicente",
        "Duque de Caxias",
        "São Gonçalo",
        "Betim",
        "Aparecida de Goiânia",
        "Suzano",
        "Itaquaquecetuba",
        "Sumaré",
        "Embu das Artes",
        "Ferraz de Vasconcelos",
        "Poá",
        "Gravataí",
        "Viamão",
        "Alvorada",
        "Belford Roxo",
        "Nilópolis",
        "Mesquita",
        "Taubaté",
        "Jacareí",
        "Ribeirão das Neves",
        "Ribeirão Pires",
        "Brumadinho",
        "Itabirito",
        "Lagoa Santa",
        "Sabará",
        "Vespasiano",
        "Rio Acima",
        "Santa Luzia",
        "Maricá",
        "Cabo Frio",
        "Petrópolis",
        "Sapucaia do Sul",
        "Macaé",
        "Cachoeirinha",
        "Juiz de Fora",
        "Rio das Ostras",
        "São Carlos",
        "Piracicaba",
        "Limeira",
        "Montes Claros",
        "Londrina",
        "Maringá",
        "Ponta Grossa",
        "Volta Redonda",
        "Santa Maria",
        "Caxias do Sul",
        "Uberaba",
        "Campos dos Goytacazes",
        "Anápolis"
      ],
      "prefill": "sao-paulo-sp-brasil",
      "title": "City or region",
      "type": "string"
    },
    "developmentsOnly": {
      "default": false,
      "description": "Show only new-development listings (mode=buy).",
      "prefill": false,
      "title": "New developments only",
      "type": "boolean"
    },
    "exactCityOnly": {
      "default": false,
      "description": "Drop listings from neighbouring municipalities that QuintoAndar includes in a city search.",
      "prefill": false,
      "title": "Exact city only",
      "type": "boolean"
    },
    "furnished": {
      "default": "any",
      "description": "Include only furnished listings, only unfurnished listings, or both.",
      "editor": "select",
      "enum": [
        "any",
        "yes",
        "no"
      ],
      "enumTitles": [
        "Any",
        "Furnished only",
        "Unfurnished only"
      ],
      "prefill": "any",
      "title": "Furnished",
      "type": "string"
    },
    "includeDetails": {
      "default": true,
      "description": "Load each listing's detail page for description, separate condo fee and IPTU, ZIP code, coordinates and full photo captions.",
      "prefill": false,
      "title": "Include detail fields",
      "type": "boolean"
    },
    "installations": {
      "description": "Building facility codes that must all be present, e.g. PISCINA, ACADEMIA (mode=rent or buy).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Building facilities",
      "type": "array"
    },
    "listingUrls": {
      "description": "QuintoAndar listing links or numeric property IDs (mode=byUrls). Duplicates are ignored.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Listing URLs or IDs",
      "type": "array"
    },
    "maxItems": {
      "default": 500,
      "description": "Hard cap on the number of listings returned (1-5000). Values above 1000 use price-slice partitioning.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum listings",
      "type": "integer"
    },
    "mode": {
      "default": "rent",
      "description": "Search rentals, search properties for sale, or load specific listings by URL or ID.",
      "editor": "select",
      "enum": [
        "rent",
        "buy",
        "byUrls"
      ],
      "enumTitles": [
        "Rentals by location",
        "Properties for sale by location",
        "Specific listings by URL or ID"
      ],
      "prefill": "rent",
      "title": "Mode",
      "type": "string"
    },
    "nearSubway": {
      "default": "any",
      "description": "Include only listings marked close to a metro or train station, or all listings.",
      "editor": "select",
      "enum": [
        "any",
        "yes"
      ],
      "enumTitles": [
        "Any",
        "Near subway only"
      ],
      "prefill": "any",
      "title": "Near subway",
      "type": "string"
    },
    "neighborhood": {
      "description": "Optional neighborhood inside the selected city, e.g. Pinheiros or Copacabana (mode=rent or buy).",
      "editor": "textfield",
      "title": "Neighborhood",
      "type": "string"
    },
    "parkingMax": {
      "description": "Most parking spaces a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Maximum parking spaces",
      "type": "integer"
    },
    "parkingMin": {
      "description": "Fewest parking spaces a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Minimum parking spaces",
      "type": "integer"
    },
    "priceBasis": {
      "default": "rent",
      "description": "Whether price filters apply to the base rent or the total monthly cost (mode=rent). Buy mode always uses the sale price.",
      "editor": "select",
      "enum": [
        "rent",
        "total"
      ],
      "enumTitles": [
        "Base rent",
        "Total monthly cost"
      ],
      "prefill": "rent",
      "title": "Price basis",
      "type": "string"
    },
    "priceMax": {
      "description": "Highest price to include, in Brazilian reais.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Maximum price (BRL)",
      "type": "integer"
    },
    "priceMin": {
      "description": "Lowest price to include, in Brazilian reais.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Minimum price (BRL)",
      "type": "integer"
    },
    "propertyType": {
      "default": "ANY",
      "description": "Restrict results to one property type (mode=rent or buy).",
      "editor": "select",
      "enum": [
        "ANY",
        "APARTMENT",
        "HOUSE",
        "HOUSE_CONDO",
        "STUDIO"
      ],
      "enumTitles": [
        "Any type",
        "Apartment",
        "House",
        "House in a condominium",
        "Studio or kitchenette"
      ],
      "prefill": "ANY",
      "title": "Property type",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Order of the returned listings. Cheapest and most expensive use total monthly cost; highest rental return is the investor yield order.",
      "editor": "select",
      "enum": [
        "relevance",
        "newest",
        "cheapest",
        "expensive",
        "highestRent"
      ],
      "enumTitles": [
        "Relevance",
        "Newest",
        "Cheapest",
        "Most expensive",
        "Highest rental return"
      ],
      "prefill": "relevance",
      "title": "Sort by",
      "type": "string"
    },
    "suitesMax": {
      "description": "Most suites a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Maximum suites",
      "type": "integer"
    },
    "suitesMin": {
      "description": "Fewest suites a listing may have.",
      "maximum": 20,
      "minimum": 0,
      "title": "Minimum suites",
      "type": "integer"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "QuintoAndar Brazil Listings Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
listingsstringoptionalDataset containing all scraped QuintoAndar property listings.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "Brazilian property listings with transaction prices, monthly costs, size, rooms, address and coordinates, amenities, photos, project details and publication dates.",
  "properties": {
    "listings": {
      "description": "Dataset containing all scraped QuintoAndar property listings.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Property listings",
      "type": "string"
    }
  },
  "title": "Brazil Rental & Sale Listings by City (QuintoAndar) Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Property Listings",
      "transformation": {
        "fields": [
          "propertyType",
          "rentPrice",
          "salePrice",
          "totalMonthlyCost",
          "bedrooms",
          "areaSqM",
          "city",
          "neighborhood",
          "propertyUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Brazil Rental & Sale Listings by City (QuintoAndar)

QuintoAndar is one of Brazil's largest home rental and sale marketplaces, covering São Paulo, Rio de Janeiro, Belo Horizonte and dozens of other metro areas. This actor searches its public listings by city or neighborhood and returns structured property records: transaction prices, monthly costs, size, rooms, address, amenities, photos and optional detail-page enrichment. No account, cookie or proxy setup is needed.

What this actor does

  • Three modes: search rentals (rent), search properties for sale (buy), or load specific listings by URL or numeric ID (byUrls)
  • 99 locations, with optional neighborhood search inside any city
  • Server-side filters: property type, price (base rent, total monthly cost or sale price), area, bedrooms, bathrooms, parking, suites, furnished, pets, near subway, amenities, building facilities, availability and sort order (cheapest/expensive use total monthly cost; highestRent is the rental-return order)
  • Large result sets: up to 1,000 listings per query and up to 5,000 per run through automatic price-slice partitioning
  • Optional detail enrichment: description, separate condo fee and IPTU, ZIP code, state, coordinates, full photo gallery with captions, construction year, floor range and project data
  • Empty fields are omitted from each record instead of being returned as null

Output per property

  • propertyId — QuintoAndar property ID
  • title — composed title with property type, bedrooms, neighborhood and city
  • propertyType — Apartamento, Casa, CasaCondominio or StudioOuKitchenette
  • rentPrice — base monthly rent in BRL
  • salePrice — sale price in BRL
  • totalMonthlyCost — rent plus condo fee and IPTU, in BRL
  • condoAndIptu — combined condo fee and IPTU, in BRL
  • condoFee — monthly condo fee in BRL (with detail enrichment)
  • iptu — monthly IPTU in BRL (with detail enrichment)
  • iptuPeriod — always monthly when iptu is present
  • currency — always BRL
  • areaSqM — usable area in square metres
  • bedrooms, bathrooms, suites, parkingSpots — room counts; real zero values are kept
  • street, neighborhood, region, city — address fields
  • state, stateCode, zipCode — state and postal code (with detail enrichment)
  • latitude, longitude — map coordinates (with detail enrichment)
  • amenities[] — unit feature codes, e.g. VARANDA, AR_CONDICIONADO
  • amenitiesText[] — human-readable amenity labels (with detail enrichment)
  • installations[] — building facility codes, e.g. PISCINA, ACADEMIA
  • installationsText[] — human-readable facility labels (with detail enrichment)
  • photos[] — every property photo as a working image URL
  • photoCaptions[] — captions parallel to photos[] when every photo has one
  • imageUrl — primary property image URL
  • isFurnished, forSale, forRent, acceptsPets, nearSubway — listing flags
  • yieldRate, yieldStrategy — rental yield and its calculation basis, when published
  • visitStatus — current visit availability
  • lastPublishedDate, firstPublishedDate — publication timestamps
  • listingTags[], specialConditions[] — listing tags and exclusivity-style conditions
  • isPrimaryMarket, developmentId, developmentName, constructionStatus, forecastDeliveryDate — new-development fields
  • condoName, condoSlug — condominium/project name and slug
  • constructionYear, floorMin, floorMax — building year and floor range
  • shortDescription, description — short and long listing text
  • propertyUrl — canonical QuintoAndar listing page
  • mode — transaction type of the record (rent, buy or byUrls)
  • recordType — always property
  • scrapedAt — ISO 8601 timestamp of when the listing was scraped

Input

Field Type Default Description
mode string rent rent, buy or byUrls
city string sao-paulo-sp-brasil One of 99 QuintoAndar locations (mode=rent or buy)
neighborhood string – Optional neighborhood inside the city, e.g. Pinheiros (mode=rent or buy)
propertyType string ANY ANY, APARTMENT, HOUSE, HOUSE_CONDO or STUDIO
priceBasis string rent rent or total (mode=rent); ignored for buy
priceMin / priceMax integer – Price range in BRL
areaMin / areaMax integer – Usable area range in m²
bedroomsMin / bedroomsMax integer – Bedroom range
bathroomsMin / bathroomsMax integer – Bathroom range
parkingMin / parkingMax integer – Parking space range
suitesMin / suitesMax integer – Suite range
furnished string any any, yes or no
acceptsPets string any any or yes
nearSubway string any any or yes
amenities array – Required unit feature codes
installations array – Required building facility codes
availability string any any, immediate or soon (mode=rent)
sortBy string relevance relevance, newest, cheapest, expensive or highestRent (highest rental return / yield)
developmentsOnly boolean false Show only new developments (mode=buy)
exactCityOnly boolean false Drop listings from neighbouring municipalities
includeDetails boolean true Load description, condo/IPTU split, ZIP, coordinates and full captions
listingUrls array – Listing URLs or numeric IDs (mode=byUrls)
maxItems integer 500 Hard cap, 1–5,000

Example: rentals in São Paulo

{
  "mode": "rent",
  "city": "sao-paulo-sp-brasil",
  "maxItems": 200,
  "includeDetails": false
}

Example: family-sized apartments for sale in Rio de Janeiro

{
  "mode": "buy",
  "city": "rio-de-janeiro-rj-brasil",
  "propertyType": "APARTMENT",
  "bedroomsMin": 3,
  "priceMin": 800000,
  "priceMax": 2500000,
  "sortBy": "newest",
  "maxItems": 100
}

Example: pet-friendly rentals in Pinheiros with a pool

{
  "mode": "rent",
  "city": "sao-paulo-sp-brasil",
  "neighborhood": "Pinheiros",
  "acceptsPets": "yes",
  "installations": ["PISCINA"],
  "priceMax": 6000,
  "maxItems": 50
}

Example: load specific listings

{
  "mode": "byUrls",
  "listingUrls": [
    "https://www.quintoandar.com.br/imovel/893977588",
    "895686771"
  ]
}

Use cases

  • Rental budgeting — compare base rent, condo fee, IPTU and total monthly cost across neighborhoods
  • Relocation research — scan a new city or a single neighborhood before an apartment hunt
  • Market analysis — measure price per square metre by city, property type and size band
  • Investment screening — compare sale prices and published rental yields for similar properties
  • Portfolio monitoring — re-run the same city and filters to spot new listings and price changes
  • Project tracking — follow new developments with construction status and delivery forecasts

FAQ

Is this actor affiliated with QuintoAndar?

No. It is an independent, third-party tool that reads publicly visible QuintoAndar listings. It is not operated by or affiliated with QuintoAndar.

Do I need a QuintoAndar account, cookies or a proxy?

No. All supported modes work without an account or cookies, and no proxy setup is required.

What is the difference between rentPrice, totalMonthlyCost and condoAndIptu?

rentPrice is the base rent. condoAndIptu is the combined condo fee and IPTU. totalMonthlyCost adds those extras to the rent, matching the total QuintoAndar displays for rent listings.

Why does a rental listing sometimes have a salePrice?

Some owners list the same property for both rent and sale. When QuintoAndar publishes both prices, both fields are included.

How many listings can one run return?

A single location query yields at most 1,000 listings, which is QuintoAndar's own per-query limit. Runs above 1,000 automatically split the price range into slices and merge the results, up to maxItems (5,000). If the source has fewer matching listings, the run stops honestly with the real count.

Why do results include cities other than the one I selected?

QuintoAndar city searches cover the surrounding metro region, so a São Paulo search can include Mauá or Guarulhos. Set exactCityOnly to keep only the city you selected.

Why are suites, iptu, description or coordinates missing on some records?

Those fields are conditional in the source: some listings do not publish a suite count, IPTU value or description. They are omitted rather than filled with a placeholder. Turning on includeDetails fills them whenever the listing page has them.

Can I get the agent's name, phone or email?

No. QuintoAndar does not expose listing-agent contact details on public pages, so the actor cannot return them.

What do the amenity and facility codes mean?

They are QuintoAndar's own codes, such as VARANDA (balcony), AR_CONDICIONADO (air conditioning), PISCINA (pool) and ACADEMIA (gym). With includeDetails enabled, the actor also returns the Portuguese labels in amenitiesText and installationsText.

Limitations

  • 1,000 listings per location query. Larger requests are split by price, but a slice with more than 1,000 listings at the same price can still be capped.
  • Source inventory is finite. A run cannot return more listings than QuintoAndar currently has for the chosen location and filters.
  • City searches include metro municipalities. Use exactCityOnly when you need the city boundary only.
  • No agent or advertiser contact details. QuintoAndar does not publish them.
  • No total area or land area. QuintoAndar exposes usable area (areaSqM) only.
  • Some fields are conditional. Suites, IPTU, descriptions, construction year and project data appear only when the listing provides them.
  • Price-slice partitioning changes ordering. Runs above 1,000 are assembled from multiple price slices, so the final order differs from a single sorted page.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build zT1Qzg0VWyjBONG32. Documentation is regenerated from the default published build; private drafts are not included.