{"openapi":"3.0.3","info":{"title":"APICK 구글 지도 장소 검색","version":"1.0.0","description":"키워드의 구글 지도 장소 검색 결과(상호·주소·전화·평점·리뷰 수·영업시간·좌표)를 최대 20곳 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_maps_search":{"post":{"summary":"구글 지도 장소 검색","description":"키워드의 구글 지도 장소 검색 결과(상호·주소·전화·평점·리뷰 수·영업시간·좌표)를 최대 20곳 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"keyword":{"type":"string","description":"검색에 쓴 검색어입니다(앞뒤 공백 제거)."},"count":{"type":"integer","description":"items의 개수입니다(최대 20)."},"items":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"검색 결과 안에서의 순서(1부터)입니다."},"name":{"type":"string","description":"상호입니다."},"address":{"type":"string","description":"주소입니다. 없으면 빈 문자열입니다."},"phone":{"type":"string","description":"전화번호입니다. 국가번호 형식(+82…)일 수 있습니다. 없으면 빈 문자열입니다."},"categories":{"type":"array","items":{"type":"string"},"description":"업종 이름 목록입니다(최대 5개)."},"rating":{"type":"number","description":"평점입니다. 없으면 null입니다.","nullable":true},"reviews":{"type":"integer","description":"리뷰 수입니다. 없으면 null입니다.","nullable":true},"price_range":{"type":"string","description":"가격대 표기입니다. 없으면 빈 문자열입니다."},"open_status":{"type":"string","description":"조회 시점의 영업 상태 표기입니다. 예: 영업 중 · 오후 10:00에 영업 종료. 없으면 빈 문자열입니다."},"open_hours":{"type":"object","properties":{"월요일":{"type":"string"},"화요일":{"type":"string"}},"description":"요일 이름을 키로 한 영업시간입니다. 예: {\"월요일\": \"오전 8:00~오후 10:00\"}. 정보가 없으면 빈 객체입니다."},"website":{"type":"string","description":"웹사이트 주소입니다. 없으면 빈 문자열입니다."},"latitude":{"type":"number","description":"위도입니다. 없으면 null입니다.","nullable":true},"longitude":{"type":"number","description":"경도입니다. 없으면 null입니다.","nullable":true},"place_id":{"type":"string","description":"구글 지도 장소 식별자입니다. 같은 장소를 다시 찾거나 중복을 거를 때 씁니다."},"map_link":{"type":"string","description":"구글 지도에서 이 장소를 여는 주소입니다."},"thumbnail":{"type":"string","description":"대표 사진 주소입니다. 없으면 빈 문자열입니다."}}},"description":"장소 목록입니다. 결과가 없으면 빈 배열입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer","description":"결제 기록 번호입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"장소 검색어 (예: 강남역 카페, 1~200자) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"강남역 카페"}},"required":["keyword"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["입력 항목이 잘못됐습니다. keyword(검색어, 1~200자)를 입력해 주세요.","400","keyword가 비었거나 200자를 넘었습니다. 고쳐서 다시 요청합니다."],["처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","408","잠시 뒤 다시 요청합니다. 검색어를 더 구체적으로 바꾸면 도움이 됩니다."],["외부 검색 처리에 실패했습니다. 잠시 후 다시 시도해 주세요.","424","일시적인 실패입니다. 잠시 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}