// docs

Zapimoveis -> Google -> Website -> Casa dos Dados

Parte de anuncios no Zapimoveis, consolida imobiliarias unicas, encontra o site oficial, coleta contatos e entrega um artifact com dados da empresa e CNPJ enriquecido.

Template ID

zapimoveis-google-website-cdd-imobiliaria-enrichment

Etapas

Formato final

JSON / CSV

Execução

Dashboard + API key

O que este workflow faz

Este workflow foi desenhado para construir uma base de imobiliarias a partir do Zapimoveis. A GeckoAPI pesquisa anuncios, deduplica agencias, tenta encontrar o site oficial via Google, extrai canais de contato do website e consolida o CNPJ com enrichment da Casa dos Dados.

Quando usar

Mapear imobiliarias por cidade e tipo de negocio no mercado residencial.
Montar listas outbound com telefone, email, site e sinais operacionais da agencia.
Cruzar inventario do Zapimoveis com contato oficial e dados cadastrais da empresa.

Como usar no dashboard

PASSO 1
No Dashboard, selecione o template de Zapimoveis para imobiliarias.
PASSO 2
Preencha cidade, UF, tipo de negocio, paginas e os filtros opcionais que quiser aplicar.
PASSO 3
Revise a estimativa maxima de creditos e o breakdown por etapa antes do run.
PASSO 4
Monitore a coleta no Zapimoveis, a busca do site oficial, a leitura do website e o enrichment empresarial.
PASSO 5
Ao final, baixe o artifact em JSON ou CSV para consumir cada item como uma imobiliaria enriquecida.

Etapas do workflow

Zapimoveis Busca

zap_search

Pesquisa anuncios no Zapimoveis usando cidade, estado, tipo de negocio e filtros adicionais.

Zapimoveis Imobiliaria

zap_listing

Consolida os dados da agencia a partir dos anuncios e deduplica imobiliarias repetidas.

Google Search

google_search

Procura o site oficial mais provavel para cada imobiliaria deduplicada.

Website Contact

website_contact

Extrai telefones, emails, WhatsApp, redes sociais e paginas de contato do site selecionado.

Casa dos Dados

casa_dos_dados

Enriquece o CNPJ identificado com os dados empresariais estruturados.

Campos de input

Estes são os campos usados no dashboard e no body do POST /v1/workflows/runs.

Campo	Tipo	Obrigatório	Como usar	Exemplo
Keyword keyword	text	Não	Termo opcional para restringir ainda mais a busca no Zapimoveis. Pode ficar em branco quando cidade, estado e filtros ja forem suficientes.	alto padrao
Cidade city	text	Sim	Cidade alvo usada na pesquisa principal do Zapimoveis.	Rio de Janeiro
UF state	text	Sim	Sigla da unidade federativa usada na busca. Use a UF com duas letras.	RJ
Tipo de negocio businessType	text	Sim	Define se a busca sera orientada a venda ou aluguel. Aceita sale, rent, venda ou aluguel.	sale
Paginas pages	number	Sim	Quantidade de paginas do Zapimoveis que o workflow deve percorrer.	2
Quartos bedrooms	number_list	Não	Filtro opcional de quartos. Informe numeros separados por virgula.	2,3,4
Banheiros bathrooms	number_list	Não	Filtro opcional de banheiros.	2,3
Vagas parkingSpots	number_list	Não	Filtro opcional de vagas de garagem.	1,2
Preco minimo priceMin	number	Não	Faixa minima de preco para filtrar os anuncios.	1000000
Preco maximo priceMax	number	Não	Faixa maxima de preco para filtrar os anuncios.	2500000
Area minima areaMin	number	Não	Area minima em metros quadrados.	80
Area maxima areaMax	number	Não	Area maxima em metros quadrados.	180
Formato final outputFormat	output_format	Sim	Formato do artifact final. CSV funciona bem para operacao e CRM. JSON preserva a estrutura completa da imobiliaria.	csv

