{"openapi":"3.0.3","info":{"title":"APICK 토지 종합 분석","version":"1.0.0","description":"필지의 지목·면적·용도지역·공시지가 이력·토지이동이력을 모아 공시지가 변동률·연평균 변동률·추세·규제 저촉을 분석합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/land_info":{"post":{"summary":"토지 종합 분석","description":"필지의 지목·면적·용도지역·공시지가 이력·토지이동이력을 모아 공시지가 변동률·연평균 변동률·추세·규제 저촉을 분석합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"PNU":{"type":"string","description":"확정된 필지고유번호 19자리입니다."},"소재지":{"type":"string","description":"주소로 조회했을 때 확정된 주소입니다. pnu로 조회하면 빈 문자열입니다."},"지번":{"type":"string","description":"주소로 조회했을 때의 지번 표기입니다. pnu로 조회하면 빈 문자열입니다."},"법정동코드":{"type":"string","description":"법정동코드 10자리입니다."},"지역코드":{"type":"string","description":"시군구 단위 지역코드 5자리입니다. 실거래가 조회 등에 그대로 씁니다. pnu로 조회하면 빈 문자열일 수 있습니다."},"좌표":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"description":"경위도 좌표(x 경도, y 위도)입니다. pnu로 조회하면 null입니다.","nullable":true},"기준연도":{"type":"string","description":"실제로 적용된 기준연도입니다."},"필지":{"type":"object","properties":{"PNU":{"type":"string"},"법정동코드":{"type":"string"},"법정동":{"type":"string","description":"법정동 이름입니다."},"지번":{"type":"string","description":"본번-부번 표기입니다."},"지목":{"type":"string","description":"지목 이름입니다. 예: 대, 전, 임야"},"면적":{"type":"number","description":"토지 면적(㎡)입니다. 값이 없으면 null입니다.","nullable":true},"필지구분":{"type":"string","description":"대장 구분 표기입니다. 예: 토지대장, 임야대장"}},"description":"필지 기본정보입니다. 가져오지 못하면 null입니다.","nullable":true},"토지특성":{"type":"object","properties":{"지목":{"type":"string"},"면적":{"type":"number"},"용도지역_1":{"type":"string","description":"첫 번째 용도지역입니다. 예: 제2종일반주거지역"},"용도지역_2":{"type":"string","description":"두 번째 용도지역입니다. 없으면 빈 문자열입니다."},"토지이용상황":{"type":"string","description":"실제 이용 상황입니다. 예: 상업용, 단독"},"지형고저":{"type":"string","description":"지형의 높낮이입니다. 예: 평지"},"지형형상":{"type":"string","description":"필지 모양입니다. 예: 가로장방"},"도로접면":{"type":"string","description":"도로에 닿은 형태입니다. 예: 광대로한면"},"기준일자":{"type":"string"}},"description":"기준연도의 토지특성입니다. 가져오지 못하거나 그해 자료가 없으면 null입니다.","nullable":true},"공시지가":{"type":"array","items":{"type":"object","properties":{"기준연도":{"type":"string","description":"공시 기준연도입니다."},"기준일자":{"type":"string"},"단위면적당가격":{"type":"integer","description":"㎡당 개별공시지가(원)입니다. 토지 전체 가격은 필지.면적을 곱해 구합니다."}}},"description":"연도별 개별공시지가입니다. 최근 연도부터 정렬하며, 자료가 없는 연도는 빠집니다."},"토지이용계획":{"type":"array","items":{"type":"object","properties":{"용도지역지구구역":{"type":"string","description":"지역·지구·구역 이름입니다. 예: 도시지역, 가축사육제한구역"},"저촉여부":{"type":"string","description":"필지가 그 구역에 포함·저촉되는지 표기입니다. 예: 포함, 저촉, 접합"},"근거법령":{"type":"string"},"기준일자":{"type":"string"}}},"description":"필지에 걸린 용도지역·지구·구역 목록입니다. 없으면 빈 배열입니다."},"토지이동이력":{"type":"array","items":{"type":"object","properties":{"이동일자":{"type":"string","description":"이동이 일어난 날짜입니다."},"이동사유":{"type":"string","description":"이동 사유입니다. 예: 분할, 지목변경"},"기준일자":{"type":"string"}}},"description":"분할·합병·지목변경 같은 토지 이동 이력입니다. 없으면 빈 배열입니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"success":{"type":"boolean","description":"정상 분석 결과는 1, 필지·공시지가를 받지 못한 부분 결과는 0입니다. 0이면 과금되지 않습니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"pnu":{"type":"string","description":"필지고유번호 (19자리) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"address":{"type":"string","description":"지번 또는 도로명 주소 (pnu 가 없을 때 사용) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"서울특별시 강남구 역삼동 12"},"addrType":{"type":"string","description":"주소 유형 (기본 auto) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. parcel = 지번 주소를 기준으로 조회하는 값입니다. road = 도로명 주소를 기준으로 조회하는 값입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. (string)","enum":["parcel","road","auto"],"example":"parcel"},"year":{"type":"string","description":"토지특성·공시지가 기준연도 (기본 전년도) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"2024"},"priceYears":{"type":"string","description":"공시지가 이력 연수 (1~5, 기본 3) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"5"}}}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["data.error","원인","해결"],"rows":[["[pnu 또는 address] 입력 항목이 잘못됐습니다.","pnu와 address가 모두 없습니다.","둘 중 하나를 보냅니다."],["[pnu] 19자리 필지고유번호가 필요합니다.","pnu의 숫자가 19자리가 아닙니다.","19자리를 확인하거나 address로 조회합니다."],["[address] 입력 항목이 잘못됐습니다.","주소가 200자를 넘습니다.","시·도부터 번지까지만 보냅니다."],["[year] 기준연도가 잘못됐습니다. ex) 2024","4자리가 아니거나 1990년~올해 범위를 벗어났습니다.","올해 이하 4자리 연도로 보내거나 생략합니다."],["[priceYears] 1~5 사이 값이 필요합니다.","이력 연수가 범위를 벗어났습니다.","1~5 사이 정수로 보냅니다."],["주소 유형이 잘못됐습니다.","addrType이 허용값에 없습니다.","parcel·road 중 하나로 보내거나 생략합니다."],["주소 또는 PNU(19자리)가 필요합니다.","address가 공백뿐입니다.","주소를 채우거나 pnu로 보냅니다."],["해당 주소의 필지를 찾지 못했습니다.","주소에 해당하는 필지가 없습니다.","번지까지 적었는지, 지번·도로명 유형이 맞는지(addrType) 확인합니다."],["주소·필지 정보를 가져오지 못했습니다.","주소를 필지로 바꾸는 단계가 일시적으로 실패했습니다.","잠시 후 다시 요청하거나 pnu로 조회합니다."],["필지 정보를 가져오지 못했습니다.","모든 항목을 가져오지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}