API › Location › Renda Pessoal Dinâmica (PDF) # Renda Pessoal Dinâmica Distribuição contínua da renda pessoal mensal no entorno de qualquer coordenada, estimada por modelos proprietários sobre Censo 2022, PNAD Contínua e IPCA. Com filtros opcionais de gênero, idade, responsável pelo domicílio e data de referência — e comparação direta de um valor de renda contra o perfil da região. Categoria Location Cobertura Todo o território nacional Fonte IBGE (Censo + PNAD Contínua) + ML Atualização Mensal Filtros Gênero · Idade · Responsável · Data Nesta página Aplicações Como ler, em linguagem simples Conceito Formas de consulta Entradas Exemplos Atributos retornados Detalhes técnicos Limitações **Como percorrer esta página:** quem vai **usar em política** começa por Como ler, em linguagem simples · quem vai **modelar** segue direto para [o caso de Análise de Crédito](<../caso_de_uso/caso_uso_analise_de_credito.html>) Para que serve ## Aplicações A Renda Dinâmica vai além da faixa e percentil da Renda Estática: entrega a distribuição estatística completa da renda do entorno, com filtros demográficos e comparação direta de valores. É a ferramenta adequada quando se precisa responder "esta renda específica é compatível com o perfil desta região?" #### Verificação de Renda Declarada Compare a renda informada pelo solicitante com a distribuição de renda do entorno. Percentil (CDF) muito alto — renda muito acima do entorno — levanta questão de plausibilidade cadastral e sugere pedir comprovação. Percentil muito baixo em região de renda alta indica orçamento comprimido pelo custo de vida local e sugere revisar limite e comprometimento. Nenhum dos extremos é negativa automática. #### Análise de Crédito por Perfil Filtre por gênero, idade e responsável pelo domicílio para avaliar a renda esperada de um perfil específico na região — não apenas a média geral. #### Feature Engineering Avançado Use z-score, CDF, desvio padrão e quartis como features em modelos preditivos. A riqueza estatística permite capturar heterogeneidade que uma simples faixa de SM não expressa. #### Análise Temporal Consulte a distribuição de renda em diferentes datas (a partir de janeiro de 2022) para observar evolução do perfil socioeconômico ou validar renda em período retroativo. #### Open Finance — renda observada Cruze a renda observada em extratos e movimentação bancária com a distribuição do endereço. Um valor observado no percentil intermediário do entorno é coerente; muito acima ou muito abaixo pede leitura complementar antes de reajustar limite. #### Thin file — proponente sem histórico Para quem não tem histórico em bureau, a distribuição do endereço estabelece uma referência de comparação: percentil e amostra do entorno permitem posicionar a renda declarada dentro de uma faixa esperada, em vez de decidir só pela ausência de dado. #### Bureaus divergentes — desempate territorial Quando dois bureaus devolvem estimativas diferentes para a mesma pessoa, o percentil do endereço funciona como referência independente. **Uso com cuidado:** se algum dos bureaus incorpora sinais geográficos na estimativa, a comparação carrega circularidade — considere a Renda Dinâmica como um dos pesos, não como árbitro. Sem estatística ## Como ler, em linguagem simples A resposta traz um **percentil** : de cada 100 pessoas com renda no entorno do endereço, quantas ganham menos que o valor informado. É a leitura pronta para uso em política de crédito, verificação cadastral e análise de plausibilidade — sem passar por estatística. O mesmo percentil também aparece em uma escala centrada em zero, útil para modelos, mas quem só quer _ler_ não precisa dela. Um exemplo direto: você informa uma renda declarada de R$ 10.000 e a resposta traz percentil 88. Leia como _"de cada 100 pessoas com renda neste entorno, 88 ganham menos que o declarado"_. Três faixas cobrem a maior parte dos casos: Renda abaixo do entorno #### Percentil baixo (< 15) De cada 100 pessoas com renda no entorno, menos de 15 ganham igual ou abaixo do valor informado. A renda declarada está entre as mais baixas da região. **O que fazer** Em região de renda alta, pode indicar orçamento comprimido pelo custo de vida local — revisar comprometimento e limite. Não é motivo, por si só, para recusa. Renda próxima do entorno #### Percentil intermediário (15–85) A renda informada está dentro da faixa que a maior parte das pessoas do entorno ocupa. É a leitura mais comum e a menos informativa isoladamente. **O que fazer** Seguir a política padrão. O sinal territorial aqui é fraco — a decisão fica com os demais atributos do proponente. Renda acima do entorno #### Percentil alto (> 85) De cada 100 pessoas com renda no entorno, mais de 85 ganham menos que o valor informado. A renda declarada está entre as mais altas da região. **O que fazer** Levanta questão de plausibilidade — pedir comprovação de renda. Um valor muito descolado do entorno pode ser real, mas merece verificação. **Limites de leitura.** O percentil descreve a _região_ , não a pessoa. Duas pessoas com o mesmo salário em endereços diferentes recebem percentis diferentes, e isso é o que a métrica quer mostrar. Não use como fundamento único de recusa: combine com bureaus, comprovação e política interna. Filtros muito estreitos (ex.: idade = 100 anos) reduzem a amostra e a leitura perde precisão — o campo `renda_pessoas_com_renda_qtde` devolve o tamanho da amostra que sustentou o cálculo. Entendendo o dado ## Conceito O dado descreve a renda pessoal mensal no entorno como uma distribuição contínua, estimada por modelos proprietários sobre Censo 2022, PNAD Contínua e IPCA. Diferente da Renda Estática (que retorna faixa e percentil pré-calculados), a Renda Dinâmica permite aplicar filtros demográficos, informar uma data de referência e comparar diretamente um valor de renda contra a distribuição da região — devolvendo percentil (CDF) e o mesmo percentil expresso em escala de desvios-padrão (z-score). PDF / CDF #### Distribuição Completa A renda é modelada como uma distribuição contínua. O retorno inclui média, mediana, quartis, desvio padrão, mínima e máxima — permitindo entender a dispersão e a forma da distribuição, não apenas um ponto central. Filtros Demográficos #### Segmentação por Perfil Gênero, idade aproximada e condição de responsável pelo domicílio refinam a amostra. Útil para comparar a renda de um indivíduo específico com pessoas de perfil semelhante na mesma região. Renda Comparada #### Posição na Distribuição Ao informar um valor de renda, o retorno inclui o CDF (% de pessoas com renda inferior), o z-score (desvio em relação à média) e a PDF (probabilidade pontual). Responde diretamente: "esta renda é compatível com a região?" ### Como interpretar o z-score O z-score expressa o percentil (CDF) em escala de desvios-padrão (_normal score_). Carrega a mesma informação do percentil, em escala centrada em zero — conveniente para modelos que esperam variável centrada. Não é o desvio da renda comparada em relação à média da região: é uma transformação do próprio percentil, coerente com a leitura em quartis. Faixas de leitura, com o percentil aproximado equivalente: z ≈ 0 Renda próxima da mediana do entorno (percentil ≈ 50). z < −1 Renda abaixo do entorno (percentil < 16). z > +1 Renda acima do entorno (percentil > 84). z < −2 ou z > +2 Renda atípica (percentil < 2,5 ou > 97,5) — divergência relevante que merece leitura em contexto. Como chegar até o dado ## Formas de consulta A Renda Dinâmica é calculada sobre uma **coordenada**. Você chega até ela por **quatro caminhos** , conforme o que sua esteira já tem em mãos: coordenada, coordenada com os demais pilares geográficos, endereço ou CNPJ. Os caminhos de endereço e de CNPJ passam por uma etapa de geocodificação — a coordenada usada no cálculo é derivada dela, e a qualidade do resultado herda a qualidade dessa resolução. Formas de consulta da Renda Dinâmica Quatro entradas possíveis. Coordenada e coordenada com agregador entram direto no cálculo. Endereço e CNPJ passam antes por uma etapa de geocodificação que os converte em coordenada. O cálculo devolve três blocos: estatísticas do entorno, renda comparada e amostra. O que você tem O que volta Coordenada lat e lng em WGS84 entrada direta Coordenada, com agregador renda junto de favelas, prisão, fronteira e demais pilares Endereço texto livre ou campos passa pela geocodificação CNPJ somente o número passa pela geocodificação entra direto no cálculo entra direto no cálculo Geocodificação o endereço vira uma coordenada qualidade herdada Renda Dinâmica cálculo sobre a coordenada Estatísticas do entorno mediana, média, quartis, desvio Renda comparada percentil e z-score do valor informado Amostra quantidade de pessoas que sustenta o cálculo Formas de consulta da Renda Dinâmica Mesma informação da versão ampla, empilhada: coordenada e coordenada com agregador entram direto no cálculo; endereço e CNPJ passam por geocodificação; o cálculo devolve três blocos. O que você tem Coordenada lat e lng em WGS84 · entrada direta Coordenada, com agregador renda com favelas, prisão, fronteira Endereço texto livre ou campos via geocodificação CNPJ somente o número via geocodificação Geocodificação o endereço vira uma coordenada qualidade herdada pelo cálculo entra direto Renda Dinâmica cálculo sobre a coordenada O que volta Estatísticas do entorno mediana, média, quartis, desvio Renda comparada percentil e z-score do valor informado Amostra quantidade de pessoas que sustenta o cálculo Quatro caminhos, todos em produção. Caminhos relativos à base `https://api.prismadata.io/v1`. O que você tem | Consulta individual | Consulta em lote | Lote máximo ---|---|---|--- Coordenadalat e lng em WGS84 | `GET /location/personal_income_pdf` | `POST /location/batch/personal_income_pdf` | 1.024 Coordenada, com os demais pilares geográficosrenda junto do restante do agregador | `GET /location/aggregator?personal_income_pdf=true` | `POST /location/batch/aggregator?personal_income_pdf=true` | 1.024 Endereçotexto livre ou campos estruturados | `GET /location/geocoder/aggregator?personal_income_pdf=true` | `POST /location/batch/geocoder/aggregator?personal_income_pdf=true` | 1.024 CNPJdados cadastrais e renda do endereço da empresa | `GET /cnpj/{cnpj}/enriched?personal_income_pdf=true` | `POST /cnpj/batch/enriched` · `flags.personal_income_pdf=true` no corpo | 256 * **Filtros e comparação valem para todos os caminhos** Os parâmetros `income_compared`, `gender`, `age`, `is_responsible` e `date_income` podem ser enviados nas quatro variantes. No agregador e no caminho de CNPJ eles são recebidos junto do restante da requisição e propagados para o cálculo da renda. * **Por endereço e por CNPJ, a coordenada vem de geocodificação** O resultado herda a qualidade do geocoder — um endereço mal cadastrado produz uma coordenada imprecisa, e o cálculo da distribuição sobre ela não tem como sinalizar isso. No caminho de CNPJ, a própria resposta traz com que confiança o endereço foi resolvido, em `prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao` e no score numérico correspondente, junto de `prismadata__pessoa_juridica__endereco_existe` e `prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder`. A coordenada usada no cálculo também volta em `latitude` e `longitude`, o que torna o resultado auditável ponto a ponto. * **Sem coordenada, sem bloco de renda** Quando o endereço não produz coordenada geocodificável — endereço textual sem correspondência, CNPJ com endereço cadastral inválido — a resposta traz os demais campos disponíveis (cadastrais, no caminho de CNPJ) sem o bloco `prismadata__personal_income_pdf__*`. A ausência do bloco é a sinalização de que não houve coordenada para calcular. Request ## Parâmetros de Entrada `lat` float Latitude WGS84 do ponto a ser analisado. `lng` float Longitude WGS84 do ponto a ser analisado. #### Parâmetros opcionais `income_compared` float Valor de renda mensal (em R$) a ser comparado contra a distribuição da região. Quando informado, o retorno inclui `renda_comparada_cdf`, `renda_comparada_pdf` e `renda_comparada_z_score`. `gender` string Filtra a amostra por gênero: `"M"` (masculino) ou `"F"` (feminino). Se omitido, considera ambos os gêneros. `age` int Idade aproximada para filtrar pessoas com faixa etária próxima. Não é um filtro exato — o modelo seleciona pessoas em faixa etária vizinha à informada. `is_responsible` bool Filtra entre responsáveis pelo domicílio (`true`) ou não-responsáveis (`false`). Responsável é quem é reconhecido como líder da unidade doméstica pelos demais moradores. `date_income` date Data de referência para análise (`YYYY-MM-DD`). Aceita datas a partir de janeiro de 2022. Se omitida, utiliza a data atual. Na prática ## Exemplos Três cenários em Belo Horizonte mostram como filtros e localização mudam completamente a interpretação de uma mesma renda de R$ 10.000. Bairro nobre sem filtros — Lourdes, BH -19.93442, -43.94289 income_compared = 10000 _[Imagem: Mapa: Bairro Lourdes, BH — bairro nobre]_ { "qtde_pessoas": 485.0, "qtde_pessoas_sem_renda": 119.0, "renda_comparada_cdf": 21.624639290067826, "renda_comparada_pdf": 0.000054327178840454175, "renda_comparada_z_score": -0.7849331137654249, "renda_media_pessoas": 13333.191698804743, "renda_pessoas_com_renda_desvio_padrao": 10272.67510836109, "renda_pessoas_com_renda_maxima": 69123.23121828807, "renda_pessoas_com_renda_media": 17668.300475192078, "renda_pessoas_com_renda_mediana": 21002.905178527595, "renda_pessoas_com_renda_minima": 813.4884030701737, "renda_pessoas_com_renda_primeiro_quartil": 8969.07389667755, "renda_pessoas_com_renda_qtde": 366.0, "renda_pessoas_com_renda_terceiro_quartil": 24106.351176425094, "renda_total": 6466597.973920301, "renda_total_m2": 324.0685594584635 } Das 485 pessoas estimadas na vizinhança, 366 possuem renda. A renda média (com renda) é de R$ 17.668 e a mediana de R$ 21.003. Uma renda de R$ 10.000 é superior à de apenas 21,6% das pessoas da região (CDF), com z-score de −0.78 — abaixo do esperado para o Bairro de Lourdes, mas não atípica. Mesmo bairro, perfil específico — Lourdes, BH -19.93442, -43.94289 income_compared = 10000 gender = M age = 60 is_responsible = true _[Imagem: Mapa: Bairro Lourdes, BH — mesmo ponto, perfil filtrado]_ { "qtde_pessoas": 24.0, "qtde_pessoas_sem_renda": 0.0, "renda_comparada_cdf": 0.14140972301399285, "renda_comparada_pdf": 0.0000013802452168620837, "renda_comparada_z_score": -2.9858195845015816, "renda_media_pessoas": 28760.04573593453, "renda_pessoas_com_renda_desvio_padrao": 9911.730593796548, "renda_pessoas_com_renda_maxima": 66957.29112554113, "renda_pessoas_com_renda_media": 28760.04573593453, "renda_pessoas_com_renda_mediana": 26377.136111532138, "renda_pessoas_com_renda_minima": 20629.07223797445, "renda_pessoas_com_renda_primeiro_quartil": 23662.89043252312, "renda_pessoas_com_renda_qtde": 24.0, "renda_pessoas_com_renda_terceiro_quartil": 29128.37015272398, "renda_total": 690241.0976624287, "renda_total_m2": 34.59089912510599 } Com o filtro de homens de ~60 anos responsáveis pelo domicílio, a amostra cai para 24 pessoas — todas com renda. A renda média sobe para R$ 28.760 e a mínima estimada é R$ 20.629. Agora, R$ 10.000 é superior à de apenas 0,14% das pessoas deste perfil, com z-score de −2.99 — uma renda **muito atípica** para o perfil na região. Sinal relevante para verificação cadastral. Classe média baixa, mesmo perfil — Venda Nova, BH -19.81718, -43.95872 income_compared = 10000 gender = M age = 60 is_responsible = true _[Imagem: Mapa: Venda Nova, BH — classe média baixa]_ { "qtde_pessoas": 19.0, "qtde_pessoas_sem_renda": 0.0, "renda_comparada_cdf": 99.08922617796617, "renda_comparada_pdf": 0.0000037831617063243673, "renda_comparada_z_score": 2.3612086969235446, "renda_media_pessoas": 2665.475128467721, "renda_pessoas_com_renda_desvio_padrao": 1929.9002585172097, "renda_pessoas_com_renda_maxima": 7499.847248306218, "renda_pessoas_com_renda_media": 2665.475128467721, "renda_pessoas_com_renda_mediana": 2043.3624938113708, "renda_pessoas_com_renda_minima": 406.0215586608711, "renda_pessoas_com_renda_primeiro_quartil": 1145.144691489582, "renda_pessoas_com_renda_qtde": 19.0, "renda_pessoas_com_renda_terceiro_quartil": 3816.00660097579, "renda_total": 50644.0274408867, "renda_total_m2": 0.3957067369495203 } Mesmo perfil (homem, ~60 anos, responsável), mas em Venda Nova. A renda média cai para R$ 2.665 e a máxima estimada é R$ 7.500. Agora, os mesmos R$ 10.000 superam 99% das pessoas do perfil na região, com z-score de +2.36 — renda **muito acima** do esperado. O contraste com Lourdes (z-score −2.99 vs +2.36 para a mesma renda) demonstra o poder dos filtros combinados com localização. Response ## Atributos Retornados O retorno é organizado em quatro grupos: **população** (contagem de pessoas), **distribuição da renda** (estatísticas descritivas), **comparação** (quando `income_compared` é informado) e **agregados territoriais**. População qtde_pessoas Estimativa da quantidade de pessoas na vizinhança do ponto (considerando filtros aplicados). qtde_pessoas_sem_renda Estimativa de pessoas na região que não possuem renda mensal. renda_pessoas_com_renda_qtde Quantidade de pessoas que possuem renda mensal na região (considerando filtros). Distribuição da Renda renda_media_pessoas Renda média mensal considerando **todas** as pessoas da região, inclusive sem renda (que tendem a reduzir este valor). renda_pessoas_com_renda_media Renda média mensal considerando apenas pessoas com renda. renda_pessoas_com_renda_mediana Valor que divide a população com renda entre os 50% mais ricos e os 50% mais pobres. renda_pessoas_com_renda_primeiro_quartil Valor que separa os 25% com menor renda (Q1) — limite superior do quartil inferior. renda_pessoas_com_renda_terceiro_quartil Valor que separa os 25% com maior renda (Q3) — limite inferior do quartil superior. renda_pessoas_com_renda_desvio_padrao Desvio padrão da distribuição de renda. Valores menores indicam renda mais homogênea; maiores, mais dispersa. renda_pessoas_com_renda_minima Estimativa da renda mínima mensal na região (considerando apenas pessoas com renda). renda_pessoas_com_renda_maxima Estimativa da renda máxima mensal na região (considerando apenas pessoas com renda). Renda Comparada renda_comparada_cdf Percentual de pessoas da região com renda inferior à renda comparada (função de distribuição acumulada). Ex: 21.6 significa que 21,6% da região tem renda menor. renda_comparada_z_score Desvio da renda comparada em relação à renda média da região, em unidades de desvio padrão. Valores positivos = renda acima da média; negativos = abaixo. Magnitude indica intensidade do desvio. renda_comparada_pdf Valor pontual da distribuição no ponto da renda comparada. Retornado apenas quando `income_compared` é informado. Não é probabilidade em si — é uma altura relativa da distribuição no ponto; use o percentil (`renda_comparada_cdf`) para leitura de posição. Agregados Territoriais renda_total Estimativa da renda nominal total da região — soma da renda mensal de todos os indivíduos. renda_total_m2 Renda total dividida pela área da região (em m²). Valores altos indicam alta concentração espacial de renda — tipicamente regiões verticalizadas e densas. Referência ## Detalhes Técnicos #### Fontes * IBGE — Censo Demográfico 2022 * IBGE — PNAD Contínua (microdados trimestrais) * IBGE — IPCA (atualização de valores nominais) * Algoritmos de inferência com Machine Learning (PrismaData) #### Cobertura Todo o território nacional. A precisão é maior em áreas urbanas com alta densidade populacional. Filtros muito restritivos (ex: idade = 100 anos) reduzem a amostra e consequentemente a confiabilidade. #### Atualização * Mensal: recalibração com IPCA e salário mínimo vigente * Trimestral: incorporação de microdados da PNAD Contínua * Série histórica: consultas retroativas a partir de jan/2022 #### Metodologia Distribuição contínua estimada por modelos proprietários sobre Censo 2022, PNAD Contínua e IPCA. Variáveis geoespaciais, sociodemográficas e econômicas. Calibrada e validada com benchmarks públicos. Atenção ## Limitações #### Considere ao utilizar * Os valores são estimativas baseadas em modelagem estatística — não refletem a renda individual de nenhum morador específico. Devem ser utilizados como sinal complementar. * A precisão diminui com a quantidade e a restritividade dos filtros aplicados. Filtros muito estreitos (ex: idade = 100 anos) geram amostras pequenas com menor confiabilidade. * O filtro de idade não é exato: seleciona pessoas em faixa etária próxima à informada, não exatamente com a idade solicitada. * A precisão diminui em áreas de baixa densidade populacional ou com grande heterogeneidade socioeconômica intra-setor. * Os campos `renda_comparada_*` só são retornados quando o parâmetro `income_compared` é informado na request. * Consultas retroativas (parâmetro `date_income`) anteriores a janeiro de 2022 não são suportadas. ## Pronto para testar? Solicite acesso à sandbox da API de Renda Dinâmica e compare rendas contra o perfil real de qualquer região do Brasil. [ Solicitar acesso ]()