Executar este template via API

O payload abaixo já usa este templateId e um body real compatível com o endpoint público. Depois da criação, acompanhe o run em GET /v1/workflows/runs/{runId}/status e, se necessário, cancele com POST /v1/workflows/runs/{runId}/cancel.

Ver guia completo da API de workflows

Criar workflow

curl -X POST https://api.geckoapi.com.br/v1/workflows/runs \
+  -H "Authorization: Bearer SUA_CHAVE" \
+  -H "Content-Type: application/json" \
+  -d '{
  "templateId": "zapimoveis-google-website-cdd-imobiliaria-enrichment",
  "input": {
    "city": "Rio de Janeiro",
    "state": "RJ",
    "businessType": "sale",
    "pages": 2,
    "outputFormat": "csv"
  }
}'

Cancelar um workflow faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.

O que você recebe no arquivo final

Cada run gera um artifact centrado na imobiliaria, com dados vindos do Zapimoveis, website oficial, identificacao de CNPJ e enrichment empresarial da Casa dos Dados.

Perfil consolidado da imobiliaria com sinais do Zapimoveis.

Contato e canais digitais extraidos do website oficial.

CNPJ identificado, candidatos e enrichment empresarial da Casa dos Dados.

Artifact pronto para uso em prospeccao, CRM e inteligencia imobiliaria.

Envelope do artifact

O arquivo final sempre carrega metadados do run, o input original, a estimativa usada na criação e o resumo operacional da execução.

artifact.json

{
  "runId": "run_zap_123",
  "correlationId": "corr_zap_123",
  "templateId": "zapimoveis-google-website-cdd-imobiliaria-enrichment",
  "outputFormat": "json",
  "generatedAt": "2026-03-23T12:00:00.000Z",
  "input": {
    "city": "Rio de Janeiro",
    "state": "RJ",
    "businessType": "sale",
    "pages": 2,
    "outputFormat": "json"
  },
  "estimate": {
    "maxCredits": 2450,
    "breakdown": [],
    "caps": []
  },
  "summary": {
    "status": "completed",
    "completedTasks": 31,
    "failedTasks": 1,
    "discoveredStores": 18,
    "uniqueStores": 8
  },
  "items": [
    {
      "agency": {
        "itemId": "imobiliaria#royal",
        "name": "Royal Imoveis RJ",
        "advertiserId": "655356",
        "profilePageId": "655356",
        "imobiUrl": "https://www.zapimoveis.com.br/imobiliaria/655356/",
        "zapListingUrls": [
          "https://www.zapimoveis.com.br/imovel/teste-1/"
        ],
        "phones": [
          "552133334444"
        ],
        "whatsAppNumber": "5521999998888",
        "creci": "12345",
        "createdDate": "2019-01-01",
        "listingsCount": 120,
        "filteredListingsCount": 10,
        "tier": "standard",
        "isVerified": true,
        "hasVirtualAssistant": false,
        "hasOfficialStore": true,
        "description": "Imobiliaria na Barra",
        "address": {
          "formattedAddress": "Estrada dos Tres Rios, 1097 - Rio de Janeiro, RJ"
        },
        "rating": {
          "score": 4.8,
          "totalRatings": 10,
          "totalFeedbacks": 8,
          "isVisible": true
        },
        "social": {
          "facebook": "https://www.facebook.com/royalimoveisrj",
          "instagram": "https://www.instagram.com/royalimoveisrj/"
        },
        "stamps": [
          "super-destaque"
        ]
      },
      "website": {
        "status": "completed",
        "selectedUrl": "https://www.royalimoveisrj.com.br/",
        "canonicalUrl": "https://www.royalimoveisrj.com.br/",
        "domain": "royalimoveisrj.com.br",
        "title": "Royal Imoveis RJ",
        "description": "Atendimento completo",
        "phones": [
          "552133334444"
        ],
        "emails": [
          "contato@royalimoveisrj.com.br"
        ],
        "whatsAppNumbers": [
          "5521999998888"
        ],
        "facebookUrls": [
          "https://www.facebook.com/royalimoveisrj"
        ],
        "instagramUrls": [
          "https://www.instagram.com/royalimoveisrj/"
        ],
        "addressSnippets": [
          "Estrada dos Tres Rios, 1097 - Rio de Janeiro - RJ"
        ],
        "contactPageUrls": [
          "https://www.royalimoveisrj.com.br/contato"
        ]
      },
      "cnpj": {
        "status": "identified",
        "value": "12345678000199",
        "candidates": [
          "12345678000199"
        ]
      },
      "casaDosDados": {
        "status": "completed",
        "extractedAt": "2026-03-23T12:05:00.000Z",
        "data": {
          "razao_social": "ROYAL IMOVEIS RJ LTDA",
          "contato_email": [
            {
              "email": "contato@royalimoveisrj.com.br"
            }
          ],
          "contato_telefonico": [
            {
              "completo": "21-33334444"
            }
          ],
          "endereco": {
            "municipio": "Rio de Janeiro",
            "uf": "RJ"
          }
        }
      },
      "enrichment": {
        "googleSearchQuery": "Royal Imoveis RJ Rio de Janeiro",
        "googleSearchStatus": "completed",
        "googleSelectedUrl": "https://www.royalimoveisrj.com.br/",
        "googleSelectedDomain": "royalimoveisrj.com.br",
        "googleSelectedTitle": "Royal Imoveis RJ",
        "lastError": null
      },
      "workflow": {
        "runId": "run_zap_123",
        "templateId": "zapimoveis-google-website-cdd-imobiliaria-enrichment",
        "outputFormat": "json"
      }
    }
  ]
}

