Documentação da API CNPJNow
RESTful API v1.0
Introdução
A API CNPJNow permite que você acesse informações públicas de mais de 50 milhões de empresas brasileiras diretamente em suas aplicações. Nossa API é RESTful, usa JSON para todas as respostas e segue os padrões modernos da web.
Base URL
https://api.cnpjnow.com/v1Autenticação
A API utiliza autenticação via Bearer Token. Você pode obter sua API Key criando uma conta e gerando tokens no painel de controle.
# Exemplo de requisição com autenticação curl -X GET "https://api.cnpjnow.com/v1/cnpj/33000167000101" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Importante
Nunca compartilhe sua API Key publicamente. Mantenha-a segura em variáveis de ambiente.
Rate Limits
Os limites de requisições variam de acordo com seu plano:
| Plano | Requisições/mês | Rate Limit |
|---|---|---|
| Free | 100 | 10 req/min |
| Pro | 10.000 | 100 req/min |
| Enterprise | Ilimitado | Customizado |
Os headers de resposta incluem informações sobre seu limite: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Endpoints Principais
/cnpj/{cnpj}Retorna informações completas de uma empresa pelo CNPJ.
# Exemplo de resposta
{
"cnpj": "33.000.167/0001-01",
"razao_social": "PETROBRAS - PETRÓLEO BRASILEIRO S.A.",
"nome_fantasia": "PETROBRAS",
"situacao": "ATIVA",
"data_abertura": "1954-05-03",
"capital_social": 240000000000.00,
"porte": "DEMAIS",
"natureza_juridica": "Sociedade Anônima Aberta",
"atividade_principal": {
"codigo": "0600-0/01",
"descricao": "Extração de petróleo e gás natural"
},
"endereco": {
"logradouro": "AV REPÚBLICA DO CHILE",
"numero": "65",
"bairro": "CENTRO",
"municipio": "RIO DE JANEIRO",
"uf": "RJ",
"cep": "20031-912"
},
"socios": [...]
}/buscar?q={query}Busca empresas por razão social ou nome fantasia. Suporta paginação.
Parâmetros: q (query), page (página), limit (resultados por página)
# Exemplo GET /buscar?q=petrobras&page=1&limit=10
/estado/{uf}Lista empresas por estado. Retorna estatísticas e empresas mais relevantes.
# Exemplo GET /estado/sp?page=1&limit=20
/cnae/{codigo}Lista empresas por código CNAE (atividade econômica).
# Exemplo GET /cnae/6201-5/00
Exemplos de Código
JavaScript / TypeScript
// Usando fetch
const response = await fetch(
'https://api.cnpjnow.com/v1/cnpj/33000167000101',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const data = await response.json();
console.log(data.razao_social);
// Usando axios
import axios from 'axios';
const { data } = await axios.get(
'https://api.cnpjnow.com/v1/cnpj/33000167000101',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);Python
import requests
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.get(
'https://api.cnpjnow.com/v1/cnpj/33000167000101',
headers=headers
)
data = response.json()
print(data['razao_social'])PHP
<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://api.cnpjnow.com/v1/cnpj/33000167000101'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $data = json_decode($response, true); echo $data['razao_social']; curl_close($ch);
Códigos de Erro
A API utiliza códigos HTTP padrão para indicar sucesso ou falha:
200400401404429500Suporte
Precisa de ajuda? Estamos aqui para você!