API Docs
Reference for the read APIs behind the OrionGIS catalogue — pull datasets, web services, and Orion AI search results directly into your own tools.

Authentication

Everything on this page is a read endpoint against public or published resources and needs no API key. Restricted datasets require a GeoNode session/OAuth2 bearer token — request access from your OrionGIS admin (Contact Admin) if a request returns 403.

Catalogue — Datasets

The catalogue is served by GeoNode's REST API v2. List and filter datasets, or fetch one dataset's full metadata (including its attribute schema and extent — the same data that powers each dataset's detail page and Web Services box below).

GET/api/v2/datasets/?filter{title.icontains}=roads&page_size=20
GET/api/v2/datasets/{id}/
curl "https://orionterrametrics.com/api/v2/datasets/?filter%7Btitle.icontains%7D=roads&page_size=20"

Web Services (WMS / WFS / WCS)

Every published dataset is also served as an OGC web service via GeoServer — render it as a map layer (WMS), pull raw features as GeoJSON (WFS, vector datasets), or fetch raw pixels (WCS, raster datasets). Each dataset's detail page has ready-made, copyable URLs for its own layer under “Web services”.

GET/geoserver/ows?service=WMS&request=GetCapabilities
GET/geoserver/ows?service=WFS&request=GetFeature&typeNames={layer}&outputFormat=application/json
GET/geoserver/ows?service=WCS&request=GetCoverage&coverageId={layer}
curl "https://orionterrametrics.com/geoserver/ows?service=WFS&version=2.0.0&request=GetFeature&typeNames=geonode:kenya_wards&outputFormat=application/json"

Orion AI — Semantic Search

Search the catalogue by meaning rather than exact keywords, powered by Orion Core's self-hosted embeddings over every dataset's metadata. Returns dataset ids ranked by similarity (0–1).

GET/orion-core-api/api/v1/search?q={query}&limit=10
curl "https://orionterrametrics.com/orion-core-api/api/v1/search?q=malaria+health+facilities&limit=10"

{
  "query": "malaria health facilities",
  "results": [
    { "geonode_dataset_id": 931, "similarity": 0.81, "metadata_text": "..." }
  ]
}

Rate limits & fair use

These are shared, best-effort endpoints on a modest server — please cache responses client-side and avoid tight polling loops. For a bulk export or a recurring integration, contact the admin so we can plan for the load.