Data Stone API (1.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

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

Autenticação

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/saldo

Webhooks

Sistema 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

Rate Limiting

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 Requests com bloqueio de 24 horas

Limite de Produto

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

Erros Comuns e Como Resolver

Erro 401 - API Key Inválida

{
  "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

Erro 401 - IP Não Autorizado

{
  "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

Erro 400 - Saldo Insuficiente

{
  "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.

Erro 429 - Limite de Requisições Excedido

{
  "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

Automação com n8n — Zero Código

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.

github.com/Data-Stone/n8n-nodes-datastone

Por que usar?

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

Instalação rápida

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 que está coberto

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

Templates prontos para importar

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`

Use como base para suas automações

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.

Ver todos os templates e instruções detalhadas

Download OpenAPI description

api.json

api.yaml

Servers

Mock server

https://docs.datastone.com.br/_mock/api

Servidor de Produção

https://api.datastone.com.br/v1

Consulta

Operações de consulta direta para pessoas físicas (CPF), empresas (CNPJ), validação de WhatsApp e verificação de saldo.

Operations

Prospecção B2B

Operações de prospecção e enriquecimento B2B para pessoas e empresas, incluindo filtros avançados, busca com autocomplete e enriquecimento em lote.

Operations

Enriquecimento

Operações de enriquecimento de dados em lote com layouts personalizáveis e processamento assíncrono.

Operations

Prospecção

Operações de prospecção com filtros geográficos e profissionais, incluindo contagem e geração de jobs de prospecção.

Operations

Auxiliares

Dados auxiliares como CNAE, CBO, geolocalização (estados, cidades, bairros) e setores empresariais.

Operations

Listar perfis de prospecção

Request

Retorna lista de perfis disponíveis para prospecção de pessoas.

Perfis são conjuntos predefinidos de características demográficas e comportamentais.

Security

ApiKeyAuth

curl -i -X GET \
  https://docs.datastone.com.br/_mock/api/persons/prospect/profile/ \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Perfis retornados com sucesso

Bodyapplication/json

nextstring or null

URL da próxima página (null se não houver)

Example: null

previousstring or null

URL da página anterior (null se não houver)

Example: null

countinteger

Total de perfis disponíveis

Example: 14

page_sizeinteger

Tamanho da página

Example: 20

resultsArray of objects

Lista de perfis

Response

application/json

{
  "next": null,
  "previous": null,
  "count": 14,
  "page_size": 20,
  "results": [
    { … }
  ]
}

Obter cidades

Request

Retorna cidades com base em critérios de pesquisa.

Formato de resposta: "Cidade - UF" (ex: "São Paulo - SP")

IMPORTANTE: O valor name retornado é o que deve ser enviado para prospecção.

Security

ApiKeyAuth

Query

namestring

Filtro por nome da cidade

Example: name=São Paulo

statestring

Filtro por estado (sigla UF)

Example: state=SP

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/geo/city/?name=S%C3%A3o+Paulo&state=SP' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Cidades retornadas com sucesso

Bodyapplication/jsonArray [

namestring

Nome da cidade no formato "Cidade - UF"

Example: "São Paulo - SP"

]

Response

application/json

[
  {
    "name": "São Paulo - SP"
  }
]

Obter bairros

Request

Retorna bairros com base em critérios de pesquisa.

Formato de resposta: "Bairro - Cidade - UF"

Security

ApiKeyAuth

Query

namestring

Filtro por nome do bairro

citystring

Filtro por cidade

statestring

Filtro por estado (sigla UF)

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/geo/neighborhood/?name=string&city=string&state=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bairros retornados com sucesso

Bodyapplication/jsonArray [

namestring

Nome no formato "Bairro - Cidade - UF"

Example: "Distrito de Roselândia - Bela Vista de Goiás - GO"

]

Response

application/json

[
  {
    "name": "Distrito de Roselândia - Bela Vista de Goiás - GO"
  }
]

Obter profissões (CBO)

Request

Retorna ocupações baseadas na Classificação Brasileira de Ocupações (CBO).

Suporta busca por código CBO ou descrição da profissão.

IMPORTANTE: O code retornado é o que deve ser usado em requisições de prospecção.

Security

ApiKeyAuth

Query

codestring

Código CBO

Example: code=999999

descriptionstring

Descrição da profissão

Example: description=EMPRESÁRIO

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/cbo/?code=999999&description=EMPRES%C3%81RIO' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Profissões retornadas com sucesso

Bodyapplication/jsonArray [

codestring

Código CBO a ser usado em prospecção

Example: "999999"

descriptionstring

Descrição da profissão

Example: "EMPRESÁRIO"

]

Response

application/json

[
  {
    "code": "999999",
    "description": "EMPRESÁRIO"
  }
]

Obter CNAEs

Request

Retorna classificações CNAE (Classificação Nacional de Atividades Econômicas).

Aceita código CNAE ou descrição.

IMPORTANTE: O code retornado é o que deve ser enviado para prospecção.

Security

ApiKeyAuth

Query

codestring

Código CNAE

Example: code=6201500

descriptionstring

Descrição do CNAE

Example: description=Desenvolvimento de software

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/cnae/?code=6201500&description=Desenvolvimento+de+software' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

CNAEs retornados com sucesso

Bodyapplication/jsonArray [

codestring

Código CNAE para usar em prospecção

Example: "6201500"

descriptionstring

Descrição detalhada do CNAE

Example: "Desenvolvimento de programas de computador sob encomenda"

]

Response

application/json

[
  {
    "code": "6201500",
    "description": "Desenvolvimento de programas de computador sob encomenda"
  }
]

Obter setores CNAE

Request

Retorna informações de setor CNAE.

Suporta filtro por código ou descrição do setor.

IMPORTANTE: A description retornada é o que deve ser enviada para prospecção.

Security

ApiKeyAuth

Query

codestring

Código do setor CNAE

descriptionstring

Descrição do setor

Example: description=Tecnologia

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/sector/cnae/?code=string&description=Tecnologia' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Setores retornados com sucesso

Bodyapplication/jsonArray [

codestring

Código do setor CNAE

Example: "62"

descriptionstring

Descrição a ser usada em prospecção

Example: "Tecnologia da Informação"

]

Response

application/json

[
  {
    "code": "62",
    "description": "Tecnologia da Informação"
  }
]

Data Stone API (1.0)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

Autenticação

Webhooks

Rate Limiting

Limite de Produto

Erros Comuns e Como Resolver

Erro 401 - API Key Inválida

Erro 401 - IP Não Autorizado

Erro 400 - Saldo Insuficiente

Erro 429 - Limite de Requisições Excedido

Automação com n8n — Zero Código

Por que usar?

Instalação rápida

O que está coberto

Templates prontos para importar

Use como base para suas automações

Consulta

Prospecção B2B

Enriquecimento

Prospecção

Auxiliares

Listar perfis de prospecção

Request

Responses

Was this helpful?

Obter cidades

Request

Responses

Was this helpful?

Obter bairros

Request

Responses

Was this helpful?

Obter profissões (CBO)

Request

Responses

Was this helpful?

Obter CNAEs

Request

Responses

Was this helpful?

Obter setores CNAE

Request

Responses

Was this helpful?

Data Stone API (1.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude