Falcon Data Hub
API de CNPJ — Receita Federal

Consulte CNPJ com QSA e CNAE

API REST com dados oficiais da Receita Federal. Razão social, situação, CNAE, quadro de sócios e endereço completo. Cache para evitar rate-limit.

<300msLatência p95
QSASócios inclusos
GrátisPlano inicial
curl https://datahub.falcon-server.com.br/private/v1/cnpj/00000000000191/search \
  -H "Authorization: Bearer <SEU_TOKEN>"

# Resposta
{
  "data": {
    "cnpj": "00.000.000/0001-91",
    "razao_social": "BANCO DO BRASIL S.A.",
    "nome_fantasia": "BANCO DO BRASIL",
    "situacao": "ATIVA",
    "data_situacao": "2005-11-03",
    "cnae_fiscal": 6422100,
    "cnae_descricao": "Bancos múltiplos",
    "qsa": [
      { "nome": "...", "qualificacao": "Diretor" }
    ],
    "endereco": {
      "logradouro": "SAUN QUADRA 5 LOTE B TORRES I, II E III",
      "municipio": "Brasília",
      "uf": "DF",
      "cep": "70040912"
    }
  }
}

O que a API de CNPJ retorna

Dados completos em uma única chamada — sem precisar montar scraper.

Dados oficiais Receita Federal

Razão social, nome fantasia, situação cadastral, data de abertura, capital social e natureza jurídica.

QSA — Quadro de Sócios

Lista completa de sócios com qualificação, percentual de participação e data de entrada.

CNAE principal + secundários

Código e descrição do CNAE fiscal principal e lista completa de CNAEs secundários.

Endereço normalizado

Logradouro, número, complemento, bairro, município, UF e CEP — prontos para usar.

Cache + rate-limit

CNPJs já consultados retornam em <100ms. Você não fica refém do rate-limit da Receita.

Aceita formatos variados

CNPJ com pontos, barras, hífen ou só números. Normalizamos antes de validar.

Falcon vs. outras APIs de CNPJ

Por que escolher Falcon

RecursoFalcon Data HubReceitaWSBrasilAPI
QSA (sócios) inclusoSimSimNão
CNAEs secundáriosSimPagoSim
Plano grátis sem cartãoSim3 req/minSim
SLA contratual99.9%NãoNão
SDK oficialPHP + NodeNãoNão
Outras APIs no mesmo tokenCEP, FIPE, Placa, BCB…NãoParcial

Perguntas frequentes sobre a API de CNPJ

Os dados são oficiais?

Sim. Os dados vêm da base oficial da Receita Federal, com atualização periódica. Diferenças em relação ao site da Receita podem ocorrer em até 24-48h após uma alteração cadastral.

O QSA (sócios) está incluso no plano grátis?

Sim. Diferente de outras APIs que cobram à parte pelo QSA, no Falcon você recebe o quadro de sócios em todos os planos.

Posso consultar CNPJs em massa?

Sim. Use o plano Premium (1.000 req/h) ou Enterprise (10k req/h). Temos também endpoint de batch para envio paralelo.

Vocês cobram por CNPJ inativo ou inexistente?

Não. CNPJs inválidos retornam 404 sem descontar do seu limite.

A API valida o dígito verificador?

Sim. Se o CNPJ for inválido (DV errado), retornamos 400 antes mesmo de consultar a Receita.

Como é o cache?

Primeira consulta vai até a Receita (~1–2s). Consultas seguintes do mesmo CNPJ vêm do nosso cache (<100ms) por até 30 dias.

Cria conta e consulta seu primeiro CNPJ agora

Email + senha, sem cartão. Token pronto em 30 segundos.