모든 API

경제 생산 GDP API

GDP API로 국가별 공식 GDP 수준과 GDP 성장률을 REST 또는 MCP로 읽습니다. 최신 승인값, 정확한 기간, 날짜별 이력을 요청할 수 있습니다.

무료 API 키 받기
문서 읽기 →
정상 운영 중99.94% uptime, last 30일378 ms 일반 응답 시간

첫 요청

최신 값 가져오기

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

엔드포인트

GET국내총생산/v1/economics/{country}/gdp

한 분기의 국가 GDP를 조회합니다. 항상 당해년가격 기준입니다.

매개변수

  • country필수

    지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.

  • period선택

    수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.

  • version_id선택

    선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.

응답 필드

  • country문자열

    요청된 대문자 ISO alpha-3 국가 코드입니다.

  • period문자열

    반환된 공식 관측 기간입니다.

  • value양의 십진수 문자열

    경상가격 기준 GDP 값입니다.

  • currencyISO 4217 문자열

    GDP 값의 국가 통화입니다.

  • not_seasonally_adjusted참

    공식 시계열이 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • annualized참

    공식 수준이 연율로 환산된 경우에만 true로 포함됩니다.

  • released_on날짜

    Narwhal 조회 시각이 아닌 공식 발표일입니다.

  • source객체

    선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.

전체 레퍼런스 →
GET국내총생산 과거 데이터/v1/economics/{country}/gdp/observations

특정 국가의 현재 승인된 국내총생산 시계열을 조회합니다.

매개변수

  • country필수

    지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.

  • start선택

    조회 범위의 첫 관측 기간이며, 해당 기간도 포함합니다.

  • end선택

    조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다.

  • limit선택

    반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요.

  • cursor선택

    이전 페이지의 next_cursor입니다.

  • version선택

    first_reported만 받습니다. 각 기간에 처음 저장된 값을 first_reported_at과 함께 반환합니다. as_of와 함께 쓸 수 없습니다.

  • as_of선택

    지정한 UTC 날짜가 끝날 때까지 공표된 그대로의 시리즈를 반환합니다. version과 함께 쓸 수 없습니다.

응답 필드

  • country문자열

    요청한 대문자 ISO alpha-3 국가 코드입니다. 관측값마다가 아니라 페이지당 한 번 반환합니다.

  • start문자열

    Narwhal이 요청한 start를 더 뒤의 기간으로 옮긴 경우에만 포함됩니다. 그보다 이전 기간은 반환하지 않습니다.

  • as_ofRFC 3339 타임스탬프

    이 페이지의 가장 최근 관측값을 소스가 마지막으로 갱신한 시각입니다. UTC 기준이며 소수점 이하 초는 없습니다.

  • source객체

    유통업체를 통해 받은 통계의 출처 정보입니다. 최신 값 조회 작업을 참조하세요.

  • currencyISO 4217 문자열

    페이지의 모든 값에 적용되는 자국 통화입니다.

  • not_seasonally_adjusted참

    수치가 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • annualized참

    수치가 연율로 환산된 경우에만 true로 포함됩니다.

  • observations배열

    채택된 관측값을 오래된 순서로 기간당 하나씩 반환합니다. 소스에 없는 값은 생략하며 채워 넣지 않습니다. 한 페이지의 관측값 수가 limit보다 적을 수 있으므로 next_cursor가 null이 될 때까지 따라가세요.

  • observations[].period문자열

    관측값이 나타내는 공식 월 또는 분기입니다.

  • observations[].first_reported_atRFC 3339 타임스탬프

    version=first_reported일 때만 나타납니다. 이 UTC 타임스탬프는 Narwhal이 해당 기간을 처음 저장한 시각입니다(지표가 따로 저장된 경우 가장 늦은 시각). 수집을 시작하기 전에 발표된 기간에는 Narwhal의 첫 수집 시각이 들어갑니다.

  • observations[].value십진수 문자열

    경상가격 기준 GDP 값입니다.

  • next_cursor문자열 또는 null

    다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.

전체 레퍼런스 →
GETGDP 성장률/v1/economics/{country}/gdp-growth

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

매개변수

  • country필수

    지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.

  • period선택

    수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.

  • version_id선택

    선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.

