Documentação Técnica

Informações Financeiras

Descrição

O dataset de Informações Financeiras contém informações relacionadas com a vida financeira do indivíduo consultado. Ele combina informações calculadas por diferentes mecanismos de inferência com dados concretos extraídos de fontes públicas para tentar apresentar uma visão mais completa do indivíduo. Dentre os atributos retornados estão um conjunto de estimativas de renda, vindas de diferentes fontes, níveis de agregação, e modelos estatísticos, e uma estimativa do patrimônio total do indivíduo, além de um histórico da restituição do imposto de renda do mesmo.
Descrevemos abaixo de forma breve a metodologia de cálculo de cada uma das estimativas de renda:

  • IBGE: Essa estimativa de renda é calculada com base nos dados do Censo e da PNAD, de estatísticas gerais da população. A conversão das estimativas para o nível individual é realizada a partir das informações de endereço da pessoa, que permitem o mapeamento das pessoas nas diferentes regiões cobertas pelas pesquisas.
  • MTE: Essa estimativa de renda é calculada com base nos dados do programa de disseminação de informações estatísticas do trabalho (PDET). As informações estatísticas são combinadas com os dados de histórico profissional e com as informações de endereço da pessoa para se chegar em um valor de renda estimada.
  • BIGDATA: Essa estimativa de renda é calculada por um modelo estatístico desenvolvido pela BigData Corp., que combina as duas inferências descritas acima com outras informações contextuais do indivíduo para tentar obter um melhor resultado na estimativa de renda do indivíduo.
  • BIGDATA_V2: Essa estimativa de renda é uma evolução do modelo estatístico da BigDataCorp, combinando outras inferências com um conjunto completo de informações disponíveis por indivíduos e trabalhando por aproximações sucessivas para maximizar a cobertura e a assertividade do resultado.
  • COMPANY OWNERSHIP: Uma das principais falhas que observamos nas estimativas de renda é a sua aplicabilidade a indivíduos que não tem uma presença na economia formal (histórico profissional) e nem sinais tradicionais de renda, mas que possuem participação, direta ou indireta, em uma grande variedade de empresas. Essa inferência de renda procura avaliar exatamente esses casos, e fornecer uma visão específica desses casos, separada de outros indicadores.

Origem da Informação

Todas as inferências de renda são baseadas em dados sócio-demográficos disponibilizados pelo governo ou por instituições governamentais, ou então tem como origem modelos estatísticos desenvolvidos pela equipe da BigData Corp. Os dados sócio-demográficos podem ser acessados através do site do IBGE e através do Programa de Disseminação de Estatísticas do Trabalho.
As informações de restituição do imposto de renda tem como origem a consulta pública de restituição disponibilizada pela Receita Federal, que pode ser vista nesse link.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,050
10001 - 50000R$ 0,048
50001 - 100000R$ 0,046
100001 - 500000R$ 0,044
500001 - 1000000R$ 0,042
1000001 - 5000000R$ 34.000,00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCPF🛑 Obrigatório

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "financial_data",
    "q": "doc{CPF}"  
}  

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
taxreturns_yearAno de declaração do impostoIgual2015, 2017, 2018, ...
taxreturns_statusStatus da declaração do impostoIgualCREDITADA, SALDO INEXISTENTE DE IMPOSTO A PAGAR OU A RESTITUIR, IMPOSTO A PAGAR, SUA DECLARACAO JA FOI PROCESSADA, AGUARDANDO REAGENDAMENTO PELO CONTRIBUINTE ...

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "financial_data.filter(taxreturns_year=2015, 2017, 2018, ...)",
    "q": "doc{CPF}"  
}  

Todas as estimativas de renda são apresentadas na forma de faixas de sálarios mínimos. A estimativa de patrimônio é apresentada em faixas de Reais. Os valores possíveis dessas estimativas são descritos abaixo

CampoValores Possíveis
IncomeEstimatesSEM INFORMACAO, 1/2 A 1 SM, DE 1 A 1,5 SM, ATE 2 SM, 2 A 4 SM, 4 A 10 SM, 10 A 20 SM, ACIMA DE 20 SM
IncomeEstimates - BIGDATA_V2SEM INFORMACAO, 0 A 1 SM, 1 A 2 SM, 2 A 3 SM, 3 A 5 SM, 5 A 7 SM, 7 A 10 SM, 10 A 15 SM, 15 A 20 SM, ACIMA DE 20 SM
TotalAssetsABAIXO DE 100K, 100K A 250K, 250K A 500K, 500K A 1MM, 1 A 5MM, ACIMA DE 5MM
Language
Authorization
Click Try It! to start a request and see the response here!