Scraper de Imoveis OLX Brasil

Actor da Apify para extrair anuncios de imoveis da OLX Brasil em formato estruturado, com filtros em portugues e saida pronta para analise.

O que este scraper entrega

• Coleta anuncios de imoveis no olx.com.br/imoveis
• Funciona com urlsIniciais (maior precisao) ou filtros estruturados
• Oferece modos rapido e profundo
• Aplica correspondencia de filtros com controle de precisao (correspondenciaEstrita)
• Retorna dataset com campos em portugues e valores normalizados

Quando usar este scraper

• Monitoramento de preco por tipo de imovel e regiao
• Pesquisa de mercado imobiliario
• Geração de base para BI, dashboards e modelos de previsao
• Acompanhamento de oportunidades (aluguel, venda, temporada)

Como os modos funcionam

Modo	Como funciona	Melhor uso
rapido	Le somente os cartoes da busca, sem abrir cada anuncio	Coletas maiores com menor custo e menor tempo
profundo	Visita cada anuncio para enriquecer campos	Quando voce precisa de mais detalhes por imovel

Precisao de filtros e semantica de maxItens

O comportamento de filtros depende de correspondenciaEstrita:

• correspondenciaEstrita=true (padrao):

  • o actor conta apenas itens que realmente atendem aos filtros finais;
  • maxItens significa "quantidade de itens validos no output";
  • pode precisar paginar mais e aumentar tempo/custo.

• correspondenciaEstrita=false:

  • prioriza velocidade;
  • reduz validacoes finais;
  • pode incluir itens que nao atendem totalmente alguns filtros.

Exemplo de entrada

Com urlsIniciais (recomendado para alvo preciso)

{
  "urlsIniciais": [
    { "url": "https://www.olx.com.br/imoveis/aluguel/estado-sp/sao-paulo/apartamentos" }
  ],
  "modo": "profundo",
  "maxPaginas": 10,
  "maxItens": 100,
  "incluirDescricao": true,
  "incluirFotos": true,
  "usarProxiesResidenciais": true
}

Com filtros estruturados

{
  "estado": "SP",
  "cidade": "Valinhos",
  "tipoNegocio": "aluguel",
  "tipoImovel": "apartamentos",
  "precoMin": 300000,
  "precoMax": 800000,
  "quartosMin": 2,
  "maxPaginas": 20,
  "maxItens": 200,
  "correspondenciaEstrita": true
}

Campos de entrada

Campo	Tipo	Padrao	Descricao
urlsIniciais	array	-	URLs da OLX para inicio da coleta. Se informado, filtros estruturados sao ignorados.
estado	string	-	UF (SP, RJ, MG...).
cidade	string	-	Cidade usada na busca textual (q) quando urlsIniciais nao e informado.
termoBusca	string	-	Termo textual para q com prioridade sobre composicao automatica.
tipoNegocio	string	-	venda, aluguel, temporada, lancamento.
tipoImovel	string	-	apartamentos, casas, terrenos, comercial, rural, temporada.
precoMin	integer	-	Preco minimo em BRL.
precoMax	integer	-	Preco maximo em BRL.
quartosMin	integer	-	Numero minimo de quartos.
quartosMax	integer	-	Numero maximo de quartos.
banheirosMin	integer	-	Minimo de banheiros (filtro final).
banheirosMax	integer	-	Maximo de banheiros (filtro final).
vagasMin	integer	-	Minimo de vagas (filtro final).
vagasMax	integer	-	Maximo de vagas (filtro final).
areaMin	integer	-	Area minima em m2 (filtro final).
areaMax	integer	-	Area maxima em m2 (filtro final).
maxPaginas	integer	50	Maximo de paginas de busca por URL inicial.
maxItens	integer	500	Maximo de itens validos retornados.
modo	string	profundo	rapido ou profundo.
coletarDetalhesAnuncio	boolean	true	Visita a pagina do anuncio para enriquecer dados.
incluirDescricao	boolean	true	Inclui descricao completa quando disponivel.
incluirFotos	boolean	true	Inclui URLs de fotos.
incluirDadosAnunciante	boolean	true	Inclui dados de anunciante quando disponivel.
correspondenciaEstrita	boolean	true	Conta/retorna apenas itens que batem nos filtros finais.
configuracaoProxy	object	-	Configuracao de proxy da Apify.
usarProxiesResidenciais	boolean	false	Usa proxy residencial Brasil.
concorrenciaMaxima	integer	3	Requisicoes paralelas.
timeoutRequisicaoSegundos	integer	60	Timeout por pagina em segundos.
depurar	boolean	false	Logs detalhados para diagnostico.

Exemplo de saida

{
  "idAnuncio": "1491939251",
  "url": "https://sp.olx.com.br/...",
  "urlCanonica": "https://sp.olx.com.br/...",
  "titulo": "Casa com 3 dormitorios para alugar",
  "tipoNegocio": "Aluguel",
  "tipoImovel": "Casas",
  "preco": "R$ 6.500",
  "precoValor": 6500,
  "moeda": "BRL",
  "cidade": null,
  "estado": null,
  "bairro": null,
  "endereco": null,
  "descricao": null,
  "quartos": 3,
  "banheiros": 3,
  "vagasGaragem": 2,
  "areaM2": 145,
  "valorCondominio": 0,
  "valorIptu": null,
  "mobiliado": null,
  "nomeAnunciante": null,
  "tipoAnunciante": null,
  "urlPerfilAnunciante": null,
  "anuncianteDesde": null,
  "publicadoEm": "2026-04-07T09:08:47.000Z",
  "atualizadoEm": null,
  "fotos": [],
  "atributos": {
    "Categoria": "Casas"
  },
  "fonte": "olx.com.br",
  "coletadoEm": "2026-04-07T09:22:34.685Z",
  "metadadosBusca": {
    "estado": "SP",
    "cidade": null,
    "bairro": null,
    "tipoNegocio": "aluguel"
  }
}

Qualidade dos dados

• Datas sao padronizadas em ISO 8601 quando disponiveis
• Preco em texto (preco) e valor numerico (precoValor)
• Campos ausentes no anuncio sao retornados como null
• atributos preserva informacoes adicionais da OLX sem perder contexto

Boas praticas de configuracao

• Use urlsIniciais para segmentacao geografica mais precisa
• Sem urlsIniciais, o actor monta busca textual (q) com tipoImovel + cidade + tipoNegocio
• Use usarProxiesResidenciais=true para reduzir bloqueios em carga alta
• Ajuste concorrenciaMaxima conforme estabilidade da coleta
• Aumente timeoutRequisicaoSegundos para redes mais lentas
• Em coletas muito especificas, aumente maxPaginas para atingir maxItens

Limitacoes conhecidas

• Algumas combinacoes de filtros dependem do comportamento da busca da OLX
• Busca por cidade via q pode incluir regioes proximas; para alvo exato use urlsIniciais
• Dados de anunciante podem estar ausentes em parte dos anuncios
• Mudancas de layout/dados da OLX podem afetar disponibilidade de campos

FAQ

Por que nao retornou maxItens?

Em geral isso ocorre por filtros muito restritivos, limite de paginas (maxPaginas) baixo ou baixa oferta no recorte consultado.

Quando devo usar urlsIniciais?

Sempre que quiser controle fino de regiao/caminho da busca na OLX.

correspondenciaEstrita vale a pena?

Sim para qualidade de dados e precisao. Desative apenas quando a prioridade for velocidade.

Por que alguns campos vem null?

Nem todo anuncio publica todos os dados (ex.: informacoes do anunciante, endereco ou IPTU).