응답 필드

  • country문자열

    요청된 대문자 ISO alpha-3 국가 코드입니다.

  • period문자열

    반환된 공식 관측 기간입니다.

  • year_over_year십진수 문자열

    전년 같은 분기 대비 실질 GDP 변화율입니다. 단위는 퍼센트입니다.

  • quarter_over_quarter십진수 문자열

    전 분기 대비 실질 GDP 변화율입니다. 단위는 퍼센트이며, 연율로 환산되지 않았습니다.

  • year_to_date십진수 문자열

    소스가 발표하는 경우 제공되는 공식 연초 이후 누적 성장률입니다. 단위는 퍼센트이며, 발표되지 않으면 생략합니다.

  • not_seasonally_adjusted참

    성장률이 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • annualized참

    발표된 성장률이 연율로 환산된 경우에만 true로 포함됩니다.

  • year_over_year_not_seasonally_adjusted참

    서로 다른 기준이 혼재하는 국가에서 전년 동기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다. 이때 최상위 플래그는 포함되지 않습니다.

  • quarter_over_quarter_not_seasonally_adjusted참

    서로 다른 기준이 혼재하는 국가에서 전 분기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다. 이때 최상위 플래그는 포함되지 않습니다.

  • released_on날짜

    Narwhal 조회 시각이 아닌 공식 발표일입니다.

  • source객체

    선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.

전체 레퍼런스 →
GETGDP 성장률 과거 데이터/v1/economics/{country}/gdp-growth/observations

특정 국가의 현재 승인된 GDP 성장률 시계열을 조회합니다.

매개변수

  • country필수

    지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.

  • start선택

    조회 범위의 첫 관측 기간이며, 해당 기간도 포함합니다.

  • end선택

    조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다.

  • limit선택

    반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요.

  • cursor선택

    이전 페이지의 next_cursor입니다.

  • version선택

    first_reported만 받습니다. 각 기간에 처음 저장된 값을 first_reported_at과 함께 반환합니다. as_of와 함께 쓸 수 없습니다.

  • as_of선택

    지정한 UTC 날짜가 끝날 때까지 공표된 그대로의 시리즈를 반환합니다. version과 함께 쓸 수 없습니다.

응답 필드

  • country문자열

    요청한 대문자 ISO alpha-3 국가 코드입니다. 관측값마다가 아니라 페이지당 한 번 반환합니다.

  • start문자열

    Narwhal이 요청한 start를 더 뒤의 기간으로 옮긴 경우에만 포함됩니다. 그보다 이전 기간은 반환하지 않습니다.

  • as_ofRFC 3339 타임스탬프

    이 페이지의 가장 최근 관측값을 소스가 마지막으로 갱신한 시각입니다. UTC 기준이며 소수점 이하 초는 없습니다.

  • source객체

    유통업체를 통해 받은 통계의 출처 정보입니다. 최신 값 조회 작업을 참조하세요.

  • not_seasonally_adjusted참

    수치가 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • annualized참

    수치가 연율로 환산된 경우에만 true로 포함됩니다.

  • year_over_year_not_seasonally_adjusted참

    서로 다른 기준이 혼재하는 국가에서 전년 동기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • quarter_over_quarter_not_seasonally_adjusted참

    서로 다른 기준이 혼재하는 국가에서 전 분기 대비 수치가 계절 조정되지 않은 경우에만 true로 포함됩니다.

  • observations배열

    채택된 관측값을 오래된 순서로 기간당 하나씩 반환합니다. 소스에 없는 값은 생략하며 채워 넣지 않습니다. 한 페이지의 관측값 수가 limit보다 적을 수 있으므로 next_cursor가 null이 될 때까지 따라가세요.

  • observations[].period문자열

    관측값이 나타내는 공식 월 또는 분기입니다.

  • observations[].first_reported_atRFC 3339 타임스탬프

    version=first_reported일 때만 나타납니다. 이 UTC 타임스탬프는 Narwhal이 해당 기간을 처음 저장한 시각입니다(지표가 따로 저장된 경우 가장 늦은 시각). 수집을 시작하기 전에 발표된 기간에는 Narwhal의 첫 수집 시각이 들어갑니다.

  • observations[].year_over_year십진수 문자열

    전년 같은 분기 대비 실질 변화율입니다. 단위는 퍼센트입니다.

  • observations[].quarter_over_quarter십진수 문자열

    전 분기 대비 실질 변화율입니다. 단위는 퍼센트이며, 연율로 환산되지 않았습니다.

  • observations[].year_to_date십진수 문자열

    연초부터 현재까지의 실질 변화율입니다. 단위는 퍼센트입니다. 발표 기관이 발표하지 않으면 생략합니다.

  • next_cursor문자열 또는 null

    다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.

