로그인 API 키 받기

모든 API

국가별 고용 통계 API

고용 통계 API로 국가별 공식 실업률과 경제활동참가율 데이터를 읽습니다. REST 또는 MCP로 최신 승인값, 정확한 기간, 날짜별 이력을 가져옵니다.

무료 API 키 받기

문서 읽기 →

정상 운영 중99.94% uptime, last 30일378 ms 일반 응답 시간

첫 요청

최신 값 가져오기

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

엔드포인트

GET실업률/v1/economics/{country}/unemployment

특정 관측 기간의 공식 실업률을 조회합니다.

매개변수

country필수
지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period선택
수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id선택
선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.

응답 필드

country문자열
요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열
반환된 공식 관측 기간입니다.
rate십진수 문자열
발표된 비율입니다. 퍼센트 단위이며 0 이상 100 이하입니다.
released_on날짜
Narwhal 조회 시각이 아닌 공식 발표일입니다.
source객체
선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.

전체 레퍼런스 →

GET실업률 과거 데이터/v1/economics/{country}/unemployment/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[].rate십진수 문자열
발표된 비율입니다. 단위는 퍼센트입니다.
next_cursor문자열 또는 null
다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.

전체 레퍼런스 →

GET경제활동참가율/v1/economics/{country}/labour-force-participation

특정 관측 기간의 공식 경제활동참가율을 조회합니다.

매개변수

country필수
지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period선택
수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id선택
선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.

응답 필드

country문자열
요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열
반환된 공식 관측 기간입니다.
rate십진수 문자열
발표된 비율입니다. 퍼센트 단위이며 0 이상 100 이하입니다.
released_on날짜
Narwhal 조회 시각이 아닌 공식 발표일입니다.
source객체
선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.

전체 레퍼런스 →

GET경제활동참가율 과거 데이터/v1/economics/{country}/labour-force-participation/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[].rate십진수 문자열
발표된 비율입니다. 단위는 퍼센트입니다.
next_cursor문자열 또는 null
다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.

전체 레퍼런스 →

활용 사례

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

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

가이드 읽기 →

발표 전 알림 받기

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

가이드 읽기 →

과거 데이터 백필

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

가이드 읽기 →

출처

호주호주 통계청(ABS)
오스트리아오스트리아 통계청, 유로스타트(Eurostat)
벨기에Statbel, 벨기에 국립은행, Eurostat
캐나다캐나다 통계청
스위스스위스 연방통계청(FSO), Eurostat
칠레칠레 중앙은행(BCCh), 칠레 국가통계원(INE)
콜롬비아국가통계행정부(DANE)
체코체코 통계청(ČSÚ)
독일독일 연방통계청(Destatis)
덴마크덴마크 통계청, 유로스타트(Eurostat)
스페인스페인 국가통계원(INE), 스페인 국세청(AEAT)
에스토니아Statistics Estonia

출처 35개 모두 보기

핀란드Statistics Finland, 핀란드 관세청(Tulli)
프랑스국립통계경제연구소(INSEE), 프랑스 관세청
영국국가통계청(ONS)
크로아티아크로아티아 통계청(CBS)
아일랜드Central Statistics Office (CSO)
이탈리아이탈리아 국립통계원(Istat), Eurostat
일본일본 통계국, 일본 내각부, 일본 세관
리투아니아리투아니아 국가데이터청
룩셈부르크STATEC, 유로스타트(Eurostat)
라트비아라트비아 중앙통계국(CSB)
멕시코국립통계지리정보원(INEGI)
말레이시아말레이시아 통계청(DOSM)
네덜란드네덜란드 통계청(CBS)
노르웨이Statistics Norway(SSB)
뉴질랜드Stats NZ
필리핀필리핀 통계청(PSA)
폴란드폴란드 통계청, 유로스타트(Eurostat)
포르투갈Statistics Portugal(INE)
사우디아라비아통계청(GASTAT)
싱가포르싱가포르 통계청(SingStat), 싱가포르 정부 공개 데이터 발표
슬로베니아슬로베니아 공화국 통계청(SURS)
스웨덴Statistics Sweden(SCB)
미국노동통계국(BLS), 경제분석국(BEA), 미국 인구조사국

관련 API

경제 데이터 API

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

경제 캘린더 API

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

방법론

발표를 확인하고 수정하는 방법입니다.

방법론 읽기 →

자주 묻는 질문

어떤 노동 지표를 실시간으로 제공하나요?

실업률과 경제활동참가율은 현재 실시간으로 제공됩니다.

과거 노동 데이터를 가져올 수 있나요?

네. 최신 승인 값과 함께 날짜별 이력과 정확한 기간 요청을 사용할 수 있습니다.

REST와 MCP는 같은 API 키를 사용하나요?

네. 같은 API 키가 REST와 MCP에서 모두 작동합니다.