# API de pessoas por endereço

> Versão em Markdown de https://datax.plus/api-pessoas-endereco/

Envie um CEP ou um endereço específico e receba, em JSON, as pessoas ligadas a ele, com nome e CPF. Buscas genéricas, como só a cidade ou só o estado, são recusadas. Cada consulta 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/#pessoas-endereco)

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

```bash
curl "https://api.datax.plus/v1/pessoas/enderecos/busca?cep=01310100&numero=1000" \
  -H "api-key: $DATAX_KEY"
```

```javascript
const query = new URLSearchParams({ cep: "01310100", numero: "1000" });
const res = await fetch(
  `https://api.datax.plus/v1/pessoas/enderecos/busca?${query}`,
  { headers: { "api-key": KEY } }
);
const data = await res.json();
```

```python
import requests

r = requests.get(
    "https://api.datax.plus/v1/pessoas/enderecos/busca",
    params={"cep": "01310100", "numero": "1000"},
    headers={"api-key": KEY},
)
data = r.json()
```

```json
{
  "resultados": [
    {
      "logradouro": "...",
      "numero": "1000",
      "bairro": "...",
      "municipio": "SÃO PAULO",
      "uf": "SP",
      "cep": "01310100",
      "nome": "MARIA S. OLIVEIRA",
      "cpf": "12345678909"
    }
  ]
}
```

## Onde a busca por endereço entra

- **Conferência de endereço**

  Confirme se o cliente está ligado ao endereço informado no cadastro.

- **Cobrança e recuperação de contato**

  Encontre o CPF de clientes que estão na sua base só com o endereço, e siga para os contatos.

- **Análise de cadastro**

  Compare o nome e o CPF encontrados com os dados informados antes de aprovar um cadastro.

## Requisição e resposta

O exemplo usa valores fictícios. A lista de resultados pode vir vazia quando nada é encontrado.

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

- **Cabeçalho**: `api-key`: a chave de API gerada no portal. Obrigatório em todas as chamadas.
- **Query**: Informe `cep`, ou `logradouro` com `cidade` e `estado`.
- `numero` e `bairro`: opcionais, para restringir o endereço.
- **Resposta**: JSON (`application/json`) com a lista de resultados.
- **Consumo**: 1 requisição do limite diário por chamada.
- **MCP**: Agentes de IA usam esta consulta pela ferramenta `pessoas_por_endereco` 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 |
| --- | --- |
| `resultados` | Lista das pessoas encontradas |
| `resultados[].nome`, `resultados[].cpf` | Nome e CPF da pessoa |
| `resultados[].logradouro`, `resultados[].numero`, `resultados[].bairro` | Logradouro, número e bairro |
| `resultados[].municipio`, `resultados[].uf`, `resultados[].cep` | Município, UF e CEP |

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

## Planos com a busca por endereço

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 pessoas por endereço

### Como buscar pessoas por endereço via API?

Chame `GET /v1/pessoas/enderecos/busca` com `cep`, ou com `logradouro`, `cidade` e `estado`. A resposta traz as pessoas ligadas ao endereço, com nome e CPF.

### Por que a minha busca foi recusada?

Buscas genéricas, como só a cidade ou só o estado, são recusadas. Informe o CEP, ou o logradouro com a cidade e o estado.

### Para que servem o número e o bairro?

São opcionais e restringem o resultado a um imóvel ou a uma parte do endereço.

### Quanto custa?

Cada consulta 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.

### 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 busca por nome](https://datax.plus/api-busca-pessoa-nome/)**

  Candidatos com CPF, data de nascimento e UF.

- **[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.

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

Guias: [como escolher uma API →](https://datax.plus/guias/como-escolher-api-cpf-cnpj/)

## Teste a busca por endereço 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/#pessoas-endereco)