$0.80/1K 💰 QuintoAndar Scraper Brazil

Extraia dados estruturados e completos de anúncios de imóveis do QuintoAndar: preço, preço por m², condomínio, IPTU, endereço, coordenadas, pontos de interesse próximos, comodidades, fotos e vídeos (quando o anúncio tiver). Basta informar estado, tipo de transação (aluguel ou venda) e filtros opcionais (cidade, bairro, tipo de imóvel, preço, quartos, banheiros, área), sem precisar copiar campo por campo manualmente.

O que é o QuintoAndar Scraper Brazil?

O QuintoAndar Scraper Brazil transforma imóveis do QuintoAndar em dados estruturados prontos para análise: 49 campos por imóvel, incluindo preço de aluguel e de venda em campos separados (com preço por m² já calculado), condomínio, IPTU, taxa de serviço, garantia de aluguel, proteção residencial e custo mensal total, endereço completo com coordenadas, disponibilidade para aluguel e/ou venda, área, quartos, banheiros, suítes e vagas, escolas, hospitais, estações e parques próximos, comodidades do prédio e da unidade, status do anúncio e de visitas, data de publicação (primeira e última), fotos com legenda e vídeos (quando o anúncio tiver e a extração de vídeos estiver ativada).

Você informa Estado e Tipo de transação (os dois obrigatórios) e, opcionalmente, Cidade, Bairro e filtros de tipo de imóvel/preço/quartos/banheiros/área; o actor descobre os imóveis sozinho a partir daí. É útil para corretoras, analistas de dados e investidores que precisam comparar dezenas ou centenas de imóveis sem copiar cada anúncio manualmente, um processo lento e sujeito a erro humano.

O que o QuintoAndar Scraper Brazil extrai?

Campo	Descrição
sourceId	ID do imóvel no QuintoAndar
url, extractedAt	URL de origem e momento da extração (ISO 8601)
businessContext	RENT ou SALE. Olhe rentPrice/salePrice para saber qual preço realmente se aplica (um dos dois vem null)
listingStatus	Status do anúncio no QuintoAndar (ex.: "publicado")
visitStatus	Status de agendamento de visitas ao imóvel
propertyType	Tipo do imóvel (Apartamento, Casa…)
title	Descrição escrita pelo anunciante (pode vir vazia, nem todo anúncio tem)
neighborhood, city, state, street, zipCode	Endereço completo
macroRegion	Código interno de macro-região do QuintoAndar (ex.: "SPO 04"), diferente do bairro; ver "Limitações conhecidas"
latitude, longitude	Coordenadas geográficas
rentPrice	Aluguel mensal (R$); null se o imóvel não está para alugar
salePrice	Preço de venda (R$); null se o imóvel não está à venda
forRent, forSale	Se o imóvel está disponível para aluguel e/ou venda (um mesmo imóvel pode ter os dois true ao mesmo tempo, em dupla listagem)
condoFee, condoType	Condomínio (R$) e seu tipo (ex.: "Normal", "IncluidoNoAluguel" quando o condomínio já vem embutido no aluguel). 0 em condoFee é valor real: casa sem condomínio
iptu, iptuType	IPTU (R$) e seu tipo (ex.: "Normal", "NaoExiste"). 0 é valor real: imóvel isento
serviceFee, homeProtectionFee	Taxa de serviço QuintoAndar e proteção residencial (R$/mês); junto com rentPrice/condoFee/iptu, somam exatamente totalMonthlyCost
rentalGuaranteeMin, rentalGuaranteeMax	Faixa de valor da garantia de aluguel exigida (R$); null quando o anúncio não informa garantia
totalMonthlyCost	Custo mensal total (R$)
pricePerSqm	Preço por m² (R$), aluguel ou venda conforme businessContext. null se faltar preço ou área
area	Área útil (m²)
bedrooms, bathrooms, suites, parkingSpaces	Quartos, banheiros, suítes e vagas
nearSubway	Se o imóvel é próximo ao metrô
floorNumber, floorNumberMax, constructionYear	Andar (e andar máximo, em prédios com faixa) e ano de construção
furnished, petFriendly	Mobiliado / aceita pets
buildingAmenities, unitAmenities	Comodidades do condomínio e da unidade
specialConditions	Condições especiais do anúncio (ex.: exclusividade); lista vazia quando não há nenhuma
placesNearby	Pontos de interesse próximos (escolas, hospitais, estações de metrô/trem, terminais de ônibus, parques, universidades, aeroportos), cada um com name e type
firstPublishedDate, lastPublishedDate	Data/hora (ISO 8601) da primeira publicação e da última publicação/atualização do anúncio no QuintoAndar
photos	Fotos do anúncio: lista de objetos {url, caption} (caption vem vazio quando a foto não tem legenda)
videos	URLs de vídeo do anúncio (lista, pode ter mais de um). Vazia por padrão: a extração de vídeo é opcional, veja o campo "Extrair vídeos" no input
error	Só presente quando a extração falha (imóvel saiu do ar, mudou de estrutura ou a navegação falhou); o item não é cobrado. Veja a FAQ

