id: worldbank
name: World Bank Indicators
domain: api.worldbank.org
kind: dataset
mode: api
priority: 2
license: "CC BY 4.0 — World Bank Terms of Use for Datasets (https://datacatalog.worldbank.org/public-licenses#cc-by): \"CC-BY 4.0 [...] is the default license for all Datasets produced by the World Bank itself and distributed as open data\""
attribution: "Source: World Bank, World Development Indicators (CC BY 4.0)"
homepage: https://datahelpdesk.worldbank.org/knowledgebase/articles/889392-about-the-indicators-api-documentation
notes: >-
  Indicators SP.POP.TOTL, NY.GDP.MKTP.CD, EG.ELC.RNEW.ZS (% of electricity output → renewableShare in percent),
  EG.USE.ELEC.KH.PC (kWh per capita → electricityTwh derived with same-year population, flagged as derived estimate).
  Aggregates (region.value = "Aggregates") and non ISO-2 codes are skipped. One composed document, 6 requests per run.
coverage: { global: true }
fetch:
  level: 1
  maxLevel: 1
  userAgent: bot
  rpm: 20
  concurrency: 1
  respectRobots: true        # api.worldbank.org has no robots.txt (404) → allowed
  timeoutMs: 90000
  maxCreditsPerRun: 0
schedule:
  dataset: monthly
implementation: worldbank
params:
  apiBase: https://api.worldbank.org/v2
  minDelayMs: 1500
  populationYears: 15
parserVersion: worldbank_v1