v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Global Economy & Trade

Search the HDX catalog

Free-text + structured search over the UN OCHA Humanitarian Data Exchange (HDX) catalog. Backed by CKAN package_search with Solr query syntax. Use q for keywords, and any combination of country (lowercase ISO-3 alpha, mapped to CKAN groups), tag (Topics vocabulary slug), organization (CKAN organization slug) to narrow results. Page with rows and start; upstream caps rows at 1000. Response includes facet counts for organization, country group, and Topics tags.

get/api/v1/hdx/search

Query parameters

qstring nullable

Solr query string - keywords, phrases, or Solr field queries. Empty = all datasets.

Solr query string - keywords, phrases, or Solr field queries. Empty = all datasets.

countrystring nullable

Lowercase ISO-3 alpha country code (CKAN group), e.g. sdn, ukr, afg.

Lowercase ISO-3 alpha country code (CKAN group), e.g. sdn, ukr, afg.

tagstring nullable

Topics vocabulary tag slug (see /hdx/topics), e.g. refugees, food-security.

Topics vocabulary tag slug (see /hdx/topics), e.g. refugees, food-security.

organizationstring nullable

CKAN organization slug (publisher), e.g. unhcr, ocha-sudan, wfp.

CKAN organization slug (publisher), e.g. unhcr, ocha-sudan, wfp.

rowsinteger

Page size (max 1000 per upstream cap).

Page size (max 1000 per upstream cap).

startinteger

Page offset for pagination.

Page offset for pagination.

sortstring nullable

CKAN sort directive, e.g. metadata_modified desc, score desc, metadata_modified desc.

CKAN sort directive, e.g. metadata_modified desc, score desc, metadata_modified desc.

Response

Matched datasets, facet counts, and upstream total count.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}