Como usar o QuintoAndar Scraper Brazil

O input é só Estado + Tipo de transação + filtros opcionais, sem precisar montar ou colar URL nenhuma na mão:

1. Preencha Estado (obrigatório, ex.: "SP"). Sozinho, ele já busca o ESTADO INTEIRO, mas repare que o campo Cidade vem pré-preenchido com "São Paulo" no Console; apague-o se você realmente quiser o estado inteiro, não só a cidade sugerida.
2. Escolha Tipo de transação (obrigatório: Aluguel ou Venda). Sem esse campo a busca fica ambígua entre os dois tipos de anúncio, por isso não tem valor padrão: você precisa escolher.
3. (Opcional) Preencha Cidade (ex.: "São Paulo") pra restringir a uma cidade, e Bairro (ex.: "Vila Madalena") pra restringir ainda mais.
4. (Opcional) Ajuste Tipo de imóvel, Preço mínimo/máximo, Mínimo de quartos/banheiros, Área mínima, Aceita pets e Perto de metrô conforme o que você procura.
5. (Opcional) defina Máximo de imóveis para limitar quantos processar no run.
6. (Opcional) ative Extrair vídeos se precisar do campo videos preenchido. Desligado por padrão, deixando o run mais rápido para quem não precisa desse dado.
7. Clique em Start e acompanhe o dataset sendo preenchido incrementalmente: cada imóvel é salvo assim que extraído, sem esperar o run inteiro terminar.
8. Exporte o resultado em JSON, CSV, Excel ou conecte via API (as opções padrão do Apify Dataset).

Veja "Limitações conhecidas" abaixo para entender a cobertura da busca.

Quanto custa usar o QuintoAndar Scraper Brazil?

Este actor usa Pay Per Event: você paga só pelo que recebe, sem cobrança por iniciar o run.

• Item extraído (item-extracted): $ 0.0008 por imóvel extraído com sucesso.

Exemplo: extrair 1.000 imóveis custa aproximadamente $ 0.80. Imóveis que falham na extração (ver campo error na tabela acima) não são cobrados.

Input e output

Veja .actor/input_schema.json. Exemplo mínimo (Estado e Tipo de transação são os únicos campos obrigatórios; aqui, o estado inteiro à venda):

{
    "state": "SP",
    "transactionType": "sale"
}

Este JSON exato busca o ESTADO INTEIRO, sem restringir a nenhuma cidade (vale pra quem edita o input em modo JSON no Console ou chama a API direto; no formulário visual, lembre de apagar o "São Paulo" pré-preenchido em Cidade, ver passo 1 acima).

Exemplo: cidade inteira, sem outros filtros:

