Access Open Data Through the Junar API

Frans van Dunné

2017-12-11

Introduction

The Junar API is the basis for a number of Open Data initiatives in Latin America and the USA. The junr package is a wrapper to make it easier to access data made public through the Junar API. Some examples of implementations are listed on the Junar website.

Usage

As an example we will use the data from the Costa Rican President’s Office.The first step is to access the website offering the open data to identify the base URL and to obtain an API Key to get access to the Junar API that hosts the data. You will find both on the developers page of the Open Data Costa Rica site.

Below we use a test API Key so that all the examples will run. You may want to get your own API Key instead to run the examples below. Note that with Junar each URL has its own API key.

library(junr)
base_url <- "http://api.datosabiertos.presidencia.go.cr/api/v2/datastreams/"
api_key <- "0bd55e858409eefabc629b28b2e7916361ef20ff" 

Now that we have the basic information for a connection we can quickly check what data is available behind this URL.

get_index(base_url, api_key)

The get_indexfunction returns the complete list of available data with all meta-data included as a data frame.

To get only a list of the global unique identifiers (GUID) of the data sets, you can use list_guid.

list_guid(base_url, api_key)
##   [1] "JULIO-2017-PRESI-DE-LA"       "JULIO-2017-MINIS-DE-LA"      
##   [3] "SETIE-2017-MINIS-DE-49435"    "OCTUB-2017-PRESI-DE-LA"      
##   [5] "OCTUB-2017-MINIS-DE-LA"       "INDIC-DE-TIPO-DE-95416"      
##   [7] "INDIC-DE-TIPO-DE-10291"       "INDIC-DE-TIPO-DE-43721"      
##   [9] "TASA-DE-INTER-INDUS-17947"    "TASA-DE-INTER-AGRIC-59695"   
##  [11] "TIPO-DE-CAMBI-MONEX-88502"    "INDIC-DE-PRECI-AL-72481"     
##  [13] "EXPEC-DE-INFLA-44614"         "TASA-DE-DESEM-ABIER-88146"   
##  [15] "SETIE-2017-MINIS-DE-LA"       "SETIE-2017-PRESI-DE-LA"      
##  [17] "AGOST-2017-PRESI-DE-LA"       "JUNIO-2017-MINIS-DE-LA"      
##  [19] "JUNIO-2017-PRESI-DE-LA"       "AGOST-2017-MINIS-DE-LA"      
##  [21] "CREDI-AL-SECTO-POR-ACTIV"     "INDIC-MENSU-DE-ACTIV-48548"  
##  [23] "PRODU-CONST-39095"            "PRODU-INDUS-MANUF"           
##  [25] "PRODU-AGRIC-57454"            "PRODU-COMER-17803"           
##  [27] "EXPEC-DE-INFLA-69117"         "INDIC-DE-PRECI-AL-35027"     
##  [29] "RESUL-PRIMA-Y-FINAN-53772"    "INGRE-Y-GASTO-DEL-42060"     
##  [31] "RESER-MONET-INTER-63454"      "INDIC-DE-APERT-COMER-60546"  
##  [33] "INVER-DIREC-EN-LA-18116"      "INVER-DIREC-EN-LA-ECONO"     
##  [35] "BALAN-COMER-95595"            "TASA-DE-DESEM-ABIER-82368"   
##  [37] "CREDI-DEL-SISTE-FINAN-13124"  "CRECI-DEL-PIB-18189"         
##  [39] "FORMA-BRUTA-DE-CAPIT-40506"   "FORMA-BRUTA-DE-CAPIT-FIJO"   
##  [41] "RESUL-PRIMA-Y-FINAN-77198"    "RESUL-PRIMA-Y-FINAN-94060"   
##  [43] "PRODU-CONST-46767"            "PRODU-CONST"                 
##  [45] "PRODU-INDUS"                  "PRODU-AGRIC-31180"           
##  [47] "PRODU-COMER-91260"            "PRODU-TOTAL"                 
##  [49] "CLASI-EN-EL-DOING-BUSIN"      "TARIF-DE-MEDID-TENSI-B"      
##  [51] "VARIA-EN-EL-PRECI-DE"         "INDIC-DE-TIPO-DE-74182"      
##  [53] "TASA-DE-INTER-INDUS"          "TASA-DE-INTER-AGRIC-29915"   
##  [55] "SISTE-DE-BANCA-PARA-EL"       "TIPO-DE-CAMBI-MONEX-69945"   
##  [57] "REDUC-ACUMU-EN-LAS-TASAS"     "EXPEC-DE-INFLA-77815"        
##  [59] "INDIC-DE-PRECI-AL-CONSU"      "RESUL-PRIMA-Y-FINAN-72275"   
##  [61] "RESER-MONET-INTER"            "INDIC-DE-APERT-COMER-75777"  
##  [63] "BALAN-COMER-31602"            "TOTAL-INVER-DIREC-EN-LA"     
##  [65] "TASA-DE-DESEM-ABIER"          "REDIT-DEL-SISTE-FINAN-AL"    
##  [67] "INVER-EXTRA-DIREC-31497"      "INDIC-MENSU-DE-ACTIV-ECONO"  
##  [69] "CRECI-INTER-PIB"              "COMBU"                       
##  [71] "INFLA-66646"                  "PRODU-POR-INDUS"             
##  [73] "PRODU-MANUF"                  "PRODU-AGRIC"                 
##  [75] "PRODU-COMER"                  "TIPO-DE-CAMBI-MONEX"         
##  [77] "PRODU"                        "DOING-BUSIN-49028"           
##  [79] "TARIF-DE-MEDIA-TENSI"         "INDIC-DE-TIPO-DE-CAMBI"      
##  [81] "TASAS-DE-INTER-INDUS"         "TASA-DE-INTER-AGRIC"         
##  [83] "BANCA-DE-DESAR"               "TASAS"                       
##  [85] "INFLA"                        "RESUL-PRIMA-Y-FINAN-84435"   
##  [87] "INSTI-DE-ACUED-Y-ALCAN"       "MINIS-DE-PLANI-NACIO-83204"  
##  [89] "MINIS-DE-VIVIE-Y-ASENT"       "MINIS-DE-OBRAS-PUBLI-71783"  
##  [91] "MINIS-DE-GOBER-Y-60375"       "MINIS-DE-EDUCA-PUBLI-59938"  
##  [93] "MINIS-DE-CULTU-Y-JUVEN"       "MINIS-DE-COMER-EXTER-2014"   
##  [95] "MINIS-DE-CIENC-TECNO-14818"   "MINIS-DE-AGRIC-Y-31081"      
##  [97] "CONSE-NACIO-DE-PRODU"         "JUNTA-DE-ADMIN-PORTU-Y"      
##  [99] "DIREC-GENER-DE-MIGRA-79035"   "CONSE-NACIO-PARA-INVES-CIENT"
## [101] "MINIS-DE-SEGUR-PUBLI"         "MINIS-DE-SEGUR-PUBLI-58601"  
## [103] "IMPRE-NACIO-2014-2017-94352"  "EXPEC-DEINF"                 
## [105] "INGRE-Y-GASTO-DEL-45693"      "INGRE-Y-GASTO-DEL-GOBIE"     
## [107] "RESUL-PRIMA-Y-FINAN"          "IMPRE-NACIO-2014-2017"       
## [109] "DIREC-NACIO-DE-DESAR-DE"      "RMI-SOBRE-PIB"               
## [111] "INVER-EXTRA-DIREC"            "BALAN-COMER"                 
## [113] "INDIC-DE-APERT-COMER"         "CREDI-DEL-SISTE-FINAN-AL"    
## [115] "INVER-PIB"                    "DESEM"                       
## [117] "IMAE"                         "CRECI-DEL-PIB-62787"         
## [119] "LLEGA-INTER-A-COSTA-RICA"     "CRECI-DEL-PIB"               
## [121] "IPC"                          "LICIT-ADJUD-POR-LAS-INSTI"   
## [123] "LICIT-ADJUD-POR-LOS-MINIS"    "LICIT-ADJUD-POR-LAS-81483"   
## [125] "MAYO-2017-PRESI-DE-LA"        "MAYO-2017-MINIS-DE-LA"       
## [127] "ABRIL-2017-PRESI-DE-LA"       "ABRIL-2017-MINIS-DE-LA"      
## [129] "NOVIE-2016-MINIS-DE-90677"    "NOVIE-2016-SALAR-PRESI-DE"   
## [131] "COMPR-PUBLI-DE-PRESI-Y"       "BASE-DE-DATOS-RNT"           
## [133] "PRUEB"                        "MARZO-2017-SALAR-MINIS-DE"   
## [135] "OCTUB-2016-SALAR-MINIS-DE"    "OCTUB-2016-SALAR-PRESI-65964"
## [137] "OCTUB-2016-SALAR-PRESI-65743" "021-OCTUB-16"                
## [139] "ENERO-2017-SALAR-PRESI-DE"    "ENERO-2017-SALAR-MINIS-DE"   
## [141] "DICIE-2016-SALAR-MINIS-DE"    "DICIE-2016-PLANI-PRESI-84096"
## [143] "OCTUB-2016-SALAR-PRESI-DE"    "MINIS-DE-OBRAS-PUBLI-97637"  
## [145] "MINIS-DE-SEGUR-PUBLI-2014"    "MINIS-DE-PLANI-NACIO-2014"   
## [147] "MINIS-DE-EDUCA-PUBLI-67848"   "MINIS-DE-EDUCA-PUBLI-93512"  
## [149] "DIREC-GENER-DE-MIGRA-Y"       "DIREC-NACIO-DE-NOTAR-59323"  
## [151] "MINIS-DE-GOBER-Y-POLIC"       "IMPRE-NACIO-2014-2016"       
## [153] "INSTI-COSTA-DE-TURIS-2014"    "MINIS-DE-RELAC-EXTER-Y"      
## [155] "MINIS-DE-EDUCA-PUBLI-2014"    "INSTI-NACIO-DE-TRANS-AGROP"  
## [157] "DIREC-NACIO-DE-NOTAR-2014"    "CONSO-DE-VIAJE-AL-EXTER"     
## [159] "SETIE-2016-SALAR-MINIS-PRESI" "SETIE-2016-PRESI-DE-LA"      
## [161] "AGOST-2016-MINIS-DE-LA"       "AGOST-2016-SALAR-PRESI-DE"   
## [163] "SERVI-NACIO-DE-SALUD-ANIMA"   "SERVI-FITOS-DEL-ESTAD-2015"  
## [165] "MINIS-DE-OBRAS-PUBLI-Y"       "MINIS-DE-HACIE-2015"         
## [167] "IMPRE-NACIO-2015"             "MINIS-DE-EDUCA-PUBLI-2015"   
## [169] "MINIS-DE-CIENC-TECNO-Y"       "MINIS-DE-AGRIC-Y-GANAD"      
## [171] "INSTI-NACIO-DE-TURIS-2015"    "DIREC-DE-MIGRA-Y-EXTRA"      
## [173] "CUMPL-DE-INFOR-DE-87487"      "CUMPL-DE-INFOR-DE-14097"     
## [175] "CUMPL-DE-INFOR-DE-14456"      "CUMPL-DE-INFOR-DE-14478"     
## [177] "CUMPL-DE-INFOR-DE-26552"      "AYA-EVALU-POI-PROGR-02"      
## [179] "AYA-EVALU-POI-I-TRIME"        "AYA-INFOR-DE-EJECU-PRESU"    
## [181] "AYA-SALAR-ENERO-2016"         "AYA-CONTR-ADJUD-EN-FIRME"    
## [183] "CUMPL-DE-AUDIT-MINIS-61945"   "CUMPL-DE-INFOR-MINIS-DE"     
## [185] "CUMPL-DE-INFOR-SENAS"         "CUMPL-DE-AUDIT-MINIS-DE"     
## [187] "CUMPL-DE-AUDIT-COMEX"         "MATRI-DE-CUMPL-DE-43076"     
## [189] "MATRI-DE-CUMPL-DE-AUDIT"      "CUMPL-DE-INFOR-DE-40516"     
## [191] "ABRIL-2016-SALAR-MINIS-DE"    "JUNIO-2016-SALAR-MINIS-23346"
## [193] "JULIO-2016-SALAR-PRESI-DE"    "JUNIO-2016-SALAR-PRESI-DE"   
## [195] "MAYO-2015-SALAR-PRESI-DE"     "JULIO-2016-MINIS-DE-LA"      
## [197] "JUNIO-2016-SALAR-MINIS-DE"    "MAYO-2016-SALAR-MINIS-DE"    
## [199] "ABRIL-2016-SALAR-DEL-MINIS"   "ABRIL-2016-SALAR-PRESI-DE"   
## [201] "CUMPL-DE-INFOR-DE-75676"      "CUMPL-DE-INFOR-DE-AUDIT"     
## [203] "INFOR-CUMPL-DE-AUDIT-97747"   "INFOR-CUMPL-DE-AUDIT-43518"  
## [205] "INFOR-CUMPL-DE-AUDIT-36700"   "INFOR-CUMPL-DE-AUDIT-INTER"  
## [207] "DATOS-CORRE-AL-PAGO-DE"       "JUNIO-2016-PLANI-DE-PRESI"   
## [209] "JUNIO-2016-SALAR-DE-PRESI"    "AYA-GASTO-DE-VIAJE-AL"       
## [211] "INFOR-DE-HORAS-EXTRA-01"      "INFOR-DE-HORAS-EXTRA-67320"  
## [213] "INFOR-DE-HORAS-EXTRA-7"       "VISTA"                       
## [215] "PLANI-DE-SALAR-PRESI-DE"      "COMPR-PUBLI-DE-PRESI"        
## [217] "COMPR-PUBLI-DEL-MINIS"        "DESCR-DE-ABREV-DE-LAS"       
## [219] "EJECU-DE-PRESU-DE-50724"      "EJECU-DE-PRESU-DE-INSTI"     
## [221] "LICIT-ADJUD-DE-LAS-INSTI"     "PLANI-DEL-MINIS"

