# Commodity prices (SPI)

The weekly price of daily life. This module has **30 essential retail items**, each reported for **17 cities** plus a national average, from the Pakistan Bureau of Statistics' Sensitive Price Indicator.

| | |
|---|---|
| Module | `commodities` |
| Frequency | Weekly (week ending Thursday, published Friday) |
| History | Jun 2025 -> (grows every week) |
| Endpoints | [`/v1/commodities`](https://pakdatahub.com/docs/api-commodities.md), or `/v1/series/commodities.<item>?dims=city:<city>` |

## Items (`commodities.<item>`)

| Group | Items |
|---|---|
| Staples | `wheat_flour` (20 kg bag), `rice_basmati`, `rice_irri`, `bread`, `sugar`, `gur`, `salt` |
| Protein & dairy | `beef`, `mutton`, `chicken`, `eggs` (dozen), `milk_fresh` (litre), `pulse_masoor`, `pulse_moong`, `pulse_mash`, `pulse_gram` |
| Oils | `cooking_oil` (5 L), `mustard_oil`, `vegetable_ghee_loose`, `vegetable_ghee_tin` (2.5 kg) |
| Vegetables | `potatoes`, `onions`, `tomatoes`, `garlic` |
| Beverages | `tea_packet` (190 g) |
| Energy | `petrol`, `diesel` (litre), `lpg` (cylinder), `gas` (MMBTU), `electricity` (unit) |

**Cities:** `bahawalpur`, `bannu`, `faisalabad`, `gujranwala`, `hyderabad`, `islamabad`, `karachi`, `khuzdar`, `lahore`, `larkana`, `multan`, `peshawar`, `quetta`, `rawalpindi`, `sargodha`, `sialkot`, `sukkur`, plus `national` (mean).

## Examples

```bash
# National flour price, weekly
curl -H "X-API-Key: pk_live_xxx" "https://api.pakdatahub.com/v1/commodities?item=wheat_flour&sort=asc"

# Petrol in Karachi vs Quetta
curl -H "X-API-Key: pk_live_xxx" "https://api.pakdatahub.com/v1/commodities/by-city?item=petrol&city=karachi"
curl -H "X-API-Key: pk_live_xxx" "https://api.pakdatahub.com/v1/commodities/by-city?item=petrol&city=quetta"

# Every city's sugar price in one call (no dims filter)
curl -H "X-API-Key: pk_live_xxx" "https://api.pakdatahub.com/v1/series/commodities.sugar?limit=18"
```

Derived from this data: the weekly [cost-of-living index](https://pakdatahub.com/docs/data-inflation.md) (`cost_of_living.<city>`) and the [cost-of-living tool](https://pakdatahub.com/tools/cost-of-living).

Use cases: food-price tracking, regional price dispersion, grocery-basket and cost-of-living indices, FMCG and procurement pricing, food-security research.

---
Source: https://pakdatahub.com/docs/data-commodities - PakDataHub docs index: https://pakdatahub.com/docs/llms.txt