실업률 API

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

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

엔드포인트 및 요청

REST 엔드포인트

GET /v1/economics/{country}/unemployment

요청 예시

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

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

매개변수

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

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

응답

응답 예시

{
  "country": "USA",
  "period": "2026-07",
  "rate": "4.1",
  "released_on": "2026-08-07"
}

필드	유형	필수	의미
`country`	문자열	예	요청된 대문자 ISO alpha-3 국가 코드입니다.
`period`	문자열	예	반환된 공식 관측 기간입니다.
`rate`	십진수 문자열	예	발표된 비율입니다. 퍼센트 단위이며 0 이상 100 이하입니다.
`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이 승인 발표를 안전하게 제공할 수 없습니다.

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

현재 공개 베타 데이터 범위

34 국가

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, PHL, POL, PRT, SAU, SGP, SVN, SWE, USA

관측 빈도는 각 공식 국가 발표를 따릅니다.

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

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

엔드포인트 및 요청

매개변수

응답

오류 및 할당량

최신성

현재 공개 베타 데이터 범위