Documentação Técnica

Informações Sócio-Demográficas

Descrição

O dataset de Informações Sócio-Demográficas retorna informações coletadas de diferentes fontes públicas de pesquisas com escopo regional, nacional, ou até mesmo mundial, utilizando as informações de contato do indivíduo para localizá-lo dentro da região relevante e então fazer a atribuição dos dados. Todas as informações retornadas são aproximações retiradas diretamente dessas pesquisas públicas. É retornada uma lista de "dados demográficos", que representam a extração de informações de uma pesquisa ou levantamento dessa natureza.

Origem da Informação

Todas as informações desse dataset são baseadas em pesquisas sócio-demográficos disponibilizados pelo governo ou por outras instituições, tais como o Censo e a PNAD.

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": "demographic_data",
    "q": "doc{CPF}"  
}  

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
dataoriginOrigem dos dadosIgualMTE, IBGE
dataagregationlevelNível de agregação dos dadosIgual--
datacountryPaísIgualBrasil, Argentina, Mexico, ...

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

{  
    "Datasets": "demographic_data.filter(dataorigin=MTE)",
    "q": "doc{CPF}"  
}  

Os atributos retornados são agrupados em faixas ou categorias discretas, descritas na tabela abaixo. Todas as estimativas de renda são retornadas em faixas de salários mínimos.

CampoValores Possíveis
EstimatedIncomeRange1 - ATE 2 SM, 2 - 2 A 4 SM, 3 - 4 A 10 SM, 4 - 10 A 20 SM, 5 - ACIMA DE 20 SM
EstimatedInstructionLevel01 - ANALFABETO, 02 - ATE 5.A INC, 03 - 5.A CO FUND, 04 - 6. A 9. FUND, 05 - FUND COMPL, 06 - MEDIO INCOMP, 07 - MEDIO COMPL, 08 - SUP. INCOMP, 09 - SUP. COMP, 10 - MESTRADO, 11 - DOUTORADO, 00 - ANALFABETO, 01 - CRECHE, PRE-ESCOLAR (MATERNAL E JARDIM DE INFANCIA), CLASSE DE ALFAB, 02 - ALFABETIZAAO DE JOVENS E ADULTOS, 03 - ANTIGO PRIMARIO (ELEMENTAR), 04 - ANTIGO GINASIO (MEDIO 1 CICLO), 05 - REGULAR DO ENSINO FUNDAMENTAL OU 1 GRAU (DA 1A 3A SERIE/ DO 1 AO 4 A, 06 - REGULAR DO ENSINO FUNDAMENTAL OU 1 GRAU (DA 4A SERIE/5 ANO), 07 - REGULAR DO ENSINO FUNDAMENTAL OU 1 GRAU (DA 5AA 8A SERIE/ DO 6 AO 9 , 08 - SUPLETIVO DO ENSINO FUNDAMENTAL OU DO 1 GRAU, 09 - ANTIGO CIENTIFICO, CLASSICO, ETC. (MEDIO 2 CICLO), 10 - REGULAR OU SUPLETIVO DO ENSINO MEDIO OU DO 2 GRAU, 11 - SUPERIOR DE GRADUACAO, 12 - ESPECIALIZACAO DE NIVEL SUPERIOR (MINIMO DE 360 HORAS)
SocialClassA, B, C, D, E
Language
Credentials
Click Try It! to start a request and see the response here!