{"openapi":"3.0.3","info":{"title":"APICK 상품 최저가 조회","version":"1.0.0","description":"검색어로 상품 등록 정보를 찾아 판매처와 가격을 한 번에 받고, 그중 최저가 상품을 lowest로 함께 확인합니다. 목록·검색 조회 한 건에 한 번만 과금되는 동기 API입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/shop_price":{"post":{"summary":"상품 최저가 조회","description":"검색어로 상품 등록 정보를 찾아 판매처와 가격을 한 번에 받고, 그중 최저가 상품을 lowest로 함께 확인합니다. 목록·검색 조회 한 건에 한 번만 과금되는 동기 API입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"integer"},"start":{"type":"integer"},"display":{"type":"integer"},"items":{"type":"array","items":{}},"lowest":{"type":"object","properties":{"lprice":{"type":"integer"},"mallName":{"type":"string"},"link":{"type":"string"},"title":{"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":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"검색어 (최대 100자) (string)","example":"무선 이어폰"},"display":{"type":"string","description":"결과 수 (기본 10, 최대 100) (integer)","example":"20"},"start":{"type":"string","description":"시작 위치 (기본 1, 최대 1000) (integer)"},"sort":{"type":"string","description":"정렬 (기본 sim) (string)","enum":["sim","date","asc","dsc"],"example":"asc"}},"required":["query"]}}}}}}},"x-code-tables":[{"title":"응답과 오류 복구","columns":["필드","타입","설명"],"rows":[["data.total","integer","검색된 전체 상품 수입니다. 요청한 결과 수보다 클 수 있습니다."],["data.start","integer","이번 응답이 시작한 위치입니다."],["data.display","integer","이번 응답에 담긴 상품 수입니다."],["data.items[]","array","상품 목록입니다."],["data.items[].title","string","상품명입니다. 검색어 강조 태그는 제거된 평문입니다."],["data.items[].link","string","상품 주소입니다."],["data.items[].mallName","string","판매처 이름입니다."],["data.items[].lprice","integer","최저가(원). 값이 없으면 0입니다."],["data.items[].hprice","integer","최고가(원). 값이 없으면 0입니다."],["data.lowest","object","가격이 있는 상품 중 최저가 상품입니다. 해당 상품이 없으면 null입니다."],["api.cost","integer","차감된 포인트입니다. 실패한 응답은 0입니다."],["api.ms","integer","처리 시간(밀리초)입니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}