カナダ統計局データAPI

取得できるデータ

カナダ統計局データAPIには、系列の定義、過去の観測値、最新の観測値を取得するルートがあります。CPI、GDP、労働、貿易データを取得するには、必要な指標のベクトルを特定し、そのIDを各リクエストで使用してください。

レスポンスは、ソースの単位ラベルと季節調整情報を保持します。観測値は小数文字列で、公表日は取得できる場合に含まれます。欠けている期間は省略されます。提供中の系列には、改訂履歴や過去の公表時点別データはありません。

表のベクトルを探す

source=statcanと2から100文字の検索語でカタログを検索します。各結果は表を示し、タイトルには10-10-0106-01のような表番号が含まれます。結果のIDテンプレートはstatcan:v{vector}です。

curl --header "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/catalogue?q=consumer%20price&source=statcan&limit=2"

statcan.gc.caの表のページでベクトル番号を確認し、{vector}をその番号に置き換えてください。Narwhalには、表のベクトルを一覧表示するルートはまだありません。カタログ検索はすべてのプランで利用でき、カナダ統計局への呼び出しは行いません。

系列を取得する

idクエリパラメータに完全な系列IDを指定します。このリクエストは2026年の7月から9月までを取得し、開始期間と終了期間の両方を含みます。月次の範囲にはYYYY-MM、四半期にはYYYY-Qn、年次にはYYYYを使用します。

import os
import requests

response = requests.get(
    "https://api.narwhalapi.com/v1/economics/catalogue/series/observations",
    headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
    params={
        "id": "statcan:v41690973",
        "start": "2026-07",
        "end": "2026-09",
        "limit": 3,
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())

27 October 2026に取得した観測値の値と公表日は次のとおりです。

{
  "id": "statcan:v41690973",
  "title": "Canada;All-items",
  "frequency": "monthly",
  "unit": "extended",
  "unit_label": "2002=100",
  "seasonal_adjustment": "not_stated",
  "attribution": "Contains information licensed under the Open Government Licence - Canada. Source: Statistics Canada. Values normalised by Narwhal.",
  "licence_url": "https://open.canada.ca/en/open-government-licence-canada",
  "fetched_at": "2026-10-27T12:30:59Z",
  "observations": [
    {"period": "2026-07", "value": "169.9", "released_on": "2026-08-17"},
    {"period": "2026-08", "value": "169.8", "released_on": "2026-09-14"},
    {"period": "2026-09", "value": "170.0", "released_on": "2026-10-19"}
  ],
  "next_cursor": null
}

複数の系列をまとめて取得する

/v1/economics/catalogue/latestを使用し、idsクエリパラメータに最大50個の重複しないIDをカンマ区切りで指定します。レスポンスには最新の観測値とmissingリストが含まれます。RESTとMCPツールeconomics_read_catalogue_latest_batchは、同じバッチ処理を使用します。

バッチは一括で計上され、返された系列ごとに1回の呼び出しとして数えられます。古いデータを返す場合は計上されません。

提供対象外のデータ

日次、週次、複数年、会計年度、会計四半期のベクトルは404 not_foundを返します。表が検索インデックスに含まれていても、これらの頻度の制限は変わりません。

対応する観測値には、ソースに含まれている場合、provisionalやestimatedなどのステータスフラグが保持されます。計算に値を使う前に、期間や単位ラベルと併せてこれらのフラグを確認してください。APIは欠損を補完したり、系列の過去の版を復元したりしません。

プラン別の制限

すべてのプランで、履歴期間の範囲外であっても、少なくとも最新5件の年次観測値と最新4件の四半期観測値を取得できます。1日の取得枠を使い切った後も、キャッシュ済みの系列は引き続き取得できます。

取得枠を使い切った後にキャッシュ未格納データの取得が必要になるリクエストは、429 fetch_limit_reachedと、UTCの00:00までの待機時間を示すRetry-Afterを返します。年次と四半期の最低保証件数を考慮したうえで、指定範囲全体が許可された期間より前の場合は403 plan_upgrade_requiredを返します。リクエストの失敗についてはエラー処理をご覧ください。

ライセンス

カナダ統計局のデータには、カナダ政府オープンライセンスが適用されます。すべての系列レスポンスにattributionとlicence_urlが含まれるため、使用するデータとともにこのライセンス情報を保持してください。

検索インデックスには、カナダ統計局の現行の表が1,914件含まれます。検索結果は表を示し、ベクトルIDはAPIで取得する個々の系列を識別します。

カナダ統計局のベクトルIDとは何ですか？

ベクトル番号は、カナダ統計局の個々の系列を識別します。Narwhalではstatcan:v<vector>形式で表し、たとえばstatcan:v41690973となります。表番号はベクトルが掲載されている表を識別するもので、系列リクエストでベクトル番号の代わりには使用できません。

カナダ統計局のデータはどのくらいの頻度で更新されますか？

キャッシュの有効期間は、月次系列が6時間、四半期系列が12時間、年次系列が24時間です。次回の公表予定時刻になると、15分ごとに更新処理を実行します。

カナダ統計局に接続できない場合、保存済みのコピーをstale: true付きで返すことがあります。キャッシュ済みのコピーがない場合、リクエストは503 upstream_busyとRetry-Afterヘッダーを返します。