JSON

대한무역투자진흥공사_한국 산업별 외국인직접투자통계

Name: 대한무역투자진흥공사_한국 산업별 외국인직접투자통계
Creator: 대한무역투자진흥공사
Published: 2021-09-14
License: http://www.kogl.or.kr/info/license.do#04-tab

QuickAISummary

관심목록에 추가

오픈 API 정보

데이터 오류·개선 의견이 있으신가요?

기본 정보

OpenAPI 명
대한무역투자진흥공사_한국 산업별 외국인직접투자통계
분류체계
산업·통상·중소기업 - 무역및투자유치
제공기관
대한무역투자진흥공사
관리부서명
디지털플랫폼팀
관리부서 전화번호

상세 및 제공정보

설명
KOTRA에서 공공 데이터 포털에 한국 산업 별 외국인 직접 투자 통계 open api를 개방 중에 있습니다. 이 데이터는 외국인 직접 투자에 대한 국가 별 통계를 제공하여, 정책 결정자, 연구자, 기업 등 다양한 사용자들이 활용할 수 있습니다. 특히, 투자 유치 전략 수립이나 시장 분석 등에 유용한 자료로, 2014년도부터 해당 기준 연도까지의 투자 금액을 확인할 수 있다. 또한, 해외 진출을 고려하는 기업들이 투자 유망 국가를 선정하는 데 참고 자료로 활용 할 수 있습니다. 해당 데이터는 파일 데이터 형태로도 도착 기준과 신고 기준으로 나뉘어 공공 데이터 포털에서 확인할 수 있습니다.
API 유형
REST
데이터 포맷
JSON
공간범위
-
시간범위
-
키워드
외국인직접투자,산업분류코드,투자유형,투자국가,투자금액,투자시기,지역별분포,산업별투자동향
활용신청 수
98
등록일
2021-09-14
수정일
2025-06-18

이용 조건 및 라이선스 정보

비용부과유무
무료
업데이트 주기
실시간
이용허락범위

공공저작물 : 출처표시, 상업적 이용금지, 변경금지 (제 4유형)
심의유형
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능

참고문서

활용가이드_대한무역투자진흥공사_한국 산업별 외국인직접투자통계.docx

표준 메타데이터

※ 데이터 연계 및 검색을 위한 표준 메타데이터입니다.

Schema.org DCAT

활용 정보

API 서비스

한국 산업별 투자신고 금액, 신고수, 투자도착 금액, 업체수 정보 조회 기능

API 기본 정보

활용승인 절차
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
요청주소
https://apis.data.go.kr/B410001/DS00000127/getDS00000127
서비스 URL
https://apis.data.go.kr/B410001/DS00000127

요청변수(Request Parameter)

해당 오픈API의 요청변수(Request Parameter) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
서비스키	ServiceKey	4	필	-	공공데이터포털에서 받은 인증키
페이지 번호	pageNo	4	필	1	페이지번호
한 페이지 결과 수	numOfRows	4	필	10	한 페이지 결과 수

출력결과(Response Element)

해당 오픈API의 출력결과(Response Element) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode	2	필	00	결과코드
결과메시지	resultMsg	50	필	OK	결과메시지
한 페이지 결과 수	numOfRows	4	필	10	한 페이지 결과 수
페이지 번호	pageNo	4	필	1	페이지번호
전체 결과 수	totalCount	4	필	3	전체 결과 수
기준연도	BASE_YR	4	옵	2021	기준연도
KSIC명	KSIC_NAME	100	옵	전체	KSIC명
레벨	LEVEL_CD	1	옵	0	레벨
신고수	STTMN_CNT	22	옵	751.0	신고수
신고금액	STTMN_AMT	22	옵	4938427434	신고금액
업체수	COMP_CNT	22	옵	510.0	업체수
투자금액	INVT_AMT	22	옵	4341735510	투자금액

