Seu Imóvel BB API

Extraia imóveis do catálogo do site Seu Imóvel BB usando um Actor simples na Apify. Este Actor abre o catálogo, aplica os filtros disponíveis no painel lateral, percorre a paginação e salva os resultados no dataset padrão.

Recomendação de Proxy

Recomendamos usar Apify Proxy em execuções de produção.

Este Actor depende de abrir o site em um navegador real, interagir com o painel de filtros e navegar pelas páginas do catálogo. Sem proxy, a execução pode ficar menos estável, principalmente em coletas maiores, execuções repetidas ou quando o site começar a limitar ou bloquear requisições.

Configuração recomendada:

{
  "proxy": {
    "useApifyProxy": true
  }
}

Se você pretende rodar em escala, mantenha o proxy habilitado desde o início.

Entrada

O Actor aceita filtros simples do catálogo e limites de coleta.

Campos de entrada

Campo	Tipo	Descrição
uf	String	Filtra por um único estado. Exemplo: RS.
ufs	String	Lista de estados separada por vírgula. Exemplo: RS, SC, PR.
city	String	Filtra por uma única cidade exatamente como aparece no site.
cities	String	Lista de cidades separada por vírgula.
category	String	Tipo de imóvel. Exemplo: Casa, Apartamento, Residencial.
categories	String	Lista de tipos de imóvel separada por vírgula.
saleType	String	Tipo de venda. Exemplo: Venda direta, Leilão alienação fiduciária.
saleTypes	String	Lista de tipos de venda separada por vírgula.
minPrice	Integer	Preço mínimo em reais.
maxPrice	Integer	Preço máximo em reais.
cashOnly	Boolean	Marca a condição de pagamento À vista.
maxPages	Integer	Número máximo de páginas do catálogo a capturar. Padrão: 30.
waitAfterPaginationMs	Integer	Tempo de espera após aplicar filtros e trocar de página. Padrão: 1500.
proxy.useApifyProxy	Boolean	Ativa o Apify Proxy. Recomendado: true.
proxy.apifyProxyGroups	Array	Grupos opcionais do proxy da Apify.
proxy.apifyProxyCountry	String	País opcional para o proxy.

Exemplo de entrada

{
  "ufs": "RS, SC",
  "cities": "Porto Alegre, Caxias do Sul",
  "categories": "Casa, Apartamento",
  "saleTypes": "Venda direta",
  "minPrice": 100000,
  "maxPrice": 500000,
  "cashOnly": true,
  "maxPages": 20,
  "waitAfterPaginationMs": 1500,
  "proxy": {
    "useApifyProxy": true
  }
}

Observações sobre a entrada

• O painel do Actor expõe uf e ufs, mas a API do Actor também aceita os aliases state e states.
• Os filtros city, cities, category, categories, saleType e saleTypes são resolvidos pelos textos visíveis no site. Use os nomes como aparecem no catálogo.
• O filtro de cidade depende das opções carregadas pelo site. Quando possível, envie uf ou ufs junto com city ou cities.
• Se nenhum filtro for enviado, o Actor inicia com a listagem padrão do catálogo.

Saída

O Actor salva os resultados no dataset padrão. Durante a execução, você pode receber até quatro tipos de registro:

• item de imóvel
• registro de resumo
• registro de nenhum resultado
• registro de erro

1. Item de imóvel

Cada card do catálogo é salvo como um item no dataset. O Actor captura os principais campos visíveis do card e adiciona metadados com prefixo _.

Exemplo de saída:

{
  "propertyId": "7109",
  "detailUrl": "https://www.seuimovelbb.com.br/imovel/id/7109",
  "imageUrl": "https://www.seuimovelbb.com.br/imagem/imovel/7109_1.jpg",
  "category": "Casa",
  "badge": "Novidade",
  "location": "Mossoró - RN",
  "city": "Mossoró",
  "state": "RN",
  "price": "R$ 40.530,00",
  "priceLabel": "Valor para proposta",
  "offerText": null,
  "saleLabel": "Venda direta",
  "saleId": "97710",
  "saleDate": null,
  "partner": "Parceiro: Escritório de Leilões",
  "visibleText": [
    "Novidade",
    "Casa",
    "R$ 40.530,00",
    "Valor para proposta",
    "Mossoró - RN",
    "Venda direta - ID 97710",
    "Parceiro: Escritório de Leilões"
  ],
  "_page": 1,
  "_capturedAt": "2026-04-09T18:00:00.000Z",
  "_sourceUrl": "https://www.seuimovelbb.com.br/catalogo",
  "_totalPages": 30
}

Principais metadados adicionados pelo Actor:

Campo	Descrição
_page	Página do catálogo em que o item foi capturado.
_capturedAt	Data e hora da captura em formato ISO.
_sourceUrl	URL da página usada como origem da captura.
_totalPages	Total de páginas do catálogo identificado na execução.

2. Registro de resumo

Ao final da execução, o Actor grava um item de resumo para facilitar a validação do resultado.

Exemplo:

{
  "_summary": true,
  "_capturedAt": "2026-04-09T18:30:00.000Z",
  "_sourceUrl": "https://www.seuimovelbb.com.br/catalogo",
  "monetizationMode": "legacy",
  "monetizationEventName": "catalog-item",
  "uniquePagesCaptured": 12,
  "totalItemsCaptured": 384,
  "totalPagesFromCatalog": 12,
  "stopReason": "TOTAL_PAGES_REACHED"
}

3. Registro de nenhum resultado

Se o catálogo não retornar cards após aplicar os filtros selecionados, o Actor grava um registro indicando isso.

{
  "_notFound": true,
  "_capturedAt": "2026-04-09T18:05:00.000Z",
  "_sourceUrl": "https://www.seuimovelbb.com.br/catalogo",
  "_message": "No property cards were found in the catalog."
}

4. Registro de erro

Atualmente este Actor não grava um item de erro estruturado no dataset. Quando ocorre uma falha de navegação, paginação ou carregamento do site, o erro fica disponível nos logs da execução.

Quando a execução para

O Actor encerra a execução quando uma destas condições é atingida:

• todas as páginas disponíveis do catálogo foram capturadas
• o limite definido em maxPages foi atingido
• não foi possível avançar para a próxima página
• o catálogo retornou nenhum card para os filtros informados
• o limite de monetização por evento foi atingido na plataforma Apify
• o limite de itens pagos no dataset foi atingido

Boas práticas

• Ative proxy.useApifyProxy.
• Comece com um valor menor de maxPages para validar filtros novos.
• Ao usar city ou cities, envie também uf ou ufs para reduzir inconsistências do carregamento dinâmico do site.
• Verifique o registro final com _summary: true para confirmar quantas páginas e quantos itens foram capturados.

Links úteis

• Seu Imóvel BB
• Criscon - Empresa de tecnologia especializada em soluções de scraping e automação de dados.