You can also make a list of the titles of the data sets:

list_titles(base_url, api_key)
##   [1] "Julio 2017 Presidencia de la República"                                          
##   [2] "Julio 2017 Ministerio de la Presidencia"                                         
##   [3] "Setiembre 2017 Ministerio de la Presidencia"                                     
##   [4] "Octubre 2017 Presidencia de la República"                                        
##   [5] "Octubre 2017 Ministerio de la Presidencia"                                       
##   [6] "Índice de Tipo de Cambio Efectivo Real Multilateral con Ponderadores Móviles"    
##   [7] "Índice de tipo de cambio real multilateral"                                      
##   [8] "Índice de tipo de cambio real multilateral"                                      
##   [9] "Tasa de Interés Industrial"                                                      
##  [10] "Tasa de Interés Agricultura"                                                     
##  [11] "Tipo de cambio MONEX"                                                            
##  [12] "Índice de precios al consumidor"                                                 
##  [13] "Expectativas de inflación"                                                       
##  [14] "Tasa de desempleo abierto"                                                       
##  [15] "Setiembre 2017 Ministerio de la Presidencia"                                     
##  [16] "Setiembre 2017 Presidencia de la República"                                      
##  [17] "Agosto 2017 Presidencia de la República"                                         
##  [18] "Junio 2017 Ministerio de la Presidencia"                                         
##  [19] "Junio 2017 Presidencia de la República"                                          
##  [20] "Agosto 2017 Ministerio de la Presidencia"                                        
##  [21] "Crédito al sector por actividad económica"                                       
##  [22] "Índice Mensual de Actividad Económica"                                           
##  [23] "Productividad Construcción"                                                      
##  [24] "Productividad Industria Manufacturera"                                           
##  [25] "Productividad agricultura"                                                       
##  [26] "Productividad comercio"                                                          
##  [27] "Expectativas de Inflación"                                                       
##  [28] "Índice de Precios al Consumidor"                                                 
##  [29] "Resultado Primario y Financiero"                                                 
##  [30] "Ingresos y Gastos del Gobierno Central"                                          
##  [31] "Reservas Monetarias Internacionales"                                             
##  [32] "índice de Apertura Comercial"                                                    
##  [33] "Inversión directa en la economía declarante"                                     
##  [34] "Inversión directa en la economía declarante"                                     
##  [35] "Balanza Comercial"                                                               
##  [36] "Tasa de Desempleo Abierto"                                                       
##  [37] "Crédito del Sistema Financiero al Sector por Actividad Económica"                
##  [38] "Crecimiento del PIB"                                                             
##  [39] "Formación Bruta de Capital Fijo"                                                 
##  [40] "Formación Bruta de Capital Fijo"                                                 
##  [41] "Resultado Primario y Financiero"                                                 
##  [42] "Resultado Primario y Financiero"                                                 
##  [43] "Productividad Construcción"                                                      
##  [44] "Productividad Construcción"                                                      
##  [45] "Productividad Industria"                                                         
##  [46] "Productividad Agricultura"                                                       
##  [47] "Productividad Comercio"                                                          
##  [48] "Productividad Total"                                                             
##  [49] "Clasificación en el Doing Business"                                              
##  [50] "Tarifa de Medida Tensión B"                                                      
##  [51] "Variación en el Precio de los Combustibles"                                      
##  [52] "Índice de Tipo de Cambio Efectivo Real Multilateral con Ponderadores Móviles"    
##  [53] "Tasa de Interés Industrial"                                                      
##  [54] "Tasa de Interés Agricultura"                                                     
##  [55] "Sistema de Banca para el Desarrollo"                                             
##  [56] "Tipo de Cambio MONEX"                                                            
##  [57] "Reducción Acumulada en las Tasas de Interés"                                     
##  [58] "Expectativas de Inflación"                                                       
##  [59] "Índice de Precios al Consumidor"                                                 
##  [60] "Resultado Primario y Financiero"                                                 
##  [61] "Reservas Monetarias Internacionales"                                             
##  [62] "Índice de Apertura Comercial"                                                    
##  [63] "Balanza Comercial"                                                               
##  [64] "Total Inversión Directa en la Economía Declarante"                               
##  [65] "Tasa de Desempleo Abierto"                                                       
##  [66] "Crédito del Sistema Financiero al Sector por Actividad Económica"                
##  [67] "Inversión Extranjera Directa"                                                    
##  [68] "Índice Mensual de Actividad Económica por Industrias"                            
##  [69] "Crecimiento Interanual PIB"                                                      
##  [70] "Combustibles"                                                                    
##  [71] "Inflación"                                                                       
##  [72] "Productividad por Industria"                                                     
##  [73] "Productividad Manufacturera"                                                     
##  [74] "Productividad Agricultura"                                                       
##  [75] "Productividad Comercio"                                                          
##  [76] "Tipo de Cambio Monex"                                                            
##  [77] "Productividad"                                                                   
##  [78] "Doing Business"                                                                  
##  [79] "Tarifas de Media Tensión"                                                        
##  [80] "Índice de Tipo de Cambio Real Multilateral"                                      
##  [81] "Tasas de interés  Industria"                                                     
##  [82] "Tasa de Interés Agricultura"                                                     
##  [83] "Banca de Desarollo"                                                              
##  [84] "Tasas"                                                                           
##  [85] "Inflación"                                                                       
##  [86] "Resultado Primario y Financiero"                                                 
##  [87] "Instituto de Acueductos y Alcantarillados"                                       
##  [88] "Ministerio de Planificación Nacional 2014-2017"                                  
##  [89] "Ministerio de Vivienda y Asentamientos Humanos"                                  
##  [90] "Ministerio de Obras Públicas y Transportes 2014-2017"                            
##  [91] "Ministerio de Gobernación y Policía 2014-2017"                                   
##  [92] "Ministerio de Educación Pública 2014-2017"                                       
##  [93] "Ministerio de Cultura y Juventud 2014-2017"                                      
##  [94] "Ministerio de Comercio Exterior 2014-2016"                                       
##  [95] "Ministerio de Ciencia, Tecnología y Telecomunicaciones"                          
##  [96] "Ministerio de Agricultura y Ganadería 2014-2017"                                 
##  [97] "Consejo Nacional de Producción"                                                  
##  [98] "Junta de Administración Portuaria y de Desarrollo Económico de la Vertiente Atlá"
##  [99] "Dirección General de Migración y Extranjería"                                    
## [100] "Consejo Nacional para Investigaciones Científicas y Tecnológicas"                
## [101] "Ministerio de Seguridad Pública"                                                 
## [102] "Ministerio de Seguridad Pública 2014-2017"                                       
## [103] "Imprenta Nacional 2014-2017"                                                     
## [104] "Expectativas deInflación"                                                        
## [105] "Ingresos y Gastos del Gobierno Central"                                          
## [106] "Ingresos y Gastos del Gobierno Central"                                          
## [107] "Resultado Primario y Financiero"                                                 
## [108] "Imprenta Nacional 2014-2017"                                                     
## [109] "Dirección Nacional de Desarrollo de la Comunidad 2014-2017"                      
## [110] "RMI Sobre PIB"                                                                   
## [111] "Inversión Extranjera Directa"                                                    
## [112] "Balanza Comercial"                                                               
## [113] "Indice de Apertura Comercial"                                                    
## [114] "Crédito del Sistema Financiero al Sector Privado por Actividad Económica"        
## [115] "Inversión / PIB"                                                                 
## [116] "Desempleo"                                                                       
## [117] "IMAE"                                                                            
## [118] "Crecimiento del PIB"                                                             
## [119] "Llegadas Internacionales a Costa Rica"                                           
## [120] "Crecimiento del PIB"                                                             
## [121] "IPC"                                                                             
## [122] "Licitaciones adjudicadas por las Instituciones Públicas según año"               
## [123] "Licitaciones adjudicadas por los Ministerios"                                    
## [124] "Licitaciones adjudicadas por las Instituciones Públicas según tipo de trámite"   
## [125] "Mayo 2017 - Presidencia de la República"                                         
## [126] "Mayo 2017 - Ministerio de la Presidencia"                                        
## [127] "Abril 2017 - Presidencia de la República"                                        
## [128] "Abril 2017 - Ministerio de la Presidencia"                                       
## [129] "Noviembre 2016 - Ministerio de la Presidencia"                                   
## [130] "Noviembre 2016 - Salarios Presidencia de la República"                           
## [131] "Compras públicas de Presidencia y el Ministerio de la Presidencia"               
## [132] "Base de datos RNT"                                                               
## [133] "PRUEBA1"                                                                         
## [134] "Marzo 2017 - Salarios Ministerio de la Presidencia"                              
## [135] "Octubre 2016 - Salarios Ministerio de la Presidencia"                            
## [136] "Octubre 2016 - Salarios Presidencia de la República"                             
## [137] "Octubre 2016 - Salarios Presidencia de la República"                             
## [138] "Octubre 2016 - Salarios Presidencia de la República"                             
## [139] "Enero 2017 - Salarios Presidencia de la República"                               
## [140] "Enero 2017 - Salarios Ministerio de la Presidencia"                              
## [141] "Diciembre 2016 - Salario Ministerio de la Presidencia"                           
## [142] "Diciembre 2016 - Planilla Presidencia de la República"                           
## [143] "Octubre 2016 - Salarios Presidencia de la República"                             
## [144] "Ministerio de Obras Públicas y Transporte (2014-2016)"                           
## [145] "Ministerio de Seguridad Pública (2014-2016)"                                     
## [146] "Ministerio de Planificación Nacional (2014-2016)"                                
## [147] "Ministerio de Educación Pública (2014-2016)"                                     
## [148] "Ministerio de Educación Pública (2014-2016)"                                     
## [149] "Dirección General de Migración y Extranjería (2014 - 2016)"                      
## [150] "DINADECO (2014 - 2018)"                                                          
## [151] "Ministerio de Gobernación y Policía (2014-2016)"                                 
## [152] "Imprenta Nacional 2014-2016"                                                     
## [153] "Instituto Costarricense de Turismo - (2014-2016)"                                
## [154] "Ministerio de Relaciones Exteriores y Culto"                                     
## [155] "Ministerio de Educación Pública (2014-2016)"                                     
## [156] "Instituto Nacional de Transferencia Agropecuaria (2014-2016)"                    
## [157] "Dirección Nacional de Notariado (2014-2016)"                                     
## [158] "Consolidado de viajes al exterior"                                               
## [159] "Setiembre 2016 - Salarios Ministerio Presidencia"                                
## [160] "Setiembre 2016 - Presidencia de la República"                                    
## [161] "Agosto 2016 - Ministerio de la Presidencia"                                      
## [162] "Agosto 2016 - Salarios Presidencia de la República"                              
## [163] "Servicio Nacional de Salud Animal SENASA (2015)"                                 
## [164] "Servicio Fitosanitario del Estado (2015)"                                        
## [165] "Ministerio de Obras Públicas y Transportes (2015)"                               
## [166] "Ministerio de Hacienda (2015)"                                                   
## [167] "Imprenta Nacional (2015)"                                                        
## [168] "Ministerio de Educación Pública (2015)"                                          
## [169] "Ministerio de Ciencia, Tecnología y Telecomunicaciones (2015)"                   
## [170] "Ministerio de Agricultura y Ganadería (2015)"                                    
## [171] "Instituto Nacional de Turismo (2015)"                                            
## [172] "Dirección de Migración y Extranjería - 2015"                                     
## [173] "Cumplimiento de Informe de Auditoría Interna - DINADECO"                         
## [174] "Cumplimiento de Informe de Auditoría Interna - DNN"                              
## [175] "Cumplimiento de Informe de Auditoría Interna - MINAE"                            
## [176] "Cumplimiento de Informe de Auditoría Interna - Ministerio de Hacienda"           
## [177] "Cumplimiento de Informe de Auditoría Interna - MIVAH"                            
## [178] "AYA - Evaluación POI - Programa 02  ASADAS - I Trimestre 2016"                   
## [179] "AYA - Evaluación POI - Programa 02 - I Trimestre 2016"                           
## [180] "AYA - Informe de ejecución presupuestario consolidado (I T-2016)"                
## [181] "AYA - Salarios Enero 2016"                                                       
## [182] "AyA - Contrataciones adjudicadas en firme"                                       
## [183] "Cumplimiento de auditoría - Ministerio de Gobernación y Policía"                 
## [184] "Cumplimiento de auditoría - Ministerio de Relaciones Exteriores"                 
## [185] "Cumplimiento de auditoría  - SENASA"                                             
## [186] "Cumplimiento de auditoría - Ministerio de la Presidencia"                        
## [187] "Cumplimiento de auditoría - COMEX"                                               
## [188] "Cumplimiento de auditoría - Imprenta Nacional"                                   
## [189] "Cumplimiento de auditoría - Dirección General de Migración y Extranjer"          
## [190] "Cumplimiento de Informe de Auditoría Interna - SFE"                              
## [191] "Abril 2016 - Salarios Ministerio de la Presidencia"                              
## [192] "Junio 2016 - Salarios Ministerio de la Presidencia"                              
## [193] "Julio 2016 - Salarios Presidencia de la República"                               
## [194] "Junio 2016 - Salarios Presidencia de la República"                               
## [195] "Mayo 2016 - Salarios Presidencia de la República"                                
## [196] "Julio 2016 - Ministerio de la Presidencia"                                       
## [197] "Junio 2016 - Salarios Ministerio de la Presidencia"                              
## [198] "Mayo 2016 - Salarios Ministerio de la Presidencia"                               
## [199] "Abril 2016 - Salarios del Ministerio de la Presidencia"                          
## [200] "Abril 2016 - Salarios Presidencia de la República"                               
## [201] "Cumplimiento de Informe de Auditoría Interna - Salud"                            
## [202] "Cumplimiento de informes de auditoría interna - MAG"                             
## [203] "Cumplimiento de Informes de Auditoría Interna - ICT"                             
## [204] "Cumplimiento de Informe de Auditoría Interna - MOPT"                             
## [205] "Cumplimiento de Informes de Auditoría Interna - Ministerio de RREE"              
## [206] "Cumplimiento de Informe de Auditoría Interna - SENASA"                           
## [207] "Octubre 2015: Planilla de Salarios: Presidencia de la República"                 
## [208] "JUNIO 2016 - Planilla de Presidencia de la República"                            
## [209] "Junio 2016 - Salarios de Presidencia de la República"                            
## [210] "AyA. Gastos de viajes al exterior Mayo 2014 - Abril 2015"                        
## [211] "Informe de Horas Extra: 01 de enero 2015 al 31 de diciembre de 2015"             
## [212] "Informe de Horas Extra: 01 de enero 2015 al 31 de diciembre de 2015"             
## [213] "Informe de Horas Extra: 7 de mayo 2014 al 31 de diciembre 2014."                 
## [214] "Informe de Horas Extra: 01 de enero 2016 al 30 de abril 2016"                    
## [215] "Abril 2016: Planilla de Salarios Presidencia de la República"                    
## [216] "Compras públicas de Presidencia"                                                 
## [217] "Compras públicas del Ministerio de la Presidencia"                               
## [218] "Descripción de abreviaturas de las ejecuciones "                                 
## [219] "Ejecución de presupuesto de Instituciones para el 2014"                          
## [220] "Ejecución de presupuesto de Instituciones para el 2015"                          
## [221] "Licitaciones Adjudicadas de las Instituciones Públicas para el período 2014-2015"
## [222] "Ministerio de la Presidencia"

