GDP 성장률 API

한 분기의 공식 실질 GDP 성장률을 조회합니다. 불변가격으로 측정하며 퍼센트로 표시합니다.

economics_get_gdp_growth —REST와 다음 economics_get_gdp_growth MCP 도구를 통해 이용할 수 있습니다. 두 방식은 동일한 데이터 구조를 반환하고 동일한 월간 할당량을 소비합니다.

엔드포인트 및 요청

REST 엔드포인트

GET /v1/economics/{country}/gdp-growth

요청 예시

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP에서 사용하는 도구: economics_get_gdp_growth —아래의 해당 인수로 호출하세요.

매개변수

이 작업에서 허용되는 기간 형식: YYYY-QN.

이름	필수	유형	의미
`country`	예	경로 · ISO alpha-3	지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
`period`	아니요	쿼리 · YYYY-QN	수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
`version_id`	아니요	쿼리 · UUID	선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

응답

응답 예시

{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "released_on": "2026-07-30"
}

필드	유형	필수	의미
`country`	문자열	예	요청된 대문자 ISO alpha-3 국가 코드입니다.
`period`	문자열	예	반환된 공식 관측 기간입니다.
`year_over_year`	십진수 문자열	예	전년 같은 분기 대비 실질 GDP 변화율입니다. 단위는 퍼센트입니다.
`quarter_over_quarter`	십진수 문자열	예	전 분기 대비 실질 GDP 변화율입니다. 단위는 퍼센트이며, 연율로 환산되지 않았습니다.
`year_to_date`	십진수 문자열	아니요	소스가 발표하는 경우 제공되는 공식 연초 이후 누적 성장률입니다. 단위는 퍼센트이며, 발표되지 않으면 생략합니다.
`not_seasonally_adjusted`	`true`	아니요	성장률이 계절 조정되지 않은 경우에만 true로 포함됩니다.
`annualized`	`true`	아니요	발표된 성장률이 연율로 환산된 경우에만 true로 포함됩니다.
`year_over_year_not_seasonally_adjusted`	`true`	아니요	서로 다른 기준이 혼재하는 국가에서 전년 동기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다. 이때 최상위 플래그는 포함되지 않습니다.
`quarter_over_quarter_not_seasonally_adjusted`	`true`	아니요	서로 다른 기준이 혼재하는 국가에서 전 분기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다. 이때 최상위 플래그는 포함되지 않습니다.
`released_on`	날짜	예	Narwhal 조회 시각이 아닌 공식 발표일입니다.
`source`	객체	아니요	선택적 `source` 객체는 통계를 유통업체를 통해 받은 경우에만 포함됩니다. `publisher`(유통업체가 명시한 원 발표 기관)와 `distributor`(통계를 유통하는 기관)가 들어 있습니다. `source`가 있으면 `released_on`은 원 발표 기관의 발표일이 아니라 유통업체의 발표일입니다. 발표 기관에서 직접 가져오는 시계열에서는 `source`를 생략합니다.

오류 및 할당량

400 invalid_query — 국가, 기간 또는 필터 형식이 잘못되었습니다.
401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
403 plan_upgrade_required — 요청 기간 또는 범위가 요금제의 과거 데이터 범위(Free 12개월, Basic 5년)보다 이전에 끝납니다.
404 series_not_found — 요청과 일치하는 승인 관측값이 없습니다.
429 rate_limit_exceeded —네트워크 또는 계정의 단기 구간 한도에 도달했습니다. 재시도 전 대기 시간은 다음 헤더를 따르세요: Retry-After.
429 quota_exhausted — 계정이 월간 허용량에 도달했습니다.
503 economics_unavailable — Narwhal이 승인 발표를 안전하게 제공할 수 없습니다.

성공한 데이터 응답만 할당량을 소비합니다. 참고 항목: 모든 오류, 헤더 및 재시도 규칙.

현재 공개 베타 데이터 범위

36 국가

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

분기별 전년 동기 대비 및 전분기 대비 성장률은 아래 국가 목록을 따릅니다. 선택적 year_to_date 필드는 공식 출처가 제공할 때만 표시됩니다.

인도네시아 및 지역 경제 데이터 경로는 공개되지 않습니다. 일일 환율을 제공하는 API: 환율 API.

다음으로 돌아가기 모든 경제 데이터 작업.

엔드포인트 및 요청

매개변수

응답

오류 및 할당량

최신성

현재 공개 베타 데이터 범위