API de Cadastro Nacional de Obras Civis (CNO) por CNPJ

🏗️ Consulta CNO e Dados de Obras Civis por CNPJ

Consulte o CNO — Cadastro Nacional de Obras e encontre obras civis vinculadas a empresas brasileiras pelo CNPJ. Informe de 1 a 20 CNPJs, filtre por uma ou várias UFs e receba uma linha por obra com número CNO, empresa responsável, situação cadastral, área, datas, endereço completo, CNAEs e composição das áreas.

Esta API de obras por CNPJ entrega dados estruturados para construtoras, incorporadoras, fornecedores da construção civil, seguradoras, escritórios contábeis, compliance, prospecção B2B e inteligência de mercado. Os resultados podem ser exportados em JSON, CSV, Excel, XML e outros formatos oferecidos pela Apify.

🔎 O que é o Cadastro Nacional de Obras?

O Cadastro Nacional de Obras identifica construções civis e registra informações relacionadas à obra e ao seu responsável. A consulta CNO pode ajudar a localizar empreendimentos, validar registros, analisar a atuação de uma empresa no setor e mapear oportunidades comerciais ligadas à construção civil.

Este Actor organiza registros obtidos em tempo de execução a partir de fontes legítimas e auditáveis. Ele não emite certidão nem substitui uma consulta oficial, parecer jurídico, fiscal ou técnico.

O que este Actor faz?

• Consulta obras de um ou vários CNPJs no mesmo campo.
• Aceita CNPJ com pontuação ou somente números.
• Remove CNPJs duplicados antes da consulta.
• Processa até 20 empresas em paralelo com concorrência controlada.
• Filtra localmente por uma ou várias UFs sem gerar consultas adicionais.
• Retorna uma linha independente para cada obra encontrada.
• Mantém endereço público da obra completo.
• Preserva relações 1:N em cnaes[] e areas[].
• Exporta o Dataset para JSON, CSV, Excel e XML.

💼 Casos de uso

• Prospecção B2B: encontre obras ligadas a construtoras e incorporadoras conhecidas.
• Fornecedores da construção civil: identifique oportunidades para materiais, equipamentos e serviços.
• Inteligência de mercado: analise cidades, estados, áreas, destinações e situações das obras.
• Compliance e due diligence: complemente a análise cadastral de empresas e empreendimentos.
• Contabilidade e regularização: organize registros CNO relacionados a uma carteira de CNPJs.
• Seguros e crédito: apoie análises de exposição e atividade no setor de construção.
• CRM e automação: integre obras encontradas a fluxos comerciais e operacionais.

📥 Entrada

O input possui três campos simples. Para consultar um único CNPJ, envie uma lista com um item. Os campos ufs e maxObras são opcionais.

Campo	Obrigatório	Limite	Descrição
cnpjs	Sim	1 a 20	Lista de CNPJs com ou sem pontuação. Valores repetidos são consultados uma única vez.
ufs	Não	27 UFs	Multiselect para filtrar as obras por um ou vários estados. Omitido ou vazio retorna todas as UFs.
maxObras	Não	1 a 5000 (padrão 100)	Teto de obras entregues e cobradas na execução, somando todos os CNPJs informados.

{
  "cnpjs": ["73.178.600/0001-18","73178600000118"],
  "ufs": ["SP","RJ"],
  "maxObras": 100
}

Os dois formatos abaixo são aceitos e normalizados internamente:

Valor enviado	Valor normalizado
73.178.600/0001-18	73178600000118
73178600000118	73178600000118

📤 Dados retornados

Cada linha do Dataset representa uma obra encontrada. Isso facilita filtros, planilhas, bancos de dados e cobrança por resultado, mesmo quando um único CNPJ possui centenas de obras.

Grupo	Campos disponíveis
Empresa	cnpj, cnpjFormatado, empresa
Totais por CNPJ	totalObrasEmpresa, totalObrasAtivasEmpresa, totalObrasEncerradasEmpresa, totalObrasFiltradas
Identificação da obra	cno, nomeObra, situacao, qualificacaoResponsavel
Área e datas	areaMetrosQuadrados, inicioEm, responsabilidadeInicioEm, cadastradoEm
Endereço da obra	pais, cep, tipoLogradouro, logradouro, numero, complemento, bairro, municipio, uf
Atividades	cnaes[].codigo, cnaes[].cadastradoEm
Composição da área	categoria, destinação, tipo construtivo, tipo da área, complemento e metros quadrados em areas[]

Exemplo completo do resultado JSON

O exemplo abaixo contém todos os campos públicos e reproduz os mesmos nomes, tipos e níveis do retorno real. Os valores são ilustrativos.