Both list_guid and list_titles where set up for convenience only because the results tend to fit in the console window making it easier to read. They are meant to help to get a quick overview of the available data.

Downloading data to R

You need to know the Global Unique Identifier (GUID) of the data set that you are interested in to be able to download them to your R session. You can look for the GUID on the web page that shows the data of interest. For example on the page for public expenditure of the Costa Rican government there is a table called “Public Purchasing of the Ministry of the Presidency”. In the menu underneath the table you have an option to “Obtain GUID”. This last option opens a pop-up showing the GUID “COMPR-PUBLI-DEL-MINIS” that we are going to use in the example below.

data_guid <- "COMPR-PUBLI-DEL-MINIS"
purchasing_data <- get_data(base_url, api_key, data_guid)

With View(purchasing_data) you can check whether the data have been downloaded correctly, and have a quick visual check on the mode of the data (see below to convert currency data from text to numeric).

You may note that if you do not need to go to the web interface to get the GUID for any data sets of interest. With the function list_guid() as we used it above, we obtained the same information.

pres_list <-list_guid(base_url, api_key)
pres_list[3]
## [1] "SETIE-2017-MINIS-DE-49435"

We can get the GUID we are interested in by fetching the third entry in the list of GUID’s (see the full list in the example above). And the same index numbers can be used with a list of full titles created with list_titles().

Determine data dimensions

On data platforms that run Junar, many data sets are just tables of data that has already been analyzed and summarized. It is not immediately obvious which sets contain many data points, and which sets contain only a few rows.

The function get_dimensions will download all data sets offered through the base URL and determine how many rows and columns are available in each one. It is useful to make a quick assessment of the data available. However, please note that it may take a while before the function finishes, especially if there are many GUID’s.

get_dimensions(base_url, api_key)

Clean up currency data

In the example data above, and possibly in more Junar implementations, we need to clean up any data related to currency values. In our case we need to found all currency symbols (Costa Rica Colon) and all the comma’s separating thousands. As they stand these values are text strings, and cannot be converted directly to numeric without removing the symbols and commas.

There are two utilities to help cleaning the currency data: clean_currency and get_currency_symbol. For example:

currency_data <- get_data(base_url, api_key, "LICIT-ADJUD-POR-LOS-MINIS")
currency_data$`Monto Adjudicado` <- clean_currency(currency_data$`Monto Adjudicado`)