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.
• Funciona em lote pelo modo Batch e em tempo real pela API Standby.

💼 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 somente dois campos simples. Para consultar um único CNPJ, envie uma lista com um item. O filtro ufs é opcional e vem com todos os estados selecionados no formulário.

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.

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

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. O parâmetro maxTotalChargeUsd limita o valor máximo da execução; ajuste-o conforme a quantidade de resultados desejada e o preço vigente na aba Pricing.

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

Standby — resposta HTTP em tempo real

Use o endpoint único POST /obras quando sua integração precisar receber o JSON imediatamente:

curl -X POST "https://brasildados--cno-cadastro-nacional-de-obras-api.apify.actor/obras" \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnpjs":["73.178.600/0001-18","73178600000118"],"ufs":["SP","RJ"]}'

O Standby aceita corpo JSON de até 5 MB. Entrada inválida retorna status 400 com { "error": "mensagem" }; falhas temporárias tratadas retornam status 500 no mesmo formato. Para empresas com muitas obras ou operações que possam levar vários minutos, prefira Batch.

A aba Endpoints oferece um Playground com input preenchido e um Example Value completo, compatível com o resultado real.

💳 Cobrança Pay per event

O evento utilizado é obra-encontrada. Cada obra efetivamente entregue 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.
• Obra que não puder ser cobrada = não é entregue.
• 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; configure seu limite de gastos 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.

Perguntas frequentes

Posso consultar somente um CNPJ?

Sim. Use o mesmo campo com um item: {"cnpjs":["73178600000118"]}.

Posso enviar CNPJ com pontuação?

Sim. O Actor aceita 73.178.600/0001-18 e 73178600000118 e normaliza os valores internamente.

Posso selecionar mais de um estado?

Sim. O campo ufs é um multiselect opcional. Use, por exemplo, "ufs":["SP","RJ","MG"]. Se o campo for omitido ou enviado como lista vazia, todas as UFs serão consideradas.

O Actor aceita CPF?

Não. Esta API é voltada exclusivamente à consulta de obras vinculadas a empresas por CNPJ.

Cada CNPJ gera somente uma linha?

Não. Cada obra gera uma linha independente. Um CNPJ com 50 obras pode gerar até 50 resultados e 50 eventos cobrados, respeitando o limite de gastos da execução.

O endereço da obra é completo?

Sim. Como o endereço pertence ao registro público da obra, podem ser retornados logradouro, número, complemento, bairro, município, UF e CEP.

Posso exportar para Excel?

Sim. No Dataset da execução, escolha XLSX, CSV, JSON, XML ou outro formato disponível na Apify.

Quando devo usar Batch ou Standby?

Use Batch para volumes maiores, exportações e agendamentos. Use Standby para integrações HTTP que precisam da resposta imediatamente.

Os dados são atuais?

A consulta é feita em tempo de execução. A atualização e a disponibilidade dependem dos registros auditáveis consultados naquele momento.

Suporte

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