{
    "state": "SP",
    "city": "São Paulo",
    "transactionType": "sale",
    "maxListings": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

Exemplo: bairro específico, com filtros de tipo/preço/quartos:

{
    "state": "SP",
    "city": "São Paulo",
    "region": "Vila Madalena",
    "transactionType": "rent",
    "propertyType": "apartamento",
    "priceMin": 1500,
    "priceMax": 4000,
    "bedroomsMin": 2,
    "maxListings": 50
}

Exemplo: todos os filtros combinados (venda, com banheiros e área):

{
    "state": "RJ",
    "city": "Rio de Janeiro",
    "region": "Copacabana",
    "transactionType": "sale",
    "propertyType": "apartamento",
    "priceMin": 300000,
    "priceMax": 900000,
    "bedroomsMin": 2,
    "bathroomsMin": 2,
    "areaMin": 60,
    "acceptPets": "yes",
    "closeToSubway": "yes",
    "maxListings": 50
}

Exemplo de item de output: saída real de um anúncio anunciado ao mesmo tempo para aluguel e venda (por isso rentPrice e salePrice vêm os dois preenchidos), com constructionYear em null porque o anúncio não informa e title vazio porque o anunciante não escreveu descrição:

{
    "url": "https://www.quintoandar.com.br/imovel/894543580",
    "extractedAt": "2026-08-19T01:08:45.216750+00:00",
    "sourceId": "894543580",
    "businessContext": "RENT",
    "listingStatus": "publicado",
    "visitStatus": "ACCEPT_NEW",
    "propertyType": "Apartamento",
    "title": "",
    "neighborhood": "Consolação",
    "macroRegion": "SPO 04",
    "city": "São Paulo",
    "state": "SP",
    "street": "Rua Luís Coelho",
    "zipCode": "01309-001",
    "latitude": -23.5569581,
    "longitude": -46.6589677,
    "rentPrice": 1700.0,
    "salePrice": 500000.0,
    "forRent": true,
    "forSale": true,
    "condoFee": 1783.0,
    "condoType": "Normal",
    "iptu": 398.0,
    "iptuType": "Normal",
    "serviceFee": 44.0,
    "homeProtectionFee": 22.0,
    "rentalGuaranteeMin": null,
    "rentalGuaranteeMax": null,
    "totalMonthlyCost": 3947.0,
    "pricePerSqm": 29.31,
    "area": 58.0,
    "bedrooms": 1,
    "bathrooms": 1,
    "suites": 0,
    "parkingSpaces": 0,
    "nearSubway": true,
    "floorNumber": 0,
    "floorNumberMax": null,
    "constructionYear": null,
    "furnished": true,
    "petFriendly": true,
    "buildingAmenities": [
        "Piscina",
        "Academia",
        "Lavanderia no prédio"
    ],
    "unitAmenities": [
        "Banheira",
        "Janelas grandes",
        "Armários no quarto"
    ],
    "specialConditions": [],
    "placesNearby": [
        {"name": "Consolação", "type": "ESTACAO_METRO_OU_TREM"},
        {"name": "Colégio São Luís", "type": "SCHOOL"},
        {"name": "Praça Roosevelt", "type": "PARK_OR_GREEN_AREA"}
    ],
    "firstPublishedDate": "2026-01-10T12:00:00.000Z",
    "lastPublishedDate": "2026-08-15T09:22:10.000Z",
    "photos": [
        {"url": "https://www.quintoandar.com.br/img/med/894543580-01.jpg", "caption": "Sala de Estar"}
    ],
    "videos": []
}

Por padrão, a extração de vídeo fica desligada, o que deixa o run mais rápido para quem não precisa desse dado. Ative Extrair vídeos no input se quiser o campo videos preenchido; quando ativado e o anúncio tiver vídeo, o campo vem com uma ou mais URLs de player prontas para tocar, por exemplo:

"videos": ["https://player.vimeo.com/video/1219720102?h=c88ccb75a5"]

Limitações conhecidas

O input não aceita URL nenhuma diretamente (nem de imóvel específico, nem de busca já filtrada no site). Todo run monta uma única URL de busca a partir de Estado/Cidade/Bairro/filtros. Isso simplifica o input, mas tem uma consequência prática: não dá pra combinar várias URLs de busca (bairros e/ou faixas de preço diferentes) no mesmo run; cada run tem exatamente uma busca. Pra cobrir vários bairros de uma cidade grande, rode o actor mais de uma vez (uma vez por bairro/faixa de interesse) em vez de num run só.

A busca cobre a primeira leva de resultados renderizada pelo QuintoAndar (tipicamente 20-26 imóveis) mais o que o botão "Ver mais" da página conseguir trazer, até Máximo de imóveis ou um teto de segurança quando esse campo é deixado em branco — nunca o total disponível de uma vez, que numa busca ampla (um estado ou cidade inteiros, sem filtro) costuma passar de dezenas de milhares. Quanto mais específicos os filtros, menor o total da busca e maior a fração dele que dá pra cobrir; Bairro é a alavanca mais forte pra isso.

Os filtros de tipo/preço/quartos/banheiros/área são embutidos diretamente na URL de busca: o QuintoAndar filtra de verdade no servidor, então o actor não perde tempo extraindo imóveis que já sabia que não bateriam. Eles também são reaplicados depois da extração como rede de segurança. A exceção é Bairro: só é embutido na URL quando Cidade também é informada; sem cidade, vira só um pós-filtro aproximado sobre o bairro já extraído de cada imóvel (correspondência normalizada, sem acento/case). Com Cidade preenchida, o pós-filtro de bairro é ignorado, já que a busca no servidor já cobre isso. Aceita pets e Perto de metrô funcionam só como pós-filtro (não são embutidos na URL de busca), comparando com os campos petFriendly/nearSubway já extraídos de cada imóvel.

Pular imóveis já extraídos antes (campo opcional): ative para runs recorrentes (ex.: um agendamento diário). O actor lembra, por até 30 dias, quais imóveis já extraiu e pula eles em runs futuros.

FAQ e suporte

Este actor é legal de usar? O uso dos dados extraídos está sujeito aos termos de serviço do QuintoAndar. Este actor extrai apenas informações já publicamente visíveis nas páginas de anúncio. Você é responsável por garantir que seu uso dos dados cumpre as leis e termos aplicáveis (por exemplo, LGPD, caso os dados sejam usados de forma que envolva informação pessoal identificável).

O que acontece se um imóvel não for encontrado? O item ainda é salvo no dataset, mas com o campo error preenchido em vez dos campos normais, e não é cobrado. "delisted" significa que o anúncio saiu do ar (o QuintoAndar redirecionou pra uma página de "indisponível"). "structure_changed" e "navigation_failed" só aparecem depois de o actor tentar de novo (com uma sessão de proxy nova) e continuar sem conseguir um resultado utilizável — na maioria das vezes é bloqueio temporário do alvo, não necessariamente uma mudança real na página. O actor continua processando o restante da lista normalmente.

O run terminou com 0 itens extraídos, o que houve? Se a descoberta encontrou imóveis mas nenhum foi extraído, o actor falha explicitamente em vez de reportar sucesso vazio: é sinal de bloqueio/timeout sistemático contra o alvo, não falta de resultado. Verifique a configuração de proxy e rode de novo.

Dá pra buscar por bairro, cidade inteira ou estado inteiro? Sim, os três (veja "Como usar" e "Limitações conhecidas" para a cobertura de cada busca).

Preciso de proxy residencial? Não, por padrão. O actor usa Apify Proxy datacenter. Se você notar bloqueios recorrentes, ative proxy residencial nas configurações de input (custa mais).

Contato e suporte

Encontrou um bug ou tem uma sugestão? Abra uma issue ou entre em contato através da página do actor no Apify Console. Runs com erro geram log detalhado; inclua o Run ID ao reportar um problema.

Aviso legal

Este actor é uma ferramenta independente, sem afiliação, endosso ou patrocínio do QuintoAndar ou suas afiliadas. Todas as marcas pertencem aos seus respectivos donos.