API de pessoas por endereço
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.
curl "https://api.datax.plus/v1/pessoas/enderecos/busca?cep=01310100&numero=1000" \ -H "api-key: $DATAX_KEY"
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();
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()
{
"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.
- Cabeçalho
api-key: a chave de API gerada no portal. Obrigatório em todas as chamadas.- Query
- Informe
cep, oulogradourocomcidadeeestado. numeroebairro: 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_enderecodo servidor MCP.
| Campo | O que traz |
|---|---|
resultados | Lista das pessoas encontradas |
resultados[]., resultados[]. | Nome e CPF da pessoa |
resultados[]., resultados[]., resultados[]. | Logradouro, número e bairro |
resultados[]., resultados[]., resultados[]. | Município, UF e CEP |
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.
| 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
Dados cadastrais, telefones, e-mails e endereços da pessoa.
-
API de busca por nome
Candidatos com CPF, data de nascimento e UF.
-
API de telefone e e-mail por CPF
Só os contatos da pessoa, sem o restante da ficha.