Path	Tipo	Descrição	Exemplo
correlationId	string	Correlacao interna da execucao.	corr_zap_123
estimate.maxCredits	number	Estimativa maxima de creditos reservada para o run.	2450
generatedAt	ISO-8601 string	Momento em que o arquivo final foi consolidado.	2026-03-23T12:00:00.000Z
input.businessType	string	Tipo de negocio usado no filtro principal.	sale
input.city	string	Cidade pesquisada no Zapimoveis.	Rio de Janeiro
input.outputFormat	"json" \| "csv"	Formato solicitado na criacao do run.	json
input.pages	number	Quantidade de paginas pesquisadas no Zapimoveis.	2
input.state	string	UF pesquisada no Zapimoveis.	RJ
items[]	WorkflowImobiliariaExportItem	Lista final de imobiliarias enriquecidas.	{"agency":{"itemId":"imobiliaria#royal","name":"Royal Imoveis RJ","advertiserId":"655356","profilePageId":"655356","imobiUrl":"https://www.zapimoveis.com.br/imobiliaria/655356/","zapListingUrls":["https://www.zapimoveis.com.br/imovel/teste-1/"],"phones":["552133334444"],"whatsAppNumber":"5521999998888","creci":"12345","createdDate":"2019-01-01","listingsCount":120,"filteredListingsCount":10,"tier":"standard","isVerified":true,"hasVirtualAssistant":false,"hasOfficialStore":true,"description":"Imobiliaria na Barra","address":{"formattedAddress":"Estrada dos Tres Rios, 1097 - Rio de Janeiro, RJ"},"rating":{"score":4.8,"totalRatings":10,"totalFeedbacks":8,"isVisible":true},"social":{"facebook":"https://www.facebook.com/royalimoveisrj","instagram":"https://www.instagram.com/royalimoveisrj/"},"stamps":["super-destaque"]},"website":{"status":"completed","selectedUrl":"https://www.royalimoveisrj.com.br/","canonicalUrl":"https://www.royalimoveisrj.com.br/","domain":"royalimoveisrj.com.br","title":"Royal Imoveis RJ","description":"Atendimento completo","phones":["552133334444"],"emails":["contato@royalimoveisrj.com.br"],"whatsAppNumbers":["5521999998888"],"facebookUrls":["https://www.facebook.com/royalimoveisrj"],"instagramUrls":["https://www.instagram.com/royalimoveisrj/"],"addressSnippets":["Estrada dos Tres Rios, 1097 - Rio de Janeiro - RJ"],"contactPageUrls":["https://www.royalimoveisrj.com.br/contato"]},"cnpj":{"status":"identified","value":"12345678000199","candidates":["12345678000199"]},"casaDosDados":{"status":"completed","extractedAt":"2026-03-23T12:05:00.000Z","data":{"razao_social":"ROYAL IMOVEIS RJ LTDA","contato_email":[{"email":"contato@royalimoveisrj.com.br"}],"contato_telefonico":[{"completo":"21-33334444"}],"endereco":{"municipio":"Rio de Janeiro","uf":"RJ"}}},"enrichment":{"googleSearchQuery":"Royal Imoveis RJ Rio de Janeiro","googleSearchStatus":"completed","googleSelectedUrl":"https://www.royalimoveisrj.com.br/","googleSelectedDomain":"royalimoveisrj.com.br","googleSelectedTitle":"Royal Imoveis RJ","lastError":null},"workflow":{"runId":"run_zap_123","templateId":"zapimoveis-google-website-cdd-imobiliaria-enrichment","outputFormat":"json"}}
outputFormat	"json" \| "csv"	Formato final escolhido pelo usuario.	json
runId	string	Identificador unico do run no dashboard.	run_zap_123
summary.completedTasks	number	Total de tarefas concluídas com sucesso.	31
summary.discoveredStores	number	Quantidade de registros vistos antes da consolidacao.	18
summary.failedTasks	number	Total de tarefas que falharam.	1
summary.status	WorkflowRunStatus	Status final do workflow.	completed
summary.uniqueStores	number	Quantidade de imobiliarias finais exportadas.	8
templateId	string	Template usado para gerar o artifact.	zapimoveis-google-website-cdd-imobiliaria-enrichment

