This vignette provides details on the source data retrieved from UNICEF.

About the source

fetch_indicator() with source = 'unicef' retrieves data from UNICEF’s API service.

It is important to note that the UNICEF API is split into multiple databases. The structure of each database does vary, which can result in potential errors or inconsistencies in the output. At the moment no such errors are know, but users should be mindful of the possibility.

Additionally, the data for some indicators can contain multiple surveys for a specific country-year. This is solved by prioritizing international survey types (i.e. DHS, MICS, MIS and AIS) over national surveys (see pddcs:::filter_unicef and pddcs:::apply_filter_unicef for details). Still, some countries can have more than one national survey in the same year. Users will need to remove such cases manually.

Available indicators

Currently the following 24 indicators are available for UNICEF.

library(dplyr)
data(indicatorlist)
indicatorlist %>% 
  filter(source == 'unicef') %>% 
  select(indicator)
##            indicator
## 1     SH.STA.ANV4.ZS
## 2     SH.MLR.NETS.ZS
## 3        SH.STA.ORTH
## 4     SN.ITK.VITA.ZS
## 5     SH.MLR.IPTP.ZS
## 6     SH.STA.ARIC.ZS
## 7     SH.STA.BRTC.ZS
## 8     SH.STA.BFED.ZS
## 9     SH.STA.BRTW.ZS
## 10    SN.ITK.SALT.ZS
## 11    SH.STA.IYCF.ZS
## 12    SH.STA.ORCF.ZS
## 13    SH.STA.ANVC.ZS
## 14    SP.REG.BRTH.ZS
## 15 SP.REG.BRTH.UR.ZS
## 16 SP.REG.BRTH.RU.ZS
## 17 SP.REG.BRTH.MA.ZS
## 18 SP.REG.BRTH.FE.ZS
## 19 SP.M18.2024.FE.ZS
## 20 SP.M15.2024.FE.ZS
## 21 SH.HIV.KNOW.FE.ZS
## 22 SH.HIV.KNOW.MA.ZS
## 23 SH.CON.AIDS.FE.ZS
## 24 SH.CON.AIDS.MA.ZS

Several of the indicators are retrieved from the Countdown 2030 coverage (CDCOV) dataflow, but other databases are also used. This includes the Child Protection (PT), Maternal, Child and Newborn Health (MNCH), Nutrition (NUTRITION) and HIV/AIDS (HIV_AIDS) databases. Details on the source used for a specific indicator can be found in pddcs:::create_url_unicef.

Examples

# Fetch bed nets data
df <- fetch_indicator('SH.MLR.NETS.ZS', source = 'unicef')

# Fetch multiple indicators 
df <- fetch_indicator(
 indicator = c('SH.STA.ANV4.ZS', 'SN.ITK.VITA.ZS'),
 source = 'unicef')

References

UNICEF. Deploying open data tools and standards to support UNICEF global public indicators. https://data.unicef.org/open-data/