산업생산 과거 데이터 API
한 국가의 월별 산업생산지수를 오래된 순으로 조회합니다.
economics_ —REST와 다음 economics_ MCP 도구입니다. 둘 다 같은 데이터 형식을 반환하며 같은 크레딧을 사용합니다.
엔드포인트 및 요청
GET /v1/economics/{country}/industrial-production/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/industrial-production/observations?start=2026-01&limit=2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP에서 사용하는 도구: economics_ —아래의 해당 인수로 호출하세요.
매개변수
이 작업에서 허용되는 기간 형식: YYYY-MM.
| 이름 | 필수 | 유형 | 의미 |
|---|---|---|---|
country | 예 | 경로 · ISO alpha-3 | 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요. |
start | 아니요 | 쿼리 · YYYY-MM | 조회 범위의 첫 관측 기간이며, 해당 기간도 포함합니다. |
end | 아니요 | 쿼리 · YYYY-MM | 조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다. |
limit | 아니요 | 쿼리 · 정수, 1~1000 | 반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요. |
cursor | 아니요 | 쿼리 · 불투명 문자열 | 이전 페이지의 next_cursor입니다. |
series_ | 아니요 | 쿼리 · UUID | 선택 사항입니다. 이전 응답에서 얻은 시계열 하나의 `series_id`입니다. 생략하면 해당 국가의 기본 시계열을 읽습니다. |
응답
{
"source": {
"publisher": "OECD",
"distributor": "OECD"
},
"seasonal_adjustment": "seasonally_and_calendar_adjusted",
"base_period": "2015",
"base_value": "100",
"country": "USA",
"series_id": "ea690cc4-a528-4c6d-b07a-5ecbdac08575",
"unit": "index",
"observations": [
{
"period": "2026-01",
"value": "100.1"
},
{
"period": "2026-02",
"value": "100.9"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}이력 예제는 limit=2를 요청하므로 두 행이 있습니다. 여기서는 next_를 줄여 표시했습니다. 실제 값은 더 긴 불투명 문자열입니다.
| 필드 | 유형 | 필수 | 의미 |
|---|---|---|---|
source | 객체 | 예 | 수치를 발행한 기관입니다. publisher는 해당 수치를 낸 통계 기관이고, distributor는 Narwhal이 읽어 오는 기관입니다. 시계열당 전체 이력에 하나의 출처만 있습니다. released_은 없습니다. |
seasonal_ | 문자열 | 예 | Always seasonally_. |
base_ | 문자열 | 예 | 지수가 100인 연도: Eurostat 시계열은 2021, OECD 시계열은 2015입니다. |
base_ | 십진수 문자열 | 예 | 기준 연도의 지수 값입니다. 여기서는 모든 시계열이 100입니다. |
country | 문자열 | 예 | 요청된 대문자 ISO alpha-3 국가 코드입니다. |
series_ | 문자열 | 예 | 수치가 나온 시계열입니다. 같은 시계열을 다시 읽으려면 series_로 전달하세요. |
unit | 문자열 | 예 | Always index. |
observations | 배열 | 예 | 기간당 하나씩 오래된 순서의 관측값입니다. 한 페이지에 limit보다 적은 관측값이 있을 수 있습니다. next_가 null이 될 때까지 따라가세요. |
observations[].period | 문자열 | 예 | 관측값이 나타내는 공식 월, 분기 또는 연도입니다. |
observations[].value | 십진수 문자열 | 예 | 지수 수준이며, 기준은 base_와 base_에 있습니다. 증가율이 아니라 수준입니다. |
observations[].status | 문자열 | 아니요 | 발행 기관이 표시한 수치에만 포함됩니다: estimated, break_, definition_, break_. 그렇지 않으면 생략됩니다. |
observations[].release_ | 문자열 | 아니요 | 발행 기관이 수치를 잠정치로 표시한 경우 preliminary입니다. 그렇지 않으면 생략됩니다. |
next_ | 문자열 또는 null | 예 | 다음 페이지를 읽으려면 이 값을 변경하지 말고 cursor로 전달하세요. 마지막 페이지에서는 null입니다. |
API 오류 코드와 크레딧
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID,id startorendis not a month inYYYY-MMformat,startandenddiffer in format orstartis afterend, orlimitis outside 1 to 1000.version_,id versionandas_are not accepted on this route.of 400 invalid_: 커서의 형식이 잘못되었거나 다른 필터용으로 발급되었습니다.cursor 409 snapshot_: 커서가 24시간이 넘어 만료되었습니다.unavailable cursor없이 다시 시작하세요.401 invalid_: Bearer 키가 누락되었거나 거부되었습니다.api_ key 402 insufficient_: 잔액이 호출 비용에 부족합니다.credits 404 series_: 해당 국가가 이 페이지의 지원 국가 목록에 없거나,not_ found series_가 그 국가의 시계열이 아니거나, 범위에 관측값이 없습니다. 목록에 없는 국가에는 해당 지표군을 이용할 수 없다는 상세 설명이 반환됩니다. 404는 요금이 부과되지 않습니다.id 429 rate_: 네트워크 또는 계정의 단기 구간 한도에 도달했습니다.limit_ exceeded Retry-After이후에 다시 시도하세요.503 economics_: Narwhal이 저장된 시계열을 안전하게 제공할 수 없습니다.unavailable
Only a successful data response costs credit. 확인 모든 오류, 헤더 및 재시도 규칙.
최신성
이 경로는 Narwhal이 현재 저장한 시계열을 오래된 순으로 반환합니다. start가 없으면 저장된 가장 오래된 기간부터 시작하므로, 최근 기간을 읽으려면 start를 전달하세요. as_나 version을 받지 않으므로 이전 시점의 데이터는 읽을 수 없습니다. Narwhal은 누락된 관측값을 채우지 않고 생략합니다.
현재 공개 베타 데이터 범위
15 국가
BEL, BGR, BRA, CHL, CZE, EST, FIN, FRA, HRV, IRL, ITA, KOR, SVN, SWE, USA
월별 지수 수준이며 달력 조정 및 계절 조정이 되어 있습니다. Eurostat 시계열은 2021=100, OECD 시계열은 2015=100을 사용하며, 국가가 어느 쪽인지는 source와 base_에 나옵니다. 기준은 국가마다 다르므로 수준 비교는 한 국가 안에서만 하세요. 기간은 YYYY-MM 형식의 월입니다. 다른 국가는 404 not_를 반환하며 요금이 부과되지 않습니다.
일일 환율을 제공하는 API: 환율 API.
다음으로 돌아가기 모든 경제 데이터 작업.
무료 키로 시작하세요
매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.
이 페이지가 도움이 되었나요?