Query granular native-unit observations
Bounded source-dimension filtering with source locators, dataset hashes, exact units, uncertainty and missing values. Duplicate and unknown parameters are rejected. A valid empty query returns zero matches; missing datasets remain unavailable. Source-specific licenses remain attached.
Request
- Base URL: https://narcoscope.com/api/v1
- URL: https://narcoscope.com/api/v1/market-observations
- Auth: none declared
Query parameters
Dataset ID from the catalog. Omit to query both available datasets.
Exact source-native indicator ID from the catalog.
Exact geography code from indicator dimensions; no implicit country-name mapping.
Exact category. Empty string matches empty categories; omitted means all.
Exact subgroup. Empty string matches empty subgroups; omitted means all.
Inclusive first year or month. A row must fit wholly within the requested interval; annual rows are not disaggregated.
Inclusive last year or month. Native source periods are preserved.
One-based page in stable dataset/indicator/geography/category/subgroup/period order. Retain dataset hashes across pages and restart if they change.
Maximum returned observations per page. No automatic market-size aggregation or unit conversion.
Response
Source-bound published data. Partial coverage lists unavailable datasets explicitly.
Changes
No recorded changes to this operation across all 1 revision of this API.