API リファレンス

https://econalk.com/api/v1

API キーを Authorization ヘッダーに Bearer トークンとして渡してください。キーは作成時に一度だけ表示されます — 安全に保管してください。

Authorization: Bearer ek_live_<your-key>

X-API-Key ヘッダーで渡すこともできます。

制限は ECONALK メンバーシップに従います。コンソールと API キーは、別途の開発者登録なしに ECONALK アカウントをそのまま使用します。会員は Member ティアで、ECONALK プレミアム会員は1時間以内（コンソール訪問時は即時）に自動昇格します。

分あたりの制限は固定60秒ウィンドウを使用します。月間クォータは現在の UTC 月のすべてのリクエストを集計し、含有量を超えた使用分はティアごとの単価で従量課金されます（開発者コンソールでリアルタイムに確認可能）。ハードキャップに達すると 429 quota_exceeded で遮断されます。すべてのレスポンスには次のヘッダーが含まれます：

成功（リスト）

{
  "data": [ /* array of objects */ ],
  "pagination": {
    "total": 142,
    "limit": 20,
    "offset": 0
  }
}

成功（単一）

{
  "data": { /* single object */ }
}

エラー

{
  "error": {
    "code": "invalid_region",
    "message": "region must be us, kr, or jp"
  }
}

全地域の掲載記事をページネーション付きリストで返します。

クエリパラメータ

リクエスト例

curl "https://econalk.com/api/v1/articles?region=us&category=economy&limit=5" \
  -H "Authorization: Bearer ek_live_..."

レスポンス例

{
  "data": [
    {
      "slug": "2026-06-01-fed-rate-decision",
      "title": "Fed holds rates steady amid inflation data",
      "description": "The Federal Reserve opted to keep ...",
      "category": "economy",
      "region": "us",
      "date": "2026-06-01",
      "author": "ECONALK Editorial",
      "image": "/images/fed-rate.jpg"
    }
  ],
  "pagination": { "total": 142, "limit": 5, "offset": 0 }
}

スラッグで単一の記事を返します（フルレンダリングされたコンテンツを含む）。

パスパラメータ

クエリパラメータ

リクエスト例

curl "https://econalk.com/api/v1/articles/2026-06-01-fed-rate-decision?region=us" \
  -H "Authorization: Bearer ek_live_..."

戻り値

{
  "data": {
    "slug": "2026-06-01-fed-rate-decision",
    "title": "Fed holds rates steady ...",
    "description": "...",
    "category": "economy",
    "region": "us",
    "date": "2026-06-01",
    "author": "ECONALK Editorial",
    "image": "/images/fed-rate.jpg",
    "content": "<!-- full MDX-rendered HTML string -->"
  }
}

中央銀行の決定、CPI 発表、雇用統計など、今後（および直近）の経済イベントを返します。

クエリパラメータ

リクエスト例

curl "https://econalk.com/api/v1/economic-calendar?region=us&importance=3&futureDays=30" \
  -H "Authorization: Bearer ek_live_..."

レスポンス例

{
  "data": [
    {
      "eventName": "Fed Interest Rate Decision",
      "scheduledAt": "2026-07-30T18:00:00.000Z",
      "country": "United States",
      "category": "Central Bank",
      "importance": 3,
      "forecastValue": "4.25%",
      "previousValue": "4.25%",
      "actualValue": ""
    }
  ],
  "pagination": { "total": 12, "limit": 20, "offset": 0 }
}

すべてのリストエンドポイントは limit（デフォルト20、最大100）と offset（デフォルト0）をサポートします。レスポンスの pagination.total でページ数を計算してください: Math.ceil(total / limit)。

// Page 3 (zero-indexed), 10 per page
GET /api/v1/articles?limit=10&offset=20