{"openapi":"3.1.0","info":{"title":"North Macedonia Statistics API","version":"1.0.0","description":"Official North Macedonian inflation statistics straight from the State Statistical Office (MAKStat) via its ASKdata-style PxWeb open-data service — no key, read live. The cpi endpoint returns the headline Consumer Price Index inflation for the latest month — the month-on-month and year-on-year percentage changes (ECOICOP version 2 classification) — derived from the official ratio table. The cpi/series endpoint returns the historical monthly MoM and YoY series over the last N months, ready to chart. The cpi/groups endpoint breaks the latest year-on-year inflation down across all thirteen COICOP main groups (food, housing, transport and so on). The cpi/group endpoint returns the full MoM and YoY history for any single COICOP group by its code. The meta endpoint documents the COICOP group codes and source. Live data from MAKStat PxWeb, lightly cached. Live. 5 endpoints. This serves North Macedonian national price statistics; for the denar exchange rate use an FX / central-bank API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/macedonia-stats-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/cpi":{"get":{"operationId":"get_v1_cpi","tags":["Inflation"],"summary":"North Macedonia CPI (latest month): MoM and YoY","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Index 2015=100 base table publishes month-on-month and year-on-year ratios; values are percentage changes.","period":"2026M05","source":"State Statistical Office of North Macedonia (MAKStat, table 121)","country":"North Macedonia","indicator":"Consumer Price Index (Total, ECOICOP v2)","period_iso":"2026-05","change_mom_pct":0.64,"change_yoy_pct":4.75},"meta":{"timestamp":"2026-06-15T20:40:33.375Z","request_id":"fb2b6c64-54bb-4172-bf14-955c448906c3"},"status":"ok","message":"North Macedonia CPI retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cpi/group":{"get":{"operationId":"get_v1_cpi_group","tags":["Inflation"],"summary":"Full MoM + YoY history for one COICOP group","description":"","parameters":[{"name":"group","in":"query","required":false,"description":"COICOP code: 001 Total, 002 Food .. 014 (see /v1/meta)","schema":{"type":"string"},"example":"001"},{"name":"months","in":"query","required":false,"description":"Number of recent months (default 24, max 120)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":24,"group":"001","label":"Total","series":[{"period":"2024M06","period_iso":"2024-06","change_mom_pct":-0.27,"change_yoy_pct":3.24},{"period":"2024M07","period_iso":"2024-07","change_mom_pct":0.74,"change_yoy_pct":2.95},{"period":"2024M08","period_iso":"2024-08","change_mom_pct":0.5,"change_yoy_pct":2.24},{"period":"2024M09","period_iso":"2024-09","change_mom_pct":0.28,"change_yoy_pct":2.59},{"period":"2024M10","period_iso":"2024-10","change_mom_pct":-0.7,"change_yoy_pct":3.46},{"period":"2024M11","period_iso":"2024-11","change_mom_pct":0.96,"change_yoy_pct":4.3},{"period":"2024M12","period_iso":"2024-12","change_mom_pct":0.31,"change_yoy_pct":4.39},{"period":"2025M01","period_iso":"2025-01","change_mom_pct":0.16,"change_yoy_pct":4.92},{"period":"2025M02","period_iso":"2025-02","change_mom_pct":0.48,"change_yoy_pct":5},{"period":"2025M03","period_iso":"2025-03","change_mom_pct":-1.3,"change_yoy_pct":2.73},{"period":"2025M04","period_iso":"2025-04","change_mom_pct":0.63,"change_yoy_pct":2.64},{"period":"2025M05","period_iso":"2025-05","change_mom_pct":1.51,"change_yoy_pct":3.31},{"period":"2025M06","period_iso":"2025-06","change_mom_pct":0.84,"change_yoy_pct":4.46},{"period":"2025M07","period_iso":"2025-07","change_mom_pct":1.07,"change_yoy_pct":4.8},{"period":"2025M08","period_iso":"2025-08","change_mom_pct":0.15,"change_yoy_pct":4.44},{"period":"2025M09","period_iso":"2025-09","change_mom_pct":-0.16,"change_yoy_pct":3.99},{"period":"2025M10","period_iso":"2025-10","change_mom_pct":-0.22,"change_yoy_pct":4.49},{"period":"2025M11","period_iso":"2025-11","change_mom_pct":0.51,"change_yoy_pct":4.02},{"period":"2025M12","period_iso":"2025-12","change_mom_pct":0.4,"change_yoy_pct":4.12},{"period":"2026M01","period_iso":"2026-01","change_mom_pct":-0.73,"change_yoy_pct":3.19},{"period":"2026M02","period_iso":"2026-02","change_mom_pct":0.15,"change_yoy_pct":2.86},{"period":"2026M03","period_iso":"2026-03","change_mom_pct":0.7,"change_yoy_pct":4.94},{"period":"2026M04","period_iso":"2026-04","change_mom_pct":1.31,"change_yoy_pct":5.65},{"period":"2026M05","period_iso":"2026-05","change_mom_pct":0.64,"change_yoy_pct":4.75}],"source":"MAKStat table 121","country":"North Macedonia"},"meta":{"timestamp":"2026-06-15T20:40:33.471Z","request_id":"3af06a29-9e51-4a45-9abd-9b5922029863"},"status":"ok","message":"North Macedonia CPI group series retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cpi/groups":{"get":{"operationId":"get_v1_cpi_groups","tags":["Inflation"],"summary":"Latest YoY inflation across all 13 COICOP groups","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":13,"groups":[{"group":"002","label":"01 Food & non-alcoholic beverages","change_yoy_pct":4.74},{"group":"003","label":"02 Alcoholic beverages & tobacco","change_yoy_pct":9.33},{"group":"004","label":"03 Clothing & footwear","change_yoy_pct":2.16},{"group":"005","label":"04 Housing, water, electricity, gas & fuels","change_yoy_pct":2.88},{"group":"006","label":"05 Furnishings & household equipment","change_yoy_pct":4.64},{"group":"007","label":"06 Health","change_yoy_pct":1.82},{"group":"008","label":"07 Transport","change_yoy_pct":11.03},{"group":"009","label":"08 Information & communication","change_yoy_pct":2.79},{"group":"010","label":"09 Recreation, sport & culture","change_yoy_pct":5.52},{"group":"011","label":"10 Education services","change_yoy_pct":4.57},{"group":"012","label":"11 Restaurants & accommodation","change_yoy_pct":5.02},{"group":"013","label":"12 Insurance & financial services","change_yoy_pct":1.65},{"group":"014","label":"13 Personal care, social protection & misc","change_yoy_pct":2.12}],"period":"2026M05","source":"MAKStat table 121","country":"North Macedonia","indicator":"CPI year-on-year by COICOP group","period_iso":"2026-05"},"meta":{"timestamp":"2026-06-15T20:40:33.551Z","request_id":"e208c1f7-bfc5-4c85-a381-d5fbf69859a6"},"status":"ok","message":"North Macedonia CPI by group retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cpi/series":{"get":{"operationId":"get_v1_cpi_series","tags":["Inflation"],"summary":"Historical monthly MoM + YoY series","description":"","parameters":[{"name":"months","in":"query","required":false,"description":"Number of recent months (default 24, max 120)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":24,"series":[{"period":"2024M06","period_iso":"2024-06","change_mom_pct":-0.27,"change_yoy_pct":3.24},{"period":"2024M07","period_iso":"2024-07","change_mom_pct":0.74,"change_yoy_pct":2.95},{"period":"2024M08","period_iso":"2024-08","change_mom_pct":0.5,"change_yoy_pct":2.24},{"period":"2024M09","period_iso":"2024-09","change_mom_pct":0.28,"change_yoy_pct":2.59},{"period":"2024M10","period_iso":"2024-10","change_mom_pct":-0.7,"change_yoy_pct":3.46},{"period":"2024M11","period_iso":"2024-11","change_mom_pct":0.96,"change_yoy_pct":4.3},{"period":"2024M12","period_iso":"2024-12","change_mom_pct":0.31,"change_yoy_pct":4.39},{"period":"2025M01","period_iso":"2025-01","change_mom_pct":0.16,"change_yoy_pct":4.92},{"period":"2025M02","period_iso":"2025-02","change_mom_pct":0.48,"change_yoy_pct":5},{"period":"2025M03","period_iso":"2025-03","change_mom_pct":-1.3,"change_yoy_pct":2.73},{"period":"2025M04","period_iso":"2025-04","change_mom_pct":0.63,"change_yoy_pct":2.64},{"period":"2025M05","period_iso":"2025-05","change_mom_pct":1.51,"change_yoy_pct":3.31},{"period":"2025M06","period_iso":"2025-06","change_mom_pct":0.84,"change_yoy_pct":4.46},{"period":"2025M07","period_iso":"2025-07","change_mom_pct":1.07,"change_yoy_pct":4.8},{"period":"2025M08","period_iso":"2025-08","change_mom_pct":0.15,"change_yoy_pct":4.44},{"period":"2025M09","period_iso":"2025-09","change_mom_pct":-0.16,"change_yoy_pct":3.99},{"period":"2025M10","period_iso":"2025-10","change_mom_pct":-0.22,"change_yoy_pct":4.49},{"period":"2025M11","period_iso":"2025-11","change_mom_pct":0.51,"change_yoy_pct":4.02},{"period":"2025M12","period_iso":"2025-12","change_mom_pct":0.4,"change_yoy_pct":4.12},{"period":"2026M01","period_iso":"2026-01","change_mom_pct":-0.73,"change_yoy_pct":3.19},{"period":"2026M02","period_iso":"2026-02","change_mom_pct":0.15,"change_yoy_pct":2.86},{"period":"2026M03","period_iso":"2026-03","change_mom_pct":0.7,"change_yoy_pct":4.94},{"period":"2026M04","period_iso":"2026-04","change_mom_pct":1.31,"change_yoy_pct":5.65},{"period":"2026M05","period_iso":"2026-05","change_mom_pct":0.64,"change_yoy_pct":4.75}],"source":"MAKStat table 121","country":"North Macedonia","indicator":"CPI Total monthly changes"},"meta":{"timestamp":"2026-06-15T20:40:33.652Z","request_id":"285724c8-1a8b-4823-b89e-749bcbc02dcb"},"status":"ok","message":"North Macedonia CPI series retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"API metadata + COICOP group codes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Statistics North Macedonia (MAKStat) API","notes":"Live data from MAKStat PxWeb (json-stat2); MoM = (current/previous month -1), YoY = (current/same month previous year -1), derived from the official ratio table.","source":"State Statistical Office of North Macedonia — MAKStat PxWeb API (makstat.stat.gov.mk)","country":"North Macedonia","endpoints":["/v1/cpi","/v1/cpi/series","/v1/cpi/groups","/v1/cpi/group","/v1/meta"],"coicop_groups":{"001":"Total","002":"01 Food & non-alcoholic beverages","003":"02 Alcoholic beverages & tobacco","004":"03 Clothing & footwear","005":"04 Housing, water, electricity, gas & fuels","006":"05 Furnishings & household equipment","007":"06 Health","008":"07 Transport","009":"08 Information & communication","010":"09 Recreation, sport & culture","011":"10 Education services","012":"11 Restaurants & accommodation","013":"12 Insurance & financial services","014":"13 Personal care, social protection & misc"},"documentation":"https://macedonia-stats-api.oanor.dev","primary_indicator":"Consumer Price Index by ECOICOP v2 (table 121) — month-on-month and year-on-year changes, Total + 13 COICOP groups"},"meta":{"timestamp":"2026-06-15T20:40:33.736Z","request_id":"60062621-5989-4c39-81a8-f3bee6db6086"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":260,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1190,"monthly_call_quota":18700,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3140,"monthly_call_quota":95500,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6890,"monthly_call_quota":433000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/macedonia-stats-api"}