Estrutura de cada item

Cada item representa uma imobiliaria unica enriquecida. O artifact consolida os sinais do Zapimoveis, o website oficial, os contatos capturados e o bloco empresarial no mesmo registro.

item.json

{
  "agency": {
    "itemId": "imobiliaria#royal",
    "name": "Royal Imoveis RJ",
    "advertiserId": "655356",
    "profilePageId": "655356",
    "imobiUrl": "https://www.zapimoveis.com.br/imobiliaria/655356/",
    "zapListingUrls": [
      "https://www.zapimoveis.com.br/imovel/teste-1/"
    ],
    "phones": [
      "552133334444"
    ],
    "whatsAppNumber": "5521999998888",
    "creci": "12345",
    "listingsCount": 120,
    "filteredListingsCount": 10,
    "address": {
      "formattedAddress": "Estrada dos Tres Rios, 1097 - Rio de Janeiro, RJ"
    },
    "rating": {
      "score": 4.8
    }
  },
  "website": {
    "status": "completed",
    "selectedUrl": "https://www.royalimoveisrj.com.br/",
    "domain": "royalimoveisrj.com.br",
    "phones": [
      "552133334444"
    ],
    "emails": [
      "contato@royalimoveisrj.com.br"
    ]
  },
  "cnpj": {
    "status": "identified",
    "value": "12345678000199",
    "candidates": [
      "12345678000199"
    ]
  },
  "casaDosDados": {
    "status": "completed",
    "extractedAt": "2026-03-23T12:05:00.000Z",
    "data": {
      "razao_social": "ROYAL IMOVEIS RJ LTDA",
      "endereco": {
        "municipio": "Rio de Janeiro",
        "uf": "RJ"
      }
    }
  },
  "enrichment": {
    "googleSearchQuery": "Royal Imoveis RJ Rio de Janeiro",
    "googleSelectedUrl": "https://www.royalimoveisrj.com.br/",
    "lastError": null
  },
  "workflow": {
    "runId": "run_zap_123",
    "templateId": "zapimoveis-google-website-cdd-imobiliaria-enrichment",
    "outputFormat": "json"
  }
}