{
  "cnpj": "73178600000118",
  "cnpjFormatado": "73.178.600/0001-18",
  "empresa": "CONSTRUTORA BRASIL S.A.",
  "totalObrasEmpresa": 2,
  "totalObrasAtivasEmpresa": 2,
  "totalObrasEncerradasEmpresa": 0,
  "totalObrasFiltradas": 2,
  "cno": "900030410574",
  "nomeObra": "RESIDENCIAL JARDINS",
  "situacao": "ATIVA",
  "areaMetrosQuadrados": 9656,
  "inicioEm": "2020-03-11",
  "responsabilidadeInicioEm": "2020-03-11",
  "cadastradoEm": "2020-03-11",
  "qualificacaoResponsavel": "Dono da Obra",
  "pais": "BRASIL",
  "cep": "05414-020",
  "tipoLogradouro": "RUA",
  "logradouro": "FRANCISCO LEITAO",
  "numero": "416",
  "complemento": "BLOCO A",
  "bairro": "PINHEIROS",
  "municipio": "SÃO PAULO",
  "uf": "SP",
  "cnaes": [
    {
      "codigo": "4311-8/01",
      "cadastradoEm": "2020-03-11"
    }
  ],
  "areas": [
    {
      "categoria": "Obra Nova",
      "destinacao": "Residencial multifamiliar",
      "tipoConstrucao": "Alvenaria",
      "tipoArea": "Principal",
      "complementoTipoArea": null,
      "metrosQuadrados": 9656
    }
  ]
}

Campos não informados são retornados como null; listas sem registros são retornadas como [].

⚡ Como usar pela API

Você precisa apenas do token da sua conta Apify. Use o header Authorization: Bearer para evitar que o token apareça em URLs e logs.

Batch — executar e receber o Dataset

Use Batch para lotes, empresas com muitas obras, exportações, agendamentos e automações.

curl -X POST "https://api.apify.com/v2/acts/brasildados~cno-cadastro-nacional-de-obras-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnpjs":["73.178.600/0001-18","73178600000118"],"ufs":["SP","RJ"],"maxObras":100}'

Use maxObras (no input) para limitar quantas obras são entregues e cobradas na execução. Se preferir limitar diretamente o gasto da run, use o parâmetro de API maxTotalChargeUsd (opção separada, fora do JSON de input — veja a documentação da API).

💳 Cobrança Pay per event

Cada obra efetivamente entregue no Dataset gera uma cobrança independente.

• Um CNPJ com 8 obras entregues = 8 eventos.
• Dois CNPJs com 3 e 5 obras = 8 eventos.
• CNPJ sem obra = nenhuma cobrança de resultado.
• CNPJ duplicado = consultado uma única vez.
• maxObras limita o total de obras entregues (e cobradas) na execução, somando todos os CNPJs.
• Limite de gastos atingido = somente os resultados cobrados são disponibilizados.

O preço atualizado por obra aparece na aba Pricing da página do Actor.

🔐 Privacidade e qualidade

• Endereços de obras são registros públicos e permanecem completos.
• CNPJ e nome de pessoa jurídica permanecem completos.
• O Actor não publica CPF completo; qualquer documento pessoal eventualmente recebido é omitido ou mascarado.
• Credenciais internas nunca aparecem no input, Dataset, resposta HTTP ou logs públicos.
• Datas são normalizadas para AAAA-MM-DD, CEP para 00000-000 e CNAE para 0000-0/00 quando possível.

Como interpretar os principais campos?

• cno: número que identifica a obra no Cadastro Nacional de Obras.
• situacao: situação disponível para o registro, como ativa, encerrada ou paralisada.
• areaMetrosQuadrados: área principal informada para a obra; consulte areas[] para a composição detalhada.
• totalObrasEmpresa: total nacional de registros associado ao CNPJ, antes do filtro por UF.
• totalObrasAtivasEmpresa e totalObrasEncerradasEmpresa: totais nacionais informados para a empresa.
• totalObrasFiltradas: quantidade de obras do CNPJ que corresponde às UFs selecionadas.
• cnaes[]: atividades econômicas vinculadas ao registro da obra.
• areas[]: parcelas de área com categoria, destinação, tipo construtivo e metragem.

Limitações

• São aceitos até 20 CNPJs por execução ou requisição.
• O filtro de UF é aplicado depois da consulta do CNPJ; portanto, não reduz o custo interno da consulta, mas somente obras filtradas e entregues geram PPE.
• A quantidade de obras varia conforme os registros disponíveis para cada empresa.
• Um CNPJ pode retornar centenas de linhas; use maxObras ou o limite de gastos da execução para controlar o total antes de executar.
• A disponibilidade e a atualização dependem das fontes consultadas em tempo de execução.
• A ausência de resultado indica que nenhuma obra foi encontrada nos registros disponíveis naquele momento.

Actors relacionados da BrasilDados

• Enriquecimento de empresas por CNPJ para enriquecer uma lista conhecida de empresas.
• Consulta de contratos do Governo por CNPJ para localizar contratos públicos de empresas.
• Gerador de leads por CNAE para criar listas comerciais por atividade econômica.
• Todos os Actors da BrasilDados para outras consultas empresariais no Brasil.

Suporte

Para dúvidas ou sugestões, abra a aba Issues deste Actor. Conheça também a loja BrasilDados.