publicsgdata 0.2.0

Python client for Singapore government open data (data.gov.sg, LTA, OneMap)

publicsgdata

Python client for Singapore government open data: data.gov.sg today, LTA and OneMap later.

Install

uv pip install publicsgdata

Quickstart

from publicsgdata import DataGovSGClient

with DataGovSGClient() as client:  # optional: api_key="..." or DATA_GOV_SG_API_KEY
    catalog = client.collections.list()
    print(f"{len(catalog.collections)} collections")
    print(catalog.collections[0].name)

    # HDB resale prices (swap in any dataset ID)
    rows = client.datasets.list_rows("d_8b84c4ee58e3cfc0ece0d773c8ca6abc", limit=10)
    for row in rows.rows:
        print(row.model_dump())

    pm25 = client.realtime.pm25.get()
    print(pm25.items[0].readings)

Download full dataset

from publicsgdata import DataGovSGClient

with DataGovSGClient() as client:
    path = client.datasets.download_file(
        "d_8b84c4ee58e3cfc0ece0d773c8ca6abc",
        "hdb-resale.csv",
    )
    print(path)

Async

from publicsgdata import AsyncDataGovSGClient

async with AsyncDataGovSGClient() as client:
    rows = await client.datasets.list_rows("d_8b84c4ee58e3cfc0ece0d773c8ca6abc", limit=5)
    print(len(rows.rows))

Custom HTTP client

Pass your own httpx client if you need custom timeouts, proxies, etc.

import httpx
from publicsgdata import DataGovSGClient

with httpx.Client(timeout=30.0) as http:
    client = DataGovSGClient(http_client=http)
    print(len(client.collections.list().collections))

Authentication

You can call the API without a key while experimenting. For regular use, get a key from data.gov.sg and set:

export DATA_GOV_SG_API_KEY="your-key"

Environment variables

Variable	Required	Description
DATA_GOV_SG_API_KEY	No	data.gov.sg API key (x-api-key header)

Roadmap

• v0.1.0: DataGovSGClient
• v0.2.0: LTAClient (LTA DataMall)
• v0.3.0: OneMapClient