API, Excel e CRM

API

1. Crie sua conta (grátis) e confirme o e-mail.
2. Em Minha conta › API, clique em Criar chave e copie a chave (começa com cna_). Ela aparece uma vez só.
3. Envie a chave no cabeçalho X-Api-Key de cada chamada. Nunca coloque a chave no endereço (URL).

Custo: consultar CNPJ, contar e baixar o que já foi pago é grátis. Comprar uma lista pela API usa os créditos da conta: 1 crédito por empresa, como no site. Limites: 120 chamadas por minuto por chave, até 50 CNPJs por chamada e 1.000 empresas por página.

Endereço base: https://cnpjativos.com.br/api/v1 · respostas em JSON (UTF-8) com "ok": true ou "ok": false, "erro": "…".

Filtros (os mesmos do Panorama)

Vários valores: separe por vírgula. Com CNAE, cidade, datas, Simples, só matriz ou palavra no nome, escolha também um estado, setor ou segmento.

Exemplos

Consultar um CNPJ:

curl -H "X-Api-Key: SUA_CHAVE" https://cnpjativos.com.br/api/v1/cnpj/33000167000101

Quantos restaurantes em São Paulo (SP) com telefone:

curl -H "X-Api-Key: SUA_CHAVE" "https://cnpjativos.com.br/api/v1/contar?ufs=SP&seg=restaurantes&contato=tel"

Comprar a lista com créditos e baixar as empresas (Python):

import requests
API = "https://cnpjativos.com.br/api/v1"
H = {"X-Api-Key": "SUA_CHAVE"}   # guarde a chave fora do código (variável de ambiente)

filtros = {"ufs": "SP", "seg": "restaurantes", "contato": "tel"}
orc = requests.post(API + "/listas", json=filtros, headers=H).json()
print(orc["total"], "empresas; saldo", orc["saldo"])

compra = requests.post(API + "/listas", json={**filtros, "confirmar": 1}, headers=H).json()
pedido = compra["pedido"]["id"]

pagina, empresas = 1, []
while True:
    r = requests.get(f"{API}/pedidos/{pedido}/empresas", params={"pagina": pagina}, headers=H).json()
    empresas += r["empresas"]
    if pagina >= r["paginas"]:
        break
    pagina += 1

Códigos de resposta

200 ok · 201 lista comprada · 401 chave ausente ou inválida · 402 créditos insuficientes · 404 não encontrado · 409 pedido ainda em preparação ou lista grande (use /arquivo) · 410 prazo de 30 dias terminou · 422 filtros inválidos · 429 limite por minuto · 503 base em atualização.

LGPD: a API entrega os mesmos dados da lista comprada no site (sem sócios e sem CPF; MEI sem telefone e e-mail; empresas removidas a pedido não aparecem). A consulta de CNPJ não mostra MEI nem empresário individual.

Planilha Excel conectada

Planilhas prontas que puxam os dados da API pelo Power Query do Excel. Você cola a chave uma vez e clica em Dados › Atualizar Tudo. Funciona no Excel para Windows (Microsoft 365, 2019 ou 2016).

1. Abra a planilha. Se aparecer a faixa amarela Modo de Exibição Protegido, clique em Habilitar Edição.
2. Na aba Início, cole a chave da API na célula amarela (e o número do pedido ou os CNPJs).
3. Clique em Dados › Atualizar Tudo.
4. Só na primeira vez: em Acessar conteúdo da Web escolha Anônimo e Conectar; em Níveis de privacidade marque Ignorar as verificações de níveis de privacidade e Salvar.

A chave fica gravada na planilha: não envie o arquivo preenchido para outras pessoas. Se precisar, revogue a chave em Minha conta › API e crie outra.

Arquivo no formato do seu CRM

Na página do pedido (Minha conta › Pedidos › Baixar), escolha o CRM. O arquivo sai em CSV com as colunas já com os nomes que o importador espera:

O importador de cada CRM mostra uma tela para conferir as colunas antes de gravar: confira CNPJ, segmento e porte (campos personalizados, crie se ainda não existirem). Pela API: /pedidos/{id}/arquivo?formato=hubspot. Listas acima de 50 mil empresas vêm só em ZIP de CSV padrão.

Dúvidas

A API tem mensalidade? Não. Consultar e contar é grátis; listas usam os mesmos créditos do site.

De quando são os dados? Da base pública da Receita Federal, atualizada todo mês. Campo base_receita nas respostas.

Precisa de outra integração? Fale com a gente no WhatsApp (15) 99183-1913.