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.
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
| Recurso | Falcon Data Hub | ReceitaWS | BrasilAPI |
|---|---|---|---|
| QSA (sócios) incluso | Sim | Sim | Não |
| CNAEs secundários | Sim | Pago | Sim |
| Plano grátis sem cartão | Sim | 3 req/min | Sim |
| SLA contratual | 99.9% | Não | Não |
| SDK oficial | PHP + Node | Não | Não |
| Outras APIs no mesmo token | CEP, FIPE, Placa, BCB… | Não | Parcial |
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.
Outras APIs no mesmo token
Uma única conta cobre tudo. Crie agora e use todas as APIs com o mesmo plano.
Cria conta e consulta seu primeiro CNPJ agora
Email + senha, sem cartão. Token pronto em 30 segundos.