Portal Oficial - Instituto Nacional de Estatística

Portal Oficial - Instituto Nacional de Estatística

API Catálogo Indicadores

De forma simples e automatizada, o catálogo de indicadores permite aos utilizadores recolher e catalogar a informação relativa aos Indicadores publicados na Base de Dados.

Esta ferramenta foi desenvolvida para tornar o acesso aos dados estatísticos mais eficiente e intuitivo.

Estrutura do Endpoint

O endpoint segue a seguinte estrutura:

{host_url}/ine/xml_indic.jsp?opc=1&varcd={varcd_cod}&lang={lang}

Onde:

ParâmetroDescriçãoExemplo
host_url Endereço host do website do INE. https://www.ine.pt
varcd_cod Código do indicador. Deve ser um valor numérico com 7 algarismos. 0004167
lang Língua pretendida para o resultado da extração. Valores permitidos: "PT" (Português) ou "EN" (Inglês). PT

Exemplo Prático

https://www.ine.pt/ine/xml_indic.jsp?opc=1&varcd=0004167&lang=PT

Este exemplo retorna os dados do indicador com o código 0004167, em português.

Formato "XML" de Output

Exemplo:


<catalog>
  <extraction_date>Thursday, 15 March 2018, 02:35:14.499 PM</extraction_date>
  <source>INE - Instituto Nacional de Estatistica</source>
  <language>PT</language>
  <indicator id="0004167">
    <theme>População</theme>
    <subtheme>Estimativas de população</subtheme>
    <keywords>INE,População,(N.º),residente,População,Estimativas de população</keywords>
    <title>População residente (N.º)</title>
    <varcd>0004167</varcd>
    <description>População residente (N.º) por Local de residência, Sexo e Grupo etário (Por ciclos de vida); Anual - INE, Estimativas anuais da população residente</description>
    <geo_lastlevel>Distrito</geo_lastlevel>
    <dates>
      <last_period_available>S7A2016</last_period_available>
      <last_update>15-06-2017</last_update>
    </dates>
    <periodicity>Anual</periodicity>
    <update_type>D</update_type>
    <html>
      <bdd_url>https://www.ine.pt/xurl/indx/0004167/PT</bdd_url>
      <metainfo_url>https://www.ine.pt/xurl/metax/0004167/PT</metainfo_url>
    </html>
    <json>
      <json_dataset>https://www.ine.pt/ine/json_indicador/pindica.jsp?op=2&varcd=0004167&lang=PT</json_dataset>
      <json_metainfo>https://www.ine.pt/ine/json_indicador/pindicaMeta.jsp?varcd=0004167&lang=PT</json_metainfo>
    </json>
  </indicator>
</catalog>
            

Extracção Automática para Geração do Catálogo

Opções disponíveis: 

  1. Um indicador (opc=1): código do indicador + língua.

    Exemplo: https://www.ine.pt/ine/xml_indic.jsp?opc=1&varcd=0004167&lang=PT

  2. Catálogo Completo (opc=2): Extração do catálogo de indicadores completo, aproximadamente 10.000 indicadores (pode demorar algum tempo a gerar o ficheiro).

    Exemplo: https://www.ine.pt/ine/xml_indic.jsp?opc=2&lang=PT

  3. Grupo dos "Principais Indicadores" (opc=3): aproximadamente 260 indicadores (pode demorar algum tempo a gerar o ficheiro).

    Exemplo: https://www.ine.pt/ine/xml_indic.jsp?opc=3&lang=PT