API reference (preview)

Production API will live at api.merkafri.app/v1 with keys and rate limits. This app exposes a read-only JSON mirror for integration testing.

GET /api/prices

Latest pilot snapshot for Angola. Query country=AO (optional). Other ISO codes return an empty data array until coverage exists.

curl -s "https://your-domain.com/api/prices" | jq

Try it: open JSON

Response shape

{
  "meta": {
    "country": "AO",
    "schema": "merkafri.prices.v0",
    "updated_at": "2026-03-21T12:00:00.000Z"
  },
  "data": [
    {
      "product_slug": "cooking-oil-1l",
      "product_name": "Cooking oil",
      "category": "Food",
      "unit": "1L",
      "price": 1470,
      "currency": "AOA",
      "country": "AO",
      "city": "Luanda",
      "change_pct_wow": 18,
      "observed_at": "2026-03-21T12:00:00.000Z"
    }
  ]
}

Full spec: MERKAFRI_SPEC_v2 §13 — history, forecast, anomalies, and webhooks ship with the FastAPI deployment.