Data Management

Automated Data Collection

Overview of the Collector app and all available management commands for fetching data from external APIs and FTP servers.


Overview

The Collector module orchestrates automated data collection from external sources. Each data source is represented as a DataSource model in the admin panel, with an associated collection command and logging via CollectionLog.

Triggering Collection

Collections can be triggered:

  • Via browser — Navigate to /collector/collect/<id>/.
  • Via CLI — Run the management command directly.
  • Via cron/scheduler — Schedule commands to run at regular intervals.

Full Command Reference

CommandData TypeSource
collect_rainfallWeekly rainfall forecastFTP (GeoTIFF)
collect_month_rainfall_forecastMonthly rainfall forecastFTP
collect_season_rainfall_forecastSeasonal rainfall forecastFTP
collect_week_temperature_forecastWeekly temperatureFTP
collect_month_temperature_forecastMonthly temperatureFTP
collect_season_temperature_forecastSeasonal temperatureFTP
collect_economyCPI, inflation, food inflationTrading Economics API
collect_currencyExchange ratescurrencyapicom
collect_displacementRefugee dataUNHCR
collect_idpIDP dataUNHCR
collect_iom_idpIDP dataIOM DTM API
collect_fiIPC food insecurityIPC
collect_country_fiCountry IPC dataIPC
collect_cropyieldCrop productionFAO FAOSTAT
collect_food_prices_kenKenya food pricesWFP DataBridges
collect_livestock_prices_kenKenya livestock pricesWFP DataBridges