API de telefone e e-mail dos sócios de um CNPJ
Envie o CNPJ de uma empresa e receba, em JSON, os sócios pessoa física com nome, CPF, qualificação, telefones e e-mails. Cada consulta consome 1 requisição do seu limite diário, não importa quantos sócios a empresa tenha.
curl -X POST \ https://api.datax.plus/v1/empresas/11222333000181/socios \ -H "api-key: $DATAX_KEY"
{
"cnpj": "11222333000181",
"socios": [
{
"nome": "JOÃO P. LIMA",
"cpf": "12345678909",
"qualificacao": "Sócio-Administrador",
"telefones": ["+55119..."],
"emails": ["joao.lima@..."]
},
{
"nome": "ANA R. SOUZA",
"cpf": "11144477735",
"qualificacao": "Sócio",
"telefones": ["+55219..."],
"emails": ["ana.souza@..."]
}
]
}
Do CNPJ ao contato de quem decide, em uma chamada
-
01
Envie o CNPJ
Faça um POST com o CNPJ no caminho e a sua chave no cabeçalho
api-key. A chamada não tem corpo.POST /v1/empresas/{cnpj}/socios -
02
A DataX enriquece os sócios
A API identifica os sócios pessoa física no quadro societário da empresa e busca os telefones e e-mails de cada um.
socios[].telefones · socios[].emails -
03
Use no seu sistema
Grave os contatos no CRM, na ficha do cliente ou na sua plataforma. A resposta já vem pronta em JSON.
application/json
Requisição e resposta
As outras consultas da API, como a ficha do CNPJ e a do CPF, estão na documentação.
- Cabeçalho
api-key: a chave de API gerada no portal. Obrigatório em todas as chamadas.- Caminho
cnpj: o CNPJ da empresa, com 14 dígitos, só números.- Corpo
- Nenhum.
- Resposta
- JSON (
application/json) com o CNPJ consultado e a lista de sócios. - Consumo
- 1 requisição do limite diário por consulta, com qualquer número de sócios.
| Campo | O que traz |
|---|---|
cnpj | CNPJ consultado |
socios | Lista dos sócios pessoa física da empresa |
socios[]. | Nome do sócio |
socios[]. | CPF do sócio |
socios[]. | Qualificação no quadro societário, como Sócio-Administrador |
socios[]. | Telefones encontrados para o sócio |
socios[]. | Telefones com informações adicionais de cada número |
socios[]. | E-mails encontrados para o sócio |
Planos com a consulta de sócios
Cada consulta de sócios consome 1 requisição, mesmo que a empresa tenha vários sócios. O plano Entrada (R$ 99/mês) é só de pessoa física e não inclui essa consulta. Ver todos os planos.
| Plano | Preço | Chamadas/dia | Chamadas/min |
|---|---|---|---|
| Teste 24 horas | Grátis | 20 no período | 20 |
| Intermediário RECOMENDADO | R$ 299/mês | 5.000 | 120 |
| Avançado | R$ 599/mês | 20.000 | 300 |
Onde a consulta de sócios entra
-
Prospecção B2B
Chegue a quem decide: o telefone e o e-mail dos sócios-administradores de cada empresa da sua lista.
-
Enriquecimento de CRM
Complete contas e leads de empresas com os contatos dos sócios assim que o CNPJ entra no CRM.
-
Plataformas SaaS
Ofereça o enriquecimento de sócios como recurso extra da sua plataforma, integrado por API.
-
Cadastro de clientes PJ
Saiba quem são os sócios de um novo cliente empresa e como falar com eles.
Perguntas sobre a API de sócios
Quais dados a API de sócios retorna?
Para cada sócio pessoa física da empresa: nome, CPF, qualificação no quadro societário (como Sócio-Administrador), telefones e e-mails encontrados. A resposta vem em JSON, junto com o CNPJ consultado.
Quanto custa consultar os sócios de um CNPJ?
Cada consulta consome 1 requisição do limite diário do plano, não importa quantos sócios a empresa tenha. A consulta está no teste grátis de 24 horas (20 chamadas) e nos planos Intermediário (R$ 299/mês, 5.000 chamadas/dia) e Avançado (R$ 599/mês, 20.000 chamadas/dia).
A API traz sócios que são empresas?
A consulta enriquece os sócios pessoa física, que são os que têm telefone e e-mail pessoais. Para ver o quadro societário completo e os dados cadastrais da empresa, use a ficha do CNPJ: GET /v1/empresas/{cnpj}.
Todo sócio vem com telefone e e-mail?
Nem sempre: alguns sócios não têm telefone ou e-mail encontrado. Por isso, no seu código, trate telefones e emails como listas que podem vir vazias.
Como consultar muitos CNPJs?
Faça uma chamada por CNPJ, respeitando o limite por minuto do plano: 120 chamadas/min no Intermediário e 300 no Avançado. O guia de sócios pelo CNPJ tem um exemplo em Python que percorre uma lista de CNPJs.
Posso usar os contatos para prospecção?
Os contatos dos sócios são dados pessoais. Use-os com uma finalidade legítima e clara, ofereça a opção de não receber mais mensagens e evite disparos em massa. Na dúvida sobre a base legal da LGPD no seu caso, fale com o seu jurídico.
Como começar?
Crie sua conta no portal, comece pelo teste grátis de 24 horas, gere a chave de API e faça a primeira chamada com um CNPJ.