API del Banco de Indicadores

La API de Indicadores del INEGI permite consultar los datos y metadatos de los indicadores disponibles a nivel nacional, por entidad federativa y municipio. Puede utilizar la API para crear aplicaciones que muestren la información directamente de las bases de datos del INEGI en el preciso momento en que se actualiza.

Listado de indicadores disponibles

Enseguida se muestran los indicadores disponibles organizados por temas y subtemas, a la derecha de cada indicador se presenta su clave.

Guía para desarrolladores
Introducción

Bienvenido a la documentación para desarrolladores del API de Indicadores del INEGI. El INEGI se une a la iniciativa de datos de libre acceso con el objetivo de ampliar la disponibilidad de la información para los usuarios.

Audiencia

Esta documentación está dirigida para los desarrolladores familiarizados con la programación JavaScript y conocimientos de programación orientada a objetos.

Parámetros de la API
Indicador

El primer paso que se debe realizar para obtener información de la API es seleccionar el indicador e identificar su clave. Esto lo puede realizar consultando el "Constructor de consultas".

Área geográfica

Puede ser nacional [00], por entidad federativa [99] o por municipio [999], dependiendo de cada indicador.

Idioma

La información está disponible en español [es] e inglés [en].

Dato más reciente o Serie histórica

Puede consultarse solo el dato más reciente [true] o la serie histórica completa [false].

Formato

Se ofrece la información en 3 tipos de formatos: JSON [json], JSONP [jsonp] o XML [xml].

Token

Para utilizar la API es necesario mandarle un token válido, el cual puede obtener al registrarse aquí.

Cómo utilizar la API

Para consultar la API se envían los parámetros directamente en la URL, por ejemplo:

http://www3.inegi.org.mx/sistemas/api/indicadores/v1/Indicador/1002000001/01/es/false/xml/[Aquí va tu Token]

Estos son los datos que regresa la URL anterior:

imagen de ejemplo de los datos que regresa la URL anterior

Preguntas

Constructor de consultas

Obtener datos de la serie histórica del indicador de Población total, de la entidad de Aguascalientes, en idioma español, en formato JSON.

Parámetros:
  • Indicador: 1002000001
  • Área geográfica: 01
  • Idioma: es
  • Dato más reciente: False (para este caso se solicita la serie histórica completa)
  • Formato: json
  • Token: [Aquí va tu Token]

Consulta de la API

La API se consultaría mediante la siguiente URL:

http://www3.inegi.org.mx/sistemas/api/indicadores/v1/Indicador/1002000001/01/es/false/json/[Aquí va tu Token]


Estos son los datos que regresa la URL anterior:



Presentación de la información utilizando HTML y Javascript

Enseguida se muestra un ejemplo para presentar la información en una página web en forma de tabla.

Población total (Aguascalientes,Estatal)

Año Población
1910 120511
1921 107581
1930 132900
1940 161693
1950 188075
1960 243363
1970 338142
1980 519439
1990 719659
1995 862720
2000 944285
2005 1065416
2010 1184996

Código
                                                    <!DOCTYPE html>
                                                    <html xmlns="http://www.w3.org/1999/xhtml">
                                                    <head>    
                                                        <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
                                                        <title></title>    
                                                        <script src="Scripts/jquery-1.10.2.js"></script>
                                                        <script type="text/javascript" src="js/llamarAPI.js"></script>
                                                        <style>
                                                            .tableClass{
                                                                border-collapse:collapse;
                                                                border:1px solid black
                                                            }
                                                        </style>
                                                    </head>
                                                    <body onload="llamarAPI();">
                                                        <div id="divTablaDatos">
                                                        </div>
                                                    </body>
                                                    </html>
                                            
                                                var urlApi = "http://www3.inegi.org.mx/sistemas/api/indicadores/v1/Indicador/1002000001/01/es/false/json/[Aquí va tu Token]";
                                                $(document).ready(function (){ 
                                                    $.getJSON( urlApi, function( json ) { 
                                                        var nombreIndicador = json.MetaData.Name ; 
                                                        var nomEntidad = json.MetaData.Region;
                                                        var codigoHtml = '<table style="text-align:center;" class="tableClass">';  
                                                        codigoHtml += '<tr><th colspan="2" class="tableClass">' + nombreIndicador + ' (' + nomEntidad + ')' + '</th></tr>';
                                                        codigoHtml += '<tr><th class="tableClass">Año</th><th class="tableClass">Población</th></tr>'; 
                                                        for(var i = 0; i < json.Data.Serie.length; i++){
                                                            var periodos = json.Data.Serie[i].TimePeriod;    
                                                            codigoHtml += '<tr><td class="tableClass">' + periodos + '</td>';    
                                                            var valor = json.Data.Serie[i].CurrentValue;    
                                                            codigoHtml += '<td class="tableClass">' + valor + '</td></tr>';    
                                                        }  
                                                        codigoHtml += '</table>';  
                                                        $('#divTablaDatos').html(codigoHtml);   
                                                    });  
                                                });  
                                            
Para descargar el ejemplo completo aquí.