Data Stone API (1.0)
A API da Data Stone fornece acesso a dados enriquecidos de pessoas físicas e jurídicas do Brasil.
Funcionalidades principais:
- Consulta de informações de pessoas e empresas
- Prospecção e busca avançada com filtros personalizados
- Enriquecimento de dados B2B em lote
- Dados auxiliares (CNAE, CBO, geolocalização)
- Validação de contatos WhatsApp
Base URL: https://api.datastone.com.br/v1
Todas as requisições requerem uma API Key no header Authorization.
Como obter sua API Key: Acesse seu perfil no painel e gere uma nova chave. Ao copiar, ela já virá no formato correto.
Formato obrigatório:
Authorization: Token <sua-api-key>Exemplos de uso:
Python:
import requests
headers = {
'Authorization': 'Token abc123suachaveaqui'
}
response = requests.get('https://api.datastone.com.br/v1/saldo', headers=headers)JavaScript:
fetch('https://api.datastone.com.br/v1/saldo', {
headers: {
'Authorization': 'Token abc123suachaveaqui'
}
})cURL:
curl -H "Authorization: Token abc123suachaveaqui" https://api.datastone.com.br/v1/saldoSistema de notificação automática via POST ao final de processos de enriquecimento ou prospecção.
- Cadastro: Via perfil do administrador com teste automático de disponibilidade da URL
- Método: POST (enviado pela API para o cliente)
- Retry Policy: 3 tentativas com intervalo de 1 minuto entre cada
- Timeout: 30 segundos por requisição
- Resposta requerida: HTTP 200 imediato
Payload do Webhook:
{
"job_id": 123,
"job_type": "enrichment",
"status": "done"
}Valores possíveis para job_type: enrichment, prospecting
Valores possíveis para status: requested, done, error
Limite Padrão: 100 requisições por dia (compartilhado entre API e painel)
- Personalização: Limites podem ser customizados por conta/empresa
- Whitelist de IPs: Administradores podem adicionar IPs que ficam isentos do rate limit
- Resposta quando excedido: Status Code
429 Too Many Requestscom bloqueio de 24 horas
Controle de uso por tipo de produto (gerenciado por administradores):
- B2C (Consulta, Enriquecimento, Prospecção): 100.000 requisições/mês
- B2B (Prospecção B2B, Consulta B2B): 50.000 requisições/mês
Resposta quando excedido: Status Code 429 Too Many Requests até início do próximo período
{
"detail": "Verifique o token informado."
}Causa: A API Key está incorreta ou o formato do header está errado.
Solução:
- Verifique se copiou a API Key corretamente (sem espaços extras no início ou fim)
- Confirme que o header está exatamente assim:
Authorization: Token sua-api-key - Se necessário, gere uma nova API Key no painel
{
"detail": "Acesso não autorizado. O IP 192.168.1.1 não está na lista de IPs permitidos. Adicione este IP na whitelist da sua empresa para liberar o acesso."
}Causa: Seu IP não está cadastrado na whitelist da empresa.
Solução:
- Copie o IP que aparece na mensagem de erro
- Acesse o painel da Data Stone
- Vá em Meu Perfil > Whitelist de IPs
- Adicione o IP copiado
- Aguarde alguns segundos e tente novamente
{
"error": {
"code": "no credits",
"description": "Você não possui saldo suficiente, disponível 0"
}
}Causa: Sua conta não tem créditos suficientes para a operação.
Solução: Adquira mais créditos no painel ou entre em contato com o suporte.
{
"detail": "O limite de utilização por usuário foi excedido. Contate o seu administrador para aumentar ou aguarde o reinício do ciclo no próximo mês."
}Causa: Você excedeu o limite de requisições diárias ou mensais.
Solução:
- Aguarde até o próximo mês para o ciclo reiniciar
- Solicite aumento de limite com o administrador da sua empresa
- Adicione seu IP na whitelist para ficar isento do rate limit diário
Use toda a API da Data Stone sem escrever uma linha de código.
Temos um nó comunitário oficial para o n8n — a plataforma open-source de automação com mais de 400 integrações. Arraste, conecte, execute. É isso.
- Sem código: Monte workflows visuais arrastando blocos — prospecção, enriquecimento, consulta, tudo na interface
- Integração total: Conecte a Data Stone a CRMs (HubSpot, Pipedrive), planilhas (Google Sheets), email (Gmail, SendGrid), Slack, Telegram e centenas de outros serviços
- Templates prontos: Importe workflows completos com um clique e comece a usar em minutos
- Exportação CSV: Todos os templates já geram arquivos CSV prontos para download ou envio automático
- Agende execuções: Rode prospecções periódicas, monitore mudanças em dados de empresas e contatos automaticamente
- No n8n, acesse Settings > Community Nodes
- Clique em Install a community node
- Digite
n8n-nodes-datastone - Clique em Install
- Crie uma credencial Data Stone API e cole sua API Key
- Pronto — todos os recursos ficam disponíveis nos seus workflows
O nó oferece acesso completo à API:
| Recurso | Operações |
|---|---|
| Pessoa | Consultar por CPF, Buscar, Busca Avançada |
| Empresa | Consultar por CNPJ, Buscar, Buscar Filiais |
| B2B Pessoa | Prospectar, Enriquecer, Enriquecer em Lote |
| B2B Empresa | Prospectar, Enriquecer, Enriquecer em Lote |
| Enriquecimento | Listar Layouts, Criar, Consultar Status |
| Conta | Consultar Saldo |
Copie a URL, cole no n8n em "..." > "Import from URL..." e o workflow aparece pronto para configurar:
| Template | URL |
|---|---|
| Prospecção B2B - Pessoas | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/01_prospeccao_b2b_pessoas.json |
| Prospecção B2B - Empresas | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/02_prospeccao_b2b_empresas.json |
| Consulta Pessoa por CPF | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/03_consulta_pessoa_cpf.json |
| Busca de Pessoa | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/04_busca_pessoa.json |
| Consulta Empresa por CNPJ | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/05_consulta_empresa_cnpj.json |
| Busca de Empresa | https://raw.githubusercontent.com/Data-Stone/n8n-nodes-datastone/main/n8n_examples/06_busca_empresa.json |
Os templates foram feitos para servir como ponto de partida. Importe, ajuste os filtros e conecte aos serviços que você já usa. Algumas ideias:
- Prospecção + CRM: Encontre contatos B2B e crie leads automaticamente no HubSpot, Pipedrive ou Salesforce
- Enriquecimento + Email: Enriqueça contatos e dispare sequências de email via Mailchimp, SendGrid ou Gmail
- Consulta + Google Sheets: Consulte CPFs/CNPJs em lote a partir de uma planilha e grave os resultados de volta
- Monitoramento automático: Agende execuções periódicas para acompanhar mudanças nos dados de empresas e contatos
- Qualificação de leads: Combine consulta de pessoa + empresa para validar e pontuar leads antes de entrar no funil de vendas
- Notificações: Envie alertas via Slack, Telegram ou WhatsApp quando novos contatos forem encontrados na prospecção
O n8n tem mais de 400 integrações nativas. Combine a Data Stone com qualquer uma delas e monte o fluxo ideal para o seu negócio.