{"openapi":"3.0.3","info":{"title":"APICK 주소·필지(PNU) 조회","version":"1.0.0","description":"지번·도로명 주소를 좌표와 필지 정보로 바꿔 필지고유번호(PNU), 법정동코드, 지번, 좌표를 돌려줍니다. 공시가격·실거래가 조회에 필요한 식별자를 주소 하나로 얻을 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/geocode":{"post":{"summary":"주소·필지(PNU) 조회","description":"지번·도로명 주소를 좌표와 필지 정보로 바꿔 필지고유번호(PNU), 법정동코드, 지번, 좌표를 돌려줍니다. 공시가격·실거래가 조회에 필요한 식별자를 주소 하나로 얻을 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pnu":{"type":"string"},"jibun":{"type":"string"},"address":{"type":"string"},"refinedAddress":{"type":"string"},"point":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}}},"bjdongCode":{"type":"string"},"lawdCd":{"type":"string"},"jiga":{"type":"integer"},"gosiDate":{"type":"string"}}},"api":{"type":"object","properties":{"cost":{"type":"integer"},"success":{"type":"boolean"},"ms":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"지번 또는 도로명 주소 (예: 서울특별시 강남구 역삼동 808) (string)","example":"서울특별시 강남구 역삼동 808"},"pnu":{"type":"string","description":"PNU(19자리). 주면 좌표 조회 없이 바로 조회합니다. (string)"},"addrType":{"type":"string","description":"주소 유형 (기본 auto) (string)","enum":["auto","parcel","road"],"example":"parcel"}}}}}}}}},"x-code-tables":[{"title":"응답과 오류 복구","columns":["필드","타입","설명"],"rows":[["data.pnu","string","필지고유번호 19자리입니다. 공시가격 조회의 입력값입니다."],["data.jibun","string","지번입니다. 예: 808 대"],["data.address","string","지번 주소입니다."],["data.refinedAddress","string","정제된 표준 주소입니다. 주소로 조회했을 때만 채워집니다."],["data.point","object","경위도 좌표입니다. PNU로 바로 조회하면 null입니다."],["data.bjdongCode","string","법정동코드 10자리입니다."],["data.lawdCd","string","법정동코드 앞 5자리입니다. 실거래가 조회의 lawdCd 입력값입니다."],["data.jiga","integer","공시지가(원/㎡)입니다. 없으면 null입니다."],["data.gosiDate","string","공시지가 기준 연월입니다. 없으면 빈 문자열입니다."],["api.cost","integer","차감된 포인트입니다. 실패한 응답은 0입니다."],["api.ms","integer","처리 시간(밀리초)입니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}