Question 1

Como funciona a autenticação da API da Dados Premium?

Accepted Answer

A autenticação é feita por token Bearer. Você gera uma chave de API (formato sk_live_...) no painel e a envia no header Authorization: Bearer sk_live_... em cada requisição. As chamadas trafegam sobre HTTPS e a chave nunca deve ser exposta no front-end — use-a apenas a partir do seu servidor.

Question 2

Qual o formato de resposta da API?

Accepted Answer

Todas as respostas são JSON (Content-Type application/json), com status HTTP padrão (200 OK, 401 não autorizado, 404 não encontrado, 429 limite de requisições). Cada empresa retorna mais de 100 campos: cadastro na Receita Federal, CNAE, endereço, quadro societário e, quando enriquecido, telefone fixo, celular e e-mail reais dos sócios.

Question 3

Qual a latência típica de uma chamada de enriquecimento por CNPJ?

Accepted Answer

A consulta de cadastro por CNPJ responde em geral em poucas centenas de milissegundos. O enriquecimento com dados reais dos sócios pode levar um pouco mais, pois cruza fontes adicionais. Para grandes volumes recomendamos processamento assíncrono e uso de webhooks em vez de aguardar cada resposta síncrona.

Question 4

Existe ambiente de testes (sandbox) e documentação?

Accepted Answer

Sim. Ao contratar, você recebe acesso à documentação técnica dos endpoints e a uma chave para testar a integração antes de subir para produção. O time técnico da Dados Premium apoia a implementação da API e dos webhooks.

Question 5

A partir de qual plano a API está disponível e quanto custa?

Accepted Answer

A API e os webhooks estão disponíveis a partir do plano Corporate (R$699/mês, ou R$499/mês no anual) e no Empresarial (R$1.290/mês, ou R$890/mês no anual). O enriquecimento com dados reais dos sócios consome créditos (packs de 1k a 50k, de R$0,05 a R$0,025 por consulta, sem expiração) e a validação é cobrada à parte: WhatsApp R$0,008 por número e e-mail R$0,01.

Question 6

De onde vêm os dados e como fica a LGPD?

Accepted Answer

A base parte dos dados públicos da Receita Federal (+29 milhões de empresas ativas, atualização diária, 99% de assertividade). O enriquecimento usa fontes públicas e oficiais, tratadas em conformidade com a LGPD (Lei nº 13.709/2018). A prospecção B2B com dados de sócios de pessoas jurídicas é amparada pelo legítimo interesse (art. 7º, IX), com finalidade comercial legítima e opção de descadastramento.