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