오픈 API에 대한 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
APPLICATION_ERROR	01	GW 내부 처리 중 예기치 않은 오류가 발생했습니다. 잠시 후 다시 호출하고, 문제가 반복되면 활용지원센터로 문의해 주세요.
HTTP_ERROR	04	허용되지 않은 HTTP 요청이거나 기관 API 응답 처리에 실패했습니다. 요청 방식과 호출 URL을 확인해 주세요.
SERVICETIMEOUT_ERROR	05	기관 API 또는 GW 연계 서비스와의 연결에 실패했거나 응답 대기시간을 초과했습니다. 잠시 후 다시 호출해 주세요.
INVALID_REQUEST_PARAMETER_ERROR	10	요청 파라미터의 값이나 형식이 올바르지 않습니다. API 명세에서 파라미터 이름, 형식 및 허용값을 확인해 주세요.
NO_OPENAPI_SERVICE_ERROR	12	요청한 오픈API 서비스가 존재하지 않거나 폐기되었습니다. 호출 URL에 오타가 없는지 확인해 주세요.
SERVICE_KEY_IS_NULL	20	요청에 API 인증키가 포함되지 않았습니다. 공공데이터포털에서 발급받은 인증키를 요청 파라미터에 포함해 주세요.
PERMISSION_DENIED	20	GW 접근 권한 검사에서 요청이 거부되었습니다. 해당 API의 활용신청 및 접근 권한을 확인해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	22	API 서비스의 일일 호출 허용량을 초과했습니다. 호출량이 초기화된 이후 다시 이용하거나 트래픽 증설을 신청해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_PER_SECOND_EXCEEDS_ERROR	23	짧은 시간에 많은 요청이 발생하여 초당 호출 허용량을 초과했습니다. 잠시 후 다시 호출해 주세요.
BLACKLIST_IP_ACCESS_ERROR	29	차단된 IP에서 호출한 요청입니다. 호출 서버의 IP를 확인하고, 차단 해제가 필요한 경우 활용지원센터로 문의해 주세요.

인증 에러

오픈 API에 대한 인증 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
SERVICE_ACCESS_DENIED_ERROR	20	해당 API 서비스에 대한 이용 권한이 확인되지 않습니다. 활용신청 여부와 승인 또는 일시중지 상태를 확인해 주세요.
SERVICE_KEY_IS_NOT_REGISTERED_ERROR	30	등록되지 않은 API 인증키입니다. 인증키가 정확한지와 해당 서비스의 활용신청이 정상적으로 완료되었는지 확인해 주세요.
DEADLINE_HAS_EXPIRED_ERROR	31	API 인증키의 사용 기한이 만료되었습니다. 공공데이터포털에서 이용 기간을 확인하거나 갱신해 주세요.

DATA.GO.KR 공공데이터포털

공공데이터

데이터활용

정보공유

이용안내

공공데이터

데이터활용

기업공공데이터 문제해결지원센터

정보공유

이용안내

공공데이터

데이터활용

기업공공데이터 문제해결지원센터

정보공유

이용안내

대한무역투자진흥공사_한국 산업별 외국인직접투자통계

오픈 API 정보

기본 정보

상세 및 제공정보

이용 조건 및 라이선스 정보

참고문서

표준 메타데이터

활용 정보

한국 산업별 투자신고 금액, 신고수, 투자도착 금액, 업체수 정보 조회 기능

API 기본 정보

요청변수(Request Parameter)

출력결과(Response Element)

대한무역투자진흥공사_한국 산업별 외국인직접투자통계

오픈 API 정보

기본 정보

상세 및 제공정보 오픈API 에러코드 안내

이용 조건 및 라이선스 정보

참고문서

표준 메타데이터

활용 정보

한국 산업별 투자신고 금액, 신고수, 투자도착 금액, 업체수 정보 조회 기능

API 기본 정보

요청변수(Request Parameter)

출력결과(Response Element)

상세 및 제공정보