국가별 물가상승률 비교
최신 물가상승률을 순위로 매기고 각 발표일을 함께 보관합니다.
가이드 읽기 →모든 API
물가 API와 인플레이션
물가 API로 국가별 공식 CPI와 인플레이션 데이터를 REST 또는 MCP로 조회합니다. 최신 승인값, 정확한 기간, 날짜별 이력을 가져올 수 있습니다.
첫 요청
최신 값 가져오기
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"엔드포인트
GET소비자물가지수/v1/economics/{country}/cpi
특정 국가의 특정 월 소비자물가지수 총지수를 조회합니다.
매개변수
country필수지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period선택수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id선택선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.
응답 필드
country문자열요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열반환된 공식 관측 기간입니다.
value양의 십진수 문자열총지수 값입니다.
index_base문자열지수의 기준 기간과 기준값입니다. 예: 1982-84=100.
released_on날짜Narwhal 조회 시각이 아닌 공식 발표일입니다.
source객체선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.
전체 레퍼런스 →
GET소비자물가지수 과거 데이터/v1/economics/{country}/cpi/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객체유통업체를 통해 받은 통계의 출처 정보입니다. 최신 값 조회 작업을 참조하세요.
index_base문자열지수의 기준 기간과 기준값입니다. 예: 1982-84=100. 한 페이지에 서로 다른 두 기준이 섞이지 않습니다.
observations배열채택된 관측값을 오래된 순서로 기간당 하나씩 반환합니다. 소스에 없는 값은 생략하며 채워 넣지 않습니다. 한 페이지의 관측값 수가 limit보다 적을 수 있으므로 next_cursor가 null이 될 때까지 따라가세요.
observations[].period문자열관측값이 나타내는 공식 월 또는 분기입니다.
observations[].first_reported_atRFC 3339 타임스탬프version=first_reported일 때만 나타납니다. 이 UTC 타임스탬프는 Narwhal이 해당 기간을 처음 저장한 시각입니다(지표가 따로 저장된 경우 가장 늦은 시각). 수집을 시작하기 전에 발표된 기간에는 Narwhal의 첫 수집 시각이 들어갑니다.
observations[].value십진수 문자열이진 부동소수점 변환을 거치지 않은 채택된 지수 수준입니다.
next_cursor문자열 또는 null다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.
전체 레퍼런스 →
GET인플레이션/v1/economics/{country}/inflation
특정 월의 전년 동월 대비, 전월 대비 및 연초 이후 누적 인플레이션율을 조회합니다.
매개변수
country필수지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period선택수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id선택선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.
응답 필드
country문자열요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열반환된 공식 관측 기간입니다.
year_over_year십진수 문자열전년 같은 달 대비 변화율입니다. 단위는 퍼센트입니다.
month_over_month십진수 문자열전월 대비 변화율입니다. 단위는 퍼센트입니다.
year_to_date십진수 문자열전년도 12월 대비 변화율입니다. 단위는 퍼센트입니다. 발표 기관이 발표하지 않으면 생략합니다.
released_on날짜Narwhal 조회 시각이 아닌 공식 발표일입니다.
source객체선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.
전체 레퍼런스 →
GET인플레이션 과거 데이터/v1/economics/{country}/inflation/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객체유통업체를 통해 받은 통계의 출처 정보입니다. 최신 값 조회 작업을 참조하세요.
observations배열채택된 관측값을 오래된 순서로 기간당 하나씩 반환합니다. 소스에 없는 값은 생략하며 채워 넣지 않습니다. 한 페이지의 관측값 수가 limit보다 적을 수 있으므로 next_cursor가 null이 될 때까지 따라가세요.
observations[].period문자열관측값이 나타내는 공식 월 또는 분기입니다.
observations[].first_reported_atRFC 3339 타임스탬프version=first_reported일 때만 나타납니다. 이 UTC 타임스탬프는 Narwhal이 해당 기간을 처음 저장한 시각입니다(지표가 따로 저장된 경우 가장 늦은 시각). 수집을 시작하기 전에 발표된 기간에는 Narwhal의 첫 수집 시각이 들어갑니다.
observations[].year_over_year십진수 문자열전년 같은 달 대비 변화율입니다. 단위는 퍼센트입니다.
observations[].month_over_month십진수 문자열전월 대비 변화율입니다. 단위는 퍼센트입니다.
observations[].year_to_date십진수 문자열전년도 12월 대비 변화율입니다. 단위는 퍼센트입니다. 발표 기관이 발표하지 않으면 생략합니다.
next_cursor문자열 또는 null다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.
전체 레퍼런스 →
활용 사례
데이터 범위
지표
국가
출처
- 호주호주 통계청(ABS)
- 오스트리아오스트리아 통계청, 유로스타트(Eurostat)
- 벨기에Statbel, 벨기에 국립은행, Eurostat
- 캐나다캐나다 통계청
- 스위스스위스 연방통계청(FSO), Eurostat
- 칠레칠레 중앙은행(BCCh), 칠레 국가통계원(INE)
- 콜롬비아국가통계행정부(DANE)
- 체코체코 통계청(ČSÚ)
- 독일독일 연방통계청(Destatis)
- 덴마크덴마크 통계청, 유로스타트(Eurostat)
- 스페인스페인 국가통계원(INE), 스페인 국세청(AEAT)
- 에스토니아Statistics Estonia
출처 36개 모두 보기
- 핀란드Statistics Finland, 핀란드 관세청(Tulli)
- 프랑스국립통계경제연구소(INSEE), 프랑스 관세청
- 영국국가통계청(ONS)
- 크로아티아크로아티아 통계청(CBS)
- 아일랜드Central Statistics Office (CSO)
- 이탈리아이탈리아 국립통계원(Istat), Eurostat
- 일본일본 통계국, 일본 내각부, 일본 세관
- 리투아니아리투아니아 국가데이터청
- 룩셈부르크STATEC, 유로스타트(Eurostat)
- 라트비아라트비아 중앙통계국(CSB)
- 멕시코국립통계지리정보원(INEGI)
- 말레이시아말레이시아 통계청(DOSM)
- 네덜란드네덜란드 통계청(CBS)
- 노르웨이Statistics Norway(SSB)
- 필리핀필리핀 통계청(PSA)
- 폴란드폴란드 통계청, 유로스타트(Eurostat)
- 포르투갈Statistics Portugal(INE)
- 카타르National Planning Council (NPC), Qatar Open Data 포털 경유
- 사우디아라비아통계청(GASTAT)
- 싱가포르싱가포르 통계청(SingStat), 싱가포르 정부 공개 데이터 발표
- 슬로베니아슬로베니아 공화국 통계청(SURS)
- 스웨덴Statistics Sweden(SCB)
- 미국노동통계국(BLS), 경제분석국(BEA), 미국 인구조사국
- 파키스탄파키스탄 통계국(PBS)
관련 API
자주 묻는 질문
CPI 수준과 인플레이션율을 모두 제공하나요?
네. 실시간 범위에는 CPI 지수 수준과 인플레이션율이 포함됩니다.
특정 기간을 요청할 수 있나요?
네. 정확한 기간을 요청하거나, 날짜별 이력을 가져오거나, 최신 승인 값을 조회할 수 있습니다.
통계는 어디에서 오나요?
각국 발표 기관의 공식 통계로, 국가별로 정리되어 있습니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.