API de busca de pessoa por nome
Envie um nome e receba, em JSON, os candidatos com CPF, data de nascimento e UF. Depois, consulte a ficha ou os contatos do CPF certo. Cada busca consome 1 requisição do seu limite diário.
curl -X POST https://api.datax.plus/v1/pessoas/busca \
-H "api-key: $DATAX_KEY" \
-H "Content-Type: application/json" \
-d '{"nome": "MARIA SILVA OLIVEIRA", "uf": "SP"}'
const res = await fetch("https://api.datax.plus/v1/pessoas/busca", {
method: "POST",
headers: { "api-key": KEY, "Content-Type": "application/json" },
body: JSON.stringify({ nome: "MARIA SILVA OLIVEIRA", uf: "SP" }),
});
const data = await res.json();
import requests
r = requests.post(
"https://api.datax.plus/v1/pessoas/busca",
headers={"api-key": KEY},
json={"nome": "MARIA SILVA OLIVEIRA", "uf": "SP"},
)
data = r.json()
{
"candidatos": [
{
"nome": "MARIA SILVA OLIVEIRA",
"cpf": "12345678909",
"dataNascimento": "1988-03-14",
"uf": "SP"
}
]
}
Onde a busca por nome entra
-
Base sem CPF
Encontre o CPF de clientes que estão na sua base só com o nome, e siga para a ficha ou os contatos.
-
Conferência de cadastro
Compare a data de nascimento e a UF dos candidatos com o que o cliente informou.
-
Busca dentro do seu sistema
Ofereça a busca por nome: o usuário escolhe o candidato certo e o sistema consulta o CPF.
Requisição e resposta
O exemplo usa valores fictícios. A lista de candidatos pode trazer várias pessoas com nomes parecidos, ou vir vazia.
- Cabeçalho
api-key: a chave de API gerada no portal. Obrigatório em todas as chamadas.- Corpo (JSON)
nome: nome da pessoa. Obrigatório.uf: sigla do estado, para filtrar. Opcional.buscaAproximada: por padrão (false) a busca é pelo nome exato; comtrue, o primeiro nome vale como prefixo. Opcional.- Consumo
- 1 requisição do limite diário por busca.
- MCP
- Agentes de IA usam esta consulta pela ferramenta
buscar_pessoa_por_nomedo servidor MCP.
| Campo | O que traz |
|---|---|
candidatos | Lista das pessoas encontradas |
candidatos[]. | Nome da pessoa |
candidatos[]. | CPF |
candidatos[]. | Data de nascimento |
candidatos[]. | Estado |
Planos com a busca por nome
Cada consulta consome 1 requisição do limite diário. Ela está no teste grátis e em todos os planos, sem fidelidade e com pagamento por Pix. Ver todos os planos.
| Plano | Preço | Chamadas/dia | Chamadas/min | Custo por chamada |
|---|---|---|---|---|
| Teste 24 horas | Grátis | 20 no período | 20 | Grátis |
| Entrada | R$ 99/mês | 1.000 | 30 | R$ 0,0033 |
| Intermediário | R$ 299/mês | 5.000 | 120 | R$ 0,0020 |
| Avançado | R$ 599/mês | 20.000 | 300 | R$ 0,0010 |
O custo por chamada considera o uso de todo o limite diário por 30 dias.
Perguntas sobre a API de busca por nome
Como encontrar o CPF de uma pessoa pelo nome via API?
Envie o nome para POST /v1/pessoas/busca, com a sua chave no cabeçalho api-key. A resposta traz os candidatos com CPF, data de nascimento e UF.
Como funciona a busca aproximada?
Por padrão, buscaAproximada é false e a busca é pelo nome exato. Com true, o primeiro nome vale como prefixo.
Posso filtrar por estado?
Sim. Envie a sigla do estado no campo uf, como SP.
Como escolher o candidato certo?
Compare a data de nascimento e a UF com o que você já sabe sobre a pessoa. Depois, consulte a ficha do CPF escolhido.
Quanto custa?
Cada busca consome 1 requisição do limite diário do plano. A consulta está no teste grátis de 24 horas (20 chamadas) e em todos os planos: Entrada (R$ 99/mês, 1.000 chamadas/dia), Intermediário (R$ 299/mês, 5.000) e Avançado (R$ 599/mês, 20.000). Usando todo o limite diário por 30 dias, cada chamada sai por cerca de R$ 0,0033, R$ 0,0020 e R$ 0,0010, respectivamente. A busca consome 1 requisição mesmo quando traz vários candidatos.
Posso usar esses dados de acordo com a LGPD?
Os dados retornados são dados pessoais. Pela LGPD, cada uso precisa de uma finalidade legítima e de uma base legal, como o legítimo interesse ou a proteção do crédito, e cabe a cada empresa definir as duas para o seu caso. Na dúvida, fale com o seu jurídico.
Outras consultas da API
-
API de consulta de CPF
Dados cadastrais, telefones, e-mails e endereços da pessoa.
-
API de telefone e e-mail por CPF
Só os contatos da pessoa, sem o restante da ficha.
-
API de pessoas por endereço
Pessoas ligadas a um CEP ou a um endereço específico.