IDB’s Open Data portal that showcases socio-economic indicators for the Latin American and the Caribbean Region. It is a joint partnership between seven data sources:
(a database that enables policy makers and analysts to track agricultural policies and to assess and measure the composition of the support to agriculture)
(comprehensive online gateway bringing together information on integration and trade in the region)
(over 500 indicators consolidating data on macroeconomics, social issues, trade, capital flows, markets and governance)
(a set of public management indicators based on methodologies developed by the IDB about the performance of Managing for Development Results (MfDR) and Civil Service in LAC region)
(full set of key indicators on living conditions in Latin America and the Caribbean population)
(the main source of information on labor markets in Latin America and the Caribbean.).
(a complete dataset of social indicators providing insight into Latin America and the Caribbean’s socioeconomic conditions).
Combine indicators from different dimensions of socio-economic development, such as social outlook and macroeconomic indicators.
Select the areas of development that interest you most, view the data, generate graphs, and compare trends in real time.
Zoom in and compare values for different countries. Take a snapshot of values for one particular year.
See an interactive visual snapshot of development for each country using our Country a Glance tool which allows you to quickly look and compare how these different facets have developed over time.
See the most popular indicators (based on number of views), by country, and access their data in real time
This API overview describes how to query the indicators in Inter-American Development Bank’s (IDB) Numbers for Development (N4D) database and show the outputs.
The API allows you to access over two thousand indicators on macro-economic, social, and trade on Latin American and Caribbean countries for a period that spans from 1940 to 2013, depending on the indicator.Data is in a time-series format. For the most part data are at an annual frequency. However, for some macro-economic and financial indicators, there are data at the monthly and quarterly frequencies.
The API has implemented a RESTful interface that allows users to query the data using selection parameters as shown in examples below. The API provides XML and JSON representations for the expected output data.
The API is a resource made available to programmers and data users to explore the N4D dataset and build new applications using the N4D open data set. You are encouraged to develop software applications that utilize and add value to the N4D dataset. The N4D itself is a collection of three major databases in the IDB with their own application and user interface. These applications are: Latin America Watch (LMW) for macroeconomic and financial data; Sociometro for data on demographics, education, housing & sanitation, poverty and inequality; and, INTrade for trade, tariffs and trade indices.
The N4D web application (data.iadb.org) uses this API to access the database and present it on the website.
This documentation describes the Basic Call Structure for the API to allow you to start developing applications. It also includes examples of the API calls as well as information on how to access the codes and names of indicators and countries that have to be used in the API query. These can be pasted directly into your browser and run to view instant results. You can also customize these sample API calls with different parameter values.
The following examples are for making API calls to fetch the data and metadata (country and indicator names, data topics and sub-topics).
Country :Basic call structure is as shown below.
'http://api-data.iadb.org/metadata/country?searchtype=&searchvalue=&languagecode=&responsetype='Use the URL below to get country metadata with country code “ABW” in English language.
'http://api-data.iadb.org/metadata/country?searchtype=code&searchvalue=ABW&languagecode=en&responsetype=xml'
Use URL the below to get country metadata with country name “Argentina” in English language.
'http://api-data.iadb.org/metadata/country?searchtype=name&searchvalue= Argentina &Languagecode=en&Responsetype=xml'
Indicator : 'http://api-data.iadb.org/metadata/indicator?searchtype=&searchvalue&languagecode=responsetype='
Data Topic : 'http://api-data.iadb.org/metadata/topic?searchtype=&searchvalue=&languagecode=responsetype='
Data Sub Topic : 'http://api-data.iadb.org/metadata/subtopic?searchtype=&searchvalue=&languagecode=responsetype='
Currently, the Data API allows data retrieval for a maximum of four (4) countries if ‘All’ indicators are selected; or, it allows a maximum of 10 Indicators when ‘All’ countries are selected.'http://api-data.iadb.org/datasite/'
Query string parameters :
Query data site data for country code ABW and frequency is year and language code en
'http://api-data.iadb.org/datasitedata?countrycode=abw&frequency=year&languagecode=en&responsetype=xml'API | Scenario | Message | Status Code |
---|---|---|---|
Both API | Success | Data will be returned | OK = 200 |
Both API | Exception occurred in the code. | An error occurred, please try again or contact the administrator | InternalServerError = 500 |
Both API | When response type not passing / not valid | Responsetype parameter should not be empty/null. | NotAcceptable = 406 |
Meta Data API | When data not available | No [Country / Indicator /Topic / Sub Topic ] metadata with search type = {}, searchvalue= {} and language {} | NotFound = 404 |
Data Site Data API | When data not available | No datasite data found | NotFound = 404 |
Data Site Data API | When indicator code or country code not passed | Indicatorcode and Countrycode should be mandatory | MethodNotAllowed = 405 |
Data Site Data API | When indicator code == all & country code == all | All countries and All indicators cannot be requested | MethodNotAllowed = 405 |
Data Site Data API | When indicator code == all & country code > 4 | When All indicators’ data is requested, data can be requested for a maximum of 4 countries | MethodNotAllowed = 405 |
Data Site Data API | When country code == all & indicator code > 10 | When All country data is requested, data can be requested for a maximum of 10 indicators | MethodNotAllowed = 405 |
Iadbstats is an R library that enables data extraction and statistical computing from the IDB's open data portal "Numbers for development". It was developed following the World Bank´s Development Indicators library for R
https://github.com/EL-BID/Libreria-R-Numeros-para-el-Desarrollo