Consulte CNPJ com QSA e CNAE
API REST com dados públicos 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": "00000000000191",
"razao_social": "BANCO DO BRASIL SA",
"nome_fantasia": "DIRECAO GERAL",
"descricao_situacao_cadastral": "ATIVA",
"data_situacao_cadastral": "2005-11-03",
"cnae_fiscal": 6422100,
"cnae_fiscal_descricao": "Bancos múltiplos, com carteira comercial",
"cnaes_secundarios": [{ "codigo": 6499999, "descricao": "..." }],
"qsa": [{ "nome_socio": "...", "qualificacao_socio": "Diretor", "data_entrada_sociedade": "2023-01-01" }],
"logradouro": "SAUN QUADRA 5 LOTE B TORRES I, II E III",
"municipio": "BRASILIA",
"uf": "DF",
"cep": "70040912",
"capital_social": 120000000000
}
}O que a API de CNPJ retorna
Dados completos em uma única chamada — sem precisar montar scraper.
Dados públicos da 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 respondem do nosso cache, sem nova consulta externa. Você não fica refém de rate-limit.
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 | Enterprise | Não | Não |
| SDK oficial | PHP | 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?
Os dados vêm de bases públicas da Receita Federal. O cadastro fica em cache e é reconsultado depois de 30 dias, então uma alteração recente pode levar até esse prazo para aparecer.
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, uma consulta por requisição. Iniciante (R$ 4,90/mês): 100 requisições/hora; Premium (R$ 49,90/mês): 1.000 requisições/hora; Enterprise (R$ 199,90/mês): 10.000 requisições/hora. Os limites e preços atualizados estão na página de planos.
Vocês cobram por CNPJ inativo ou inexistente?
CNPJ inexistente retorna HTTP 404. Toda requisição conta no limite por hora do seu plano, inclusive a que não encontra resultado ou é recusada por dado inválido.
A API valida o dígito verificador?
Sim, inclusive o CNPJ alfanumérico (IN RFB 2.229/2024). Se o dígito verificador estiver errado, retornamos HTTP 400 antes de qualquer consulta externa.
Como é o cache?
A primeira consulta vai à fonte externa e leva alguns segundos. As seguintes do mesmo CNPJ vêm do nosso cache 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.