Humanitarian Data Exchange (HDX)
Healthdata.humdata.org
OCHA's Humanitarian Data Exchange, a CKAN catalogue of 28,000+ humanitarian datasets from UN agencies, NGOs and governments: displacement and needs assessments, administrative boundaries (COD-AB), population estimates, health and food-security indicators, with organisation, country, resource and licence metadata.
Capabilities (14)
GET /v1/data/hdx/dataset1 creditReturns one dataset's full CKAN record: title, notes, organisation, country and location, tags, licence, dates, custom HDX fields and every resource with its URL, format, size and datastore state.
GET /v1/data/hdx/dataset-names1 creditReturns a flat list of dataset names (slugs) in the catalogue, 1,000 at a time, for enumeration and mirroring rather than reading.
GET /v1/data/hdx/datasets1 creditFull-text and faceted search over the HDX catalogue, returning matching dataset records with title, notes, organisation, country, tags, resource list, licence and dates, plus the total match count.
GET /v1/data/hdx/dataset-suggest1 creditReturns up to ten dataset suggestions for a partial query, each with name, title and the field the match came from.
GET /v1/data/hdx/group1 creditReturns one group by id with its display name, description, image, package count and the datasets filed under it.
GET /v1/data/hdx/group-datasets1 creditReturns the datasets filed under one group, with the same full metadata as the search route and the total count for that group.
GET /v1/data/hdx/groups1 creditReturns the catalogue's groups - the country and crisis groupings HDX files datasets under - with id, display name, description, dataset count and image.
GET /v1/data/hdx/licenses1 creditReturns the licence vocabulary the catalogue accepts, with id, title, family and ODC/OSD conformance flags.
GET /v1/data/hdx/organization1 creditReturns one contributing organisation's record: id, title, description, image, approval status, custom HDX fields and dataset count.
GET /v1/data/hdx/organization-datasets1 creditReturns the datasets published by one organisation, with full metadata and the organisation's total dataset count.
GET /v1/data/hdx/organizations1 creditReturns every organisation contributing to HDX - UN agencies, NGOs, governments - with id, title, description, image and dataset count.
GET /v1/data/hdx/resource1 creditReturns one resource's metadata: name, description, format, size, download and landing URLs, checksum, created and last-modified dates, and the dataset it belongs to.
GET /v1/data/hdx/resource-search1 creditSearches resource metadata rather than datasets, returning matching files with resource id, dataset id, name, format, size and URL, plus the total count.
GET /v1/data/hdx/tags1 creditReturns catalogue tag names matching a query, for building filters or normalising topic vocabulary.
Licence
After downloading a public dataset, users must follow the applicable license when using and sharing the data.
https://data.humdata.org/faqs/termsAttribution
Display this wherever you show the data. It arrives on every response as provenance.attribution_text.
Data from the Humanitarian Data Exchange (HDX), United Nations Office for the Coordination of Humanitarian Affairs (OCHA). Each dataset retains the licence and attribution of its contributing organisation.
Cache: up to 3600s
