Descrição
Dataset que retorna telefones associados a pessoas relacionadas ao indivíduo consultado, com atributos de classificação, validação, relacionamento e priorização. O retorno permite analisar contatos vinculados a familiares, parceiros, colegas ou outros tipos de relacionamento, apoiando análises de rede, 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: related_people_phones.
Tabela de preços
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10.000 | R$ 0,060 |
| 10.001 - 50.000 | R$ 0,057 |
| 50.001 - 100.000 | R$ 0,054 |
| 100.001 - 500.000 | R$ 0,051 |
| 500.001 - 1.000.000 | R$ 0,049 |
| 1.000.001 - 5.000.000 | R$ 40.000,00 (preço fixo) |
| 5.000.001 e acima | Entre em contato |
Chaves complementares relevantes
As chaves abaixo representam algumas das chaves complementares aceitas que permitem refinar a consulta ou restringir o retorno a tipos específicos de relacionamento entre pessoas.
| Chave | Descrição | Valores Possíveis |
|---|---|---|
| relationshiptype | Restringe o retorno aos telefones de pessoas que possuam o tipo de relacionamento informado | Tipos de relacionamento |
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 conforme características dos telefones e do tipo de relacionamento identificado.
| Campo | Descrição do filtro | Tipo do filtro | Valores Possíveis do Filtro |
|---|---|---|---|
| relationshiptype | Tipo de relacionamento entre a pessoa consultada e o titular do telefone | Igual | coworker, neighbor, brother, nephew, mother, son, household, grandson, spouse, relative, grandparent, uncle, cousin, father, partner, related |
| type | Tipo do telefone | Igual | mobile, work, home |
| isactive | Indica se o telefone está ativo | Igual | true, false |
| isrecent | Indica se o telefone é recente | Igual | true, false |
| ismain | Indica se o telefone é principal | Igual | true, false |
| isindonotcalllist | Indica se o telefone consta em listas de bloqueio | Igual | true, false |
| areacode | Código de área do telefone | Igual | 11, 21, 61, ... |
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.
Interpretando o campo ValidationStatus
ValidationStatusO campo ValidationStatus indica o resultado do processo de validação do número de telefone, refletindo a origem e a qualidade da informação verificada. Os possíveis valores e seus significados estão descritos na tabela abaixo.
| ValidationStatus | Descrição |
|---|---|
| FOUND IN ABRT | Número encontrado e validado na base da ABRT |
| NUMBER IN RANGE LIST | Formato válido, mas não validado junto à ABRT |
| NOT FOUND IN ABRT | Número não encontrado na base da ABRT |
| NUMBER NOT FOUND IN RANGE LIST | Número não encontrado na lista de faixas numéricas válidas |
| INVALID NUMBER LENGTH | O número possui comprimento inválido |
| AREA CODE DOESNT EXIST | O código de área informado não existe |
| INVALID NUMBER STRUCTURE | A estrutura do número é inválida |
| UNKNOWN | O status de validação não pôde ser determinado |
| (vazio) | O telefone ainda não passou pelo processo de validação |
| FOUND IN ALO BASE | Telefone válido na data da consulta. Atualmente não consultamos mais esta tabela — são dados históricos |
| NUMBER IN ALO LIST | Telefone válido na data da consulta. Atualmente não consultamos mais esta tabela — são dados históricos |
| NUMBER IN RANGE LIST BUT IS REPETITION OR SEQUENCE | Telefone válido na tabela da ABRT, mas com muitas repetições ou sequências numéricas, o que indica risco de ser uma informação incorreta. Para estes telefones, recomenda-se recorrer ao serviço de validação da relação documento/telefone junto às operadoras |
| NUMBER IS A SERVICE | O telefone é válido, mas trata-se de um número de serviço (ex: 0300, 0800), normalmente sem interesse para o cliente |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||