# API de busca de pessoa por nome

> Versão em Markdown de https://datax.plus/api-busca-pessoa-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.

[Testar grátis por 24h](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#busca-nome)

● Teste grátis por 24 horas, sem cartão · depois, a partir de R$ 99/mês, sem fidelidade

```bash
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"}'
```

```javascript
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();
```

```python
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()
```

```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.

**POST** `https://api.datax.plus/v1/pessoas/busca`

- **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; com `true`, 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_nome` do [servidor MCP](https://datax.plus/docs/#mcp).

Por [Equipe DataX](https://datax.plus/) · Atualizada em 4 de novembro de 2026

| Campo | O que traz |
| --- | --- |
| `candidatos` | Lista das pessoas encontradas |
| `candidatos[].nome` | Nome da pessoa |
| `candidatos[].cpf` | CPF |
| `candidatos[].dataNascimento` | Data de nascimento |
| `candidatos[].uf` | Estado |

[Ver na documentação completa →](https://datax.plus/docs/#busca-nome)

## 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](https://datax.plus/#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](https://datax.plus/api-consulta-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](https://datax.plus/api-consulta-cpf/)**

  Dados cadastrais, telefones, e-mails e endereços da pessoa.

- **[API de telefone e e-mail por CPF](https://datax.plus/api-telefone-email-cpf/)**

  Só os contatos da pessoa, sem o restante da ficha.

- **[API de pessoas por endereço](https://datax.plus/api-pessoas-endereco/)**

  Pessoas ligadas a um CEP ou a um endereço específico.

[Ver todas as consultas na documentação →](https://datax.plus/docs/)

Guias: [telefone e e-mail por CPF →](https://datax.plus/guias/consultar-telefone-email-por-cpf-api/)

## Teste a busca por nome grátis por 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#busca-nome)