Open-API 이용신청

농수축산물 유통에 대한 Open-API를 제공합니다.

신)일별 품목별 소매 가격자료(기간설정가능, 최대1년)

요청 URL (request url)

http://www.kamis.or.kr/service/price/xml.do?action=periodRetailProductList

요청 변수 (request parameter)

요청변수 정보 - 요청변수, 값, 설명으로 구성
요청변수 설명
p_countrycode string * 소매가격 선택가능 지역 (1101:서울, 2100:부산, 2200:대구, 2300:인천, 2401:광주, 2501:대전, 2601:울산, 3111:수원, 3214:강릉, 3211:춘천, 3311:청주, 3511:전주, 3711:포항, 3911:제주, 3113:의정부, 3613:순천, 3714:안동, 3814:창원, 3145:용인, 2701:세종, 3112:성남, 3138:고양, 3411:천안, 3818:김해) <br/>* 도매가격 선택가능 지역 (1101:서울, 2100:부산, 2200:대구, 2401:광주, 2501:대전)<br/>default : 전체지역
p_cert_key string 인증Key
p_cert_id string 요청자id
p_returntype string Return Type (json:Json 데이터 형식, xml:XML데이터형식)
p_startday string 조회기간(start date)
p_productrankcode string 등급코드
p_convert_kg_yn string kg단위 환산여부(Y : 1kg 단위표시, N : 정보조사 단위표시, ex: 쌀 20kg)<br />default : N
p_itemcategorycode string 부류코드
p_itemcode string 품목코드
p_kindcode string 품종코드
p_endday string 조회기간(end date)
샘플 URL
http://www.kamis.or.kr/service/price/xml.do?action=periodRetailProductList&p_startday=2024-08-01&p_endday=2024-08-09&p_itemcategorycode=100&p_itemcode=111&p_kindcode=01&p_productrankcode=04&p_countrycode=1101&p_convert_kg_yn=Y&p_cert_key=111&p_cert_id=222&p_returntype=xml

출력 결과 필드 (response field)

출력 결과 필드 정보 - 필드, 값, 설명으로 구성
필드 설명
condition string 요청 메세지
data string 응답 메세지
itemname string 품목명
kindname string 품종명
countyname string 시군구
marketname string 마켓명
yyyy string 연도
regday string 날짜
price string 가격
샘플페이지
해당사항 없음(상위 샘플 URL 참조)

비고/에러 메세지

비고/에러 메세지 정보 - code, Message로 구성
code Message
000 Success.
001 no data
200 Wrong Parameters.
900 Unauthenticated request.

첨부파일

농축수산물 품목 및 등급 코드표
  파일 다운로드

로그인하시면 다양한 정보를 얻을 수 있습니다.

로그인