Estrutura de filtros retornada com sucesso
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.
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/filter-structure/
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/filter-structure/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://docs.datastone.com.br/_mock/api/b2b/filter-structure/ \
-H 'Authorization: YOUR_API_KEY_HERE'- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/filter-options/
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/filter-options/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://docs.datastone.com.br/_mock/api/b2b/filter-options/ \
-H 'Authorization: YOUR_API_KEY_HERE'{}
Request
Busca em tempo real por diferentes tipos de dados com autocomplete.
Parâmetros de busca disponíveis:
nome_empresa- Nomes de empresas (LinkedIn, razão social, nome fantasia) - Limite: 50localizacao- Cidades (passar UF do estado) - Sem limitesetor- Setor empresarial - Limite: 50cargo- Cargos/funções - Limite: 50atividade_cnae- Atividades CNAE - Limite: 50natureza_juridica- Natureza jurídica - Limite: 50especialidade- Especialidades - Limite: 50
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/search/
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/search/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.datastone.com.br/_mock/api/b2b/search/?term=Google&field=nome_empresa' \
-H 'Authorization: YOUR_API_KEY_HERE'[ {} ]
Request
Prospecção B2B de pessoas físicas com filtros avançados de perfil profissional e empresa.
Modelo de cobrança:
- Primeira requisição (sem chave de cache): 1 crédito B2B
- Paginação (com chave de cache): 0 créditos
- Expiração do cache: 7 dias
O campo id_pessoa retornado pode ser usado no endpoint de Enriquecimento de Pessoas.
Chave de cache (economiza créditos em requisições subsequentes)
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/persons/
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/persons/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/persons/ \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pagina": 1,
"por_pagina": 20,
"chave_cache": "abc123xyz",
"filtros_pessoa": {
"departamentos": [
"Tecnologia",
"Marketing"
],
"niveis_senioridade": [
"Sênior",
"Pleno"
],
"cargos": [
"Desenvolvedor",
"Gerente"
],
"habilidades": [
"Python",
"JavaScript"
],
"periodos_trabalho": [
{}
],
"localizacoes": [
"São Paulo, SP"
],
"estados": [
"SP",
"RJ"
],
"has_email": true,
"has_phone": true,
"has_cnpj": true,
"has_linkedin": true
},
"filtros_empresa": {
"nome_empresa": [
"Google Brasil Internet Ltda"
],
"localizacoes": [
"São Paulo, SP",
"Rio de Janeiro, RJ"
],
"estados": [
"SP",
"RJ"
],
"setores": [
"Tecnologia",
"Educação"
],
"atividades_cnae": [
"6201500"
],
"especialidades": [
"Software"
],
"tamanhos_empresa": [
"11-50",
"51-200"
],
"naturezas_juridicas": [
1,
2,
3
],
"tipos_trabalho": [
"Empresa Privada"
],
"data_fundacao": {
"data_inicio": "2010-01-01",
"data_fim": "2023-12-31"
},
"faixa_receita": {
"receita_minima": 100000,
"receita_maxima": 5000000
},
"incluir_mei": true,
"tem_cnpj": true,
"tem_email": true,
"tem_telefone": true,
"tem_linkedin": true
},
"url_webhook": "https://seusite.com/webhook"
}'{ "chave_cache": "abc123xyz", "total": 150, "resultados": [ { … } ] }
Request
Enriquece perfil de pessoa física individualmente com processamento assíncrono.
Custo: 1 crédito por registro enriquecido com sucesso
Dados retornados:
- Básicos: nome completo, CPF (quando disponível), idade, gênero, localização
- Contatos: telefones, emails, perfis públicos
- Vínculos empresariais: participações, cargos corporativos, CNPJs
- Histórico profissional: cargos, empresas, períodos
- Educação: cursos, instituições, níveis de escolaridade
A notificação de conclusão é enviada via webhook (se configurado).
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/persons/enrich
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/persons/enrich
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/persons/enrich \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"contato": {
"url_linkedin": "https://www.linkedin.com/in/exemplo",
"email": "exemplo@empresa.com",
"id_pessoa": 12345
},
"url_webhook": "https://seusite.com/webhook"
}'{ "id_processamento": "4cb319e3bd9544019b45fd56911fa160", "status": "completed", "total": 1, "sucesso": 1, "falhou": 0, "contatos": [ { … } ], "timestamp": 1760542724.0121257 }
Request
Enriquecimento em massa de pessoas físicas com processamento assíncrono e entrega via webhook.
Custo: 1 crédito por registro enriquecido com sucesso
Dados retornados: Mesmos do enriquecimento individual
Array de contatos para enriquecer
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/persons/enrich/bulk
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/persons/enrich/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/persons/enrich/bulk \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"contatos": [
{
"url_linkedin": "https://www.linkedin.com/in/exemplo",
"email": "exemplo@empresa.com",
"id_pessoa": 12345
}
],
"url_webhook": "https://seusite.com/webhook"
}'{ "job_id": 12345, "status": "requested", "total_contacts": 100 }
Request
Prospecção B2B de empresas usando dados públicos, registros oficiais e LinkedIn.
Modelo de cobrança:
- Primeira requisição (sem chave de cache): 1 crédito B2B
- Paginação (com chave de cache): 0 créditos
- Expiração do cache: 7 dias
REGRA IMPORTANTE: Ao preencher localizacoes, deixe estados vazio, e vice-versa.
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/companies/
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/companies/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/companies/ \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pagina": 1,
"por_pagina": 20,
"chave_cache": "abc123xyz",
"filtros_empresa": {
"nome_empresa": [
"Google Brasil Internet Ltda"
],
"localizacoes": [
"São Paulo, SP",
"Rio de Janeiro, RJ"
],
"estados": [
"SP",
"RJ"
],
"setores": [
"Tecnologia",
"Educação"
],
"atividades_cnae": [
"6201500"
],
"especialidades": [
"Software"
],
"tamanhos_empresa": [
"11-50",
"51-200"
],
"naturezas_juridicas": [
1,
2,
3
],
"tipos_trabalho": [
"Empresa Privada"
],
"data_fundacao": {
"data_inicio": "2010-01-01",
"data_fim": "2023-12-31"
},
"faixa_receita": {
"receita_minima": 100000,
"receita_maxima": 5000000
},
"incluir_mei": true,
"tem_cnpj": true,
"tem_email": true,
"tem_telefone": true,
"tem_linkedin": true
}
}'{ "chave_cache": "abc123xyz", "total": 250, "resultados": [ { … } ] }
Request
Enriquece perfil de empresa individualmente com processamento assíncrono.
Custo: 1 crédito por registro enriquecido
Dados retornados:
- Cadastro: razão social, nome fantasia, data de fundação, CNAEs
- Localização: endereço completo, cidade, estado, CEP, geolocalização
- Contatos: telefones, emails, website oficial
- Informações: setor, descrição, número de funcionários, links públicos
- Estrutura corporativa: sócios, administradores, percentuais de participação
- Histórico: ex-sócios e ex-funcionários
- Filiais e equipe atual
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/companies/enrich
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/companies/enrich
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/companies/enrich \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"contato": {
"url_linkedin": "https://www.linkedin.com/company/exemplo",
"cnpj": "12345678000199",
"id_empresa": 98765
},
"url_webhook": "https://seusite.com/webhook"
}'{ "id_processamento": "00000000000000000000000000000000", "status": "completed", "total": 1, "sucesso": 1, "falhou": 0, "contatos": [ { … } ], "timestamp": 1760632949 }
Request
Enriquecimento em massa de empresas com processamento assíncrono.
Custo: 1 crédito por registro enriquecido
Dados retornados: Mesmos do enriquecimento individual
Array de empresas para enriquecer
- Mock serverhttps://docs.datastone.com.br/_mock/api/b2b/companies/enrich/bulk
- Servidor de Produçãohttps://api.datastone.com.br/v1/b2b/companies/enrich/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.datastone.com.br/_mock/api/b2b/companies/enrich/bulk \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"contatos": [
{
"url_linkedin": "https://www.linkedin.com/company/exemplo",
"cnpj": "12345678000199",
"id_empresa": 98765
}
],
"url_webhook": "https://seusite.com/webhook"
}'{ "job_id": 12345, "status": "requested", "total_companies": 50 }
