OPEN-API 이용신청
농수축산물 유통에 대한 Open-API를 제공합니다.
일별 품목별 도·소매가격정보
안내사항
※ 해당 api는 당일로부터 1년간의 데이터만 제공하고 있습니다.
※ 1년 이상의 데이터 요청 시 관련 부서로 문의바랍니다.
요청 URL (request url)
http://www.kamis.or.kr/service/price/xml.do?action=periodProductList
요청 변수 (request parameter)
| 요청변수 |
값 |
설명 |
| 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_endday |
string |
조회기간(end date) |
| p_convert_kg_yn |
string |
kg단위 환산여부(Y : 1kg 단위표시, N : 정보조사 단위표시, ex: 쌀 20kg)<br />default : N |
| p_itemcategorycode |
string |
부류코드 |
| p_itemcode |
string |
품목코드 |
| p_kindcode |
string |
품종코드 |
| p_productrankcode |
string |
등급코드 |
| p_countrycode |
string |
* 소매가격 선택가능 지역 (1101:서울, 2100:부산, 2200:대구, 2300:인천, 2401:광주, 2501:대전, 2601:울산, 3111:수원, 3211:춘천, 3311:청주, 3511:전주, 3711:포항, 3911:제주, 3113:의정부, 3613:순천, 3714:안동, 3814:창원, 3145:용인)<br />도매가격 선택가능 지역 (1101:서울, 2100:부산, 2200:대구, 2401:광주, 2501:대전)<br />default : 전체지역 |
| p_productclscode |
string |
구분 ( 01:소매, 02:도매, default:02 ) |
샘플 URL
http://www.kamis.or.kr/service/price/xml.do?action=periodProductList&p_productclscode=02&p_startday=2022-10-01&p_endday=2022-12-01&p_itemcategorycode=200&p_itemcode=212&p_kindcode=00&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 |
품종명 |
| price |
string |
가격 |
| marketname |
string |
마켓명 |
| yyyy |
string |
연도 |
| regday |
string |
날짜 |
| countyname |
string |
시군구 |
샘플페이지
N/A
비고/에러 메세지
| code |
Message |
| 000 |
Success. |
| 900 |
Unauthenticated request. |
| 200 |
Wrong Parameters. |
| 001 |
no data |
첨부파일
파일 다운로드