전체 레퍼런스 →

활용 사례

GDP 수준으로 성장률 구하기

분기 성장률을 계산해 연율로 표시합니다.

가이드 읽기 →

API로 경제지표 캘린더 직접 만들기

선택한 국가와 날짜의 발표 시각을 UTC로 나열합니다.

가이드 읽기 →

발표 전 알림 받기

캘린더 피드나 매일 실행하는 스크립트로 알림을 설정합니다.

가이드 읽기 →

과거 데이터 백필

시리즈 전체를 페이지 단위로 내려받고, 중단되면 이어서 받습니다.

가이드 읽기 →

데이터 범위

지표

국가

36개 국가 모두 보기

출처

  • 호주호주 통계청(ABS)
  • 오스트리아오스트리아 통계청, 유로스타트(Eurostat)
  • 벨기에Statbel, 벨기에 국립은행, Eurostat
  • 캐나다캐나다 통계청
  • 칠레칠레 중앙은행(BCCh), 칠레 국가통계원(INE)
  • 콜롬비아국가통계행정부(DANE)
  • 체코체코 통계청(ČSÚ)
  • 독일독일 연방통계청(Destatis)
  • 덴마크덴마크 통계청, 유로스타트(Eurostat)
  • 스페인스페인 국가통계원(INE), 스페인 국세청(AEAT)
  • 에스토니아Statistics Estonia
  • 핀란드Statistics Finland, 핀란드 관세청(Tulli)
출처 36개 모두 보기
  • 프랑스국립통계경제연구소(INSEE), 프랑스 관세청
  • 영국국가통계청(ONS)
  • 크로아티아크로아티아 통계청(CBS)
  • 아일랜드Central Statistics Office (CSO)
  • 이탈리아이탈리아 국립통계원(Istat), Eurostat
  • 일본일본 통계국, 일본 내각부, 일본 세관
  • 리투아니아리투아니아 국가데이터청
  • 룩셈부르크STATEC, 유로스타트(Eurostat)
  • 라트비아라트비아 중앙통계국(CSB)
  • 멕시코국립통계지리정보원(INEGI)
  • 말레이시아말레이시아 통계청(DOSM)
  • 네덜란드네덜란드 통계청(CBS)
  • 노르웨이Statistics Norway(SSB)
  • 뉴질랜드Stats NZ
  • 파키스탄파키스탄 통계국(PBS)
  • 필리핀필리핀 통계청(PSA)
  • 폴란드폴란드 통계청, 유로스타트(Eurostat)
  • 포르투갈Statistics Portugal(INE)
  • 카타르National Planning Council (NPC), Qatar Open Data 포털 경유
  • 사우디아라비아통계청(GASTAT)
  • 싱가포르싱가포르 통계청(SingStat), 싱가포르 정부 공개 데이터 발표
  • 슬로베니아슬로베니아 공화국 통계청(SURS)
  • 스웨덴Statistics Sweden(SCB)
  • 미국노동통계국(BLS), 경제분석국(BEA), 미국 인구조사국

관련 API

경제 데이터 API

가격, 노동, 생산, 무역 및 금리에 대한 공식 지표입니다.

API 탐색 →

경제 캘린더 API

발표 일정, 상태 및 공표 버전입니다.

API 탐색 →

자주 묻는 질문

실시간 범위에 GDP 성장률이 포함되나요?

네. GDP 수준과 GDP 성장률 모두 현재 실시간으로 제공됩니다.

특정 보고 기간을 조회할 수 있나요?

네. 정확한 기간을 요청하거나 날짜별 이력을 가져올 수 있습니다.

생산 데이터는 어디에서 오나요?

이 API는 각국 발표 기관의 공식 통계를 국가별로 정리해 제공합니다.