Zapimoveis Busca
#1zap_search
Pesquisa anuncios no Zapimoveis usando cidade, estado, tipo de negocio e filtros adicionais.
// docs
Busque imobiliárias por cidade, encontre seus sites oficiais e receba contatos, dados da empresa e CNPJ enriquecido.
ID técnico
zapimoveis-google-website-cdd-imobiliaria-enrichment
Etapas
5
Formato final
JSON / CSV
Execução
Dashboard + API key
Esta busca constrói uma base de imobiliárias a partir do Zapimóveis. A GeckoAPI pesquisa anúncios, remove agências duplicadas, encontra o site oficial via Google, extrai canais de contato e consolida o CNPJ com dados da Casa dos Dados.
No Dashboard, selecione a busca de imobiliarias no Zapimoveis.
Preencha cidade, UF, tipo de negocio, paginas e os filtros opcionais que quiser aplicar.
Revise a estimativa maxima de creditos e o detalhamento por etapa antes de iniciar.
Monitore a coleta no Zapimoveis, a busca do site oficial, a leitura do website e o enrichment empresarial.
Ao final, baixe o arquivo em JSON ou CSV para consumir cada item como uma imobiliaria enriquecida.
zap_search
Pesquisa anuncios no Zapimoveis usando cidade, estado, tipo de negocio e filtros adicionais.
zap_listing
Consolida os dados da agencia a partir dos anuncios e deduplica imobiliarias repetidas.
google_search
Procura o site oficial mais provavel para cada imobiliaria deduplicada.
website_contact
Extrai telefones, emails, WhatsApp, redes sociais e paginas de contato do site selecionado.
casa_dos_dados
Enriquece o CNPJ identificado com os dados empresariais estruturados.
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 |
O payload abaixo já usa o templateId desta busca e um body real
compatível com o endpoint público. Depois da criação, acompanhe a execução em
GET /v1/workflows/runs/{runId}/status e, se necessário,
cancele com POST /v1/workflows/runs/{runId}/cancel.
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 uma busca faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.
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.
O arquivo final sempre carrega metadados da execução, os parâmetros originais, a estimativa usada na criação e o resumo operacional da execução.
{
"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 |
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.
{
"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 |
Use esta busca pronta no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o resultado final.