Path	Tipo	Descrição	Exemplo
agency.address.formattedAddress	string \| null	Endereco consolidado da imobiliaria.	Estrada dos Tres Rios, 1097 - Rio de Janeiro, RJ
agency.advertiserId	string \| null	Advertiser ID observado no Zapimoveis.	655356
agency.creci	string \| null	CRECI visivel da imobiliaria.	12345
agency.filteredListingsCount	number \| null	Quantidade de anuncios efetivamente considerados pelos filtros do run.	10
agency.imobiUrl	string \| null	URL da pagina da imobiliaria no Zapimoveis.	https://www.zapimoveis.com.br/imobiliaria/655356/
agency.itemId	string	Identificador unico da imobiliaria no artifact.	imobiliaria#royal
agency.listingsCount	number \| null	Quantidade total de anuncios visivel na pagina da imobiliaria.	120
agency.name	string \| null	Nome da imobiliaria consolidada.	Royal Imoveis RJ
agency.phones[]	string	Telefones vistos no Zapimoveis.	552133334444
agency.profilePageId	string \| null	Profile page ID da imobiliaria no Zapimoveis.	655356
agency.rating.score	number \| null	Nota visivel na pagina da imobiliaria.	4.8
agency.whatsAppNumber	string \| null	WhatsApp observado no Zapimoveis.	5521999998888
agency.zapListingUrls[]	string	URLs de anuncios que ajudaram a compor este item.	https://www.zapimoveis.com.br/imovel/teste-1/
casaDosDados.data.endereco.municipio	string \| null	Municipio principal da empresa.	Rio de Janeiro
casaDosDados.data.endereco.uf	string \| null	UF principal da empresa.	RJ
casaDosDados.data.razao_social	string \| null	Razao social retornada pela Casa dos Dados.	ROYAL IMOVEIS RJ LTDA
casaDosDados.status	"pending" \| "completed" \| "failed" \| "skipped"	Resultado da etapa de enrichment empresarial.	completed
cnpj.status	"pending" \| "identified" \| "ambiguous" \| "not_found"	Status da identificacao do CNPJ.	identified
cnpj.value	string \| null	CNPJ final identificado quando encontrado.	12345678000199
enrichment.googleSearchQuery	string \| null	Consulta usada para encontrar o site oficial.	Royal Imoveis RJ Rio de Janeiro
enrichment.googleSelectedUrl	string \| null	URL escolhida como melhor candidato de site oficial.	https://www.royalimoveisrj.com.br/
enrichment.lastError	string \| null	Ultimo erro de enrichment quando alguma etapa falha.	null
website.domain	string \| null	Dominio principal do site selecionado.	royalimoveisrj.com.br
website.emails[]	string	Emails encontrados no website.	contato@royalimoveisrj.com.br
website.phones[]	string	Telefones encontrados no website.	552133334444
website.selectedUrl	string \| null	URL selecionada como site oficial.	https://www.royalimoveisrj.com.br/
website.status	"pending" \| "completed" \| "failed" \| "skipped"	Resultado da etapa de website contact.	completed
workflow.templateId	string	Template responsavel por gerar este item.	zapimoveis-google-website-cdd-imobiliaria-enrichment

Observações importantes

Os filtros opcionais afetam a cobertura do Zapimoveis e, portanto, a base final de imobiliarias.
JSON preserva o contexto completo do enrichment; CSV prioriza colunas praticas para operacao comercial.

Grátis para sempre

Rodar este workflow no dashboard?

Use o template no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o artifact final.

Abrir dashboard Ver exemplos de uso