Endereços

Descrição

Dataset que retorna endereços associados ao indivíduo consultado, incluindo atributos de classificação, recência, prioridade e validação, além de informações agregadas que facilitam análises de contato, segmentação e decisões automatizadas.

Para mais informações sobre contexto de negócio, aplicações e casos de uso, consulte a documentação de Contatos.

Nome técnico do dataset: addresses_extended.

Tabela de preços

Consultas Realizadas no MêsValor por consulta
1 - 10.000R$ 0,050
10.001 - 50.000R$ 0,048
50.001 - 100.000R$ 0,046
100.001 - 500.000R$ 0,044
500.001 - 1.000.000R$ 0,042
1.000.001 - 5.000.000R$ 34.000,00 (preço fixo)
5.000.001 e acimaEntre em contato

Chaves complementares relevantes

As chaves abaixo representam algumas das chaves complementares aceitas neste dataset, permitindo aumentar a qualidade da consulta, controlar a deduplicação de endereços e habilitar mecanismos de comparação entre endereços informados e os encontrados nas bases.

ChaveDescriçãoValores Possíveis
zipcodeCEP do endereço consultado. Pode ser utilizado em conjunto com addressnumber para melhorar a precisão da identificação do imóvel.CEP do endereço
addressnumberNúmero do endereço consultado. Pode ser utilizado em conjunto com zipcode para melhorar a precisão da identificação do imóvel.Número do endereço
addressEndereço consultado (logradouro e complemento, sem número ou CEP). Pode ser utilizado com withmatchrate{true} para comparação com endereços associados ao indivíduo.Tipologia e núcleo do endereço
returnonlydifferentaddressesRetorna apenas endereços diferentes dos informados (zipcode e addressnumber), desde que associados ao mesmo titular.true, false (Padrão: false)
withmatchrateIndica se deve ser calculada a similaridade entre o endereço informado (zipcode + addressnumber + address) e os endereços retornados. O resultado é apresentado no campo MatchRate, onde 100 indica correspondência exata.true, false (Padrão: false)

Para conhecer todas as chaves disponíveis e entender como combiná-las, consulte a seção Parâmetros de Consulta.

Filtros

Os filtros abaixo permitem refinar os resultados retornados por este dataset conforme características do endereço, como tipo, status, recência, prioridade, localização e natureza da associação.

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
TypeTipo de endereçoIgualwork, home
isratifiedSe está ratificadoIgualtrue, false
isactiveSe esta ativoIgualtrue, false
isrecentSe é recenteIgualtrue, false
ismainSe é principalIgualtrue, false
isindirectSe a associação é indiretaIgualtrue, false
stateSigla do estadoIgualRJ, SP, MG, ES, ...
zipcodeNúmero do CEPComeça comQualquer CEP completo ou primeiros x digitos

Limite

Este dataset permite limitar a quantidade de registros retornados utilizando o modificador .limit(x) no campo Datasets.

Para entender como aplicar filtros, limitar a quantidade de resultados, fazer paginação e personalizar o retorno dos dados, consulte a seção Personalizar Retorno.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto de requisição para consulta ao dataset na API de Pessoas. Para mais informações sobre cada parâmetro e sua utilização, consulte a página "Estrutura da Consulta" na seção "Primeiros Passos".

string
required

String que define os parâmetros de entrada da consulta, utilizada para informar os identificadores e filtros aplicáveis ao dataset.

string
required

String contendo os nomes técnicos dos datasets a serem consultados.

number

Número máximo de entidades retornadas na resposta, utilizado em consultas realizadas sem uma chave principal. Valor máximo permitido: 80

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json