{"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 개수"},"items":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"결과 내 순서"},"name":{"type":"string","description":"상호"},"address":{"type":"string","description":"주소"},"phone":{"type":"string","description":"전화번호. 없으면 빈 문자열"},"categories":{"type":"array","items":{"type":"string"},"description":"업종 목록"},"rating":{"type":"number","description":"평점. 없으면 null","nullable":true},"reviews":{"type":"integer","description":"리뷰 수. 없으면 null","nullable":true},"price_range":{"type":"string","description":"가격대 표기. 없으면 빈 문자열"},"open_status":{"type":"string","description":"영업 상태 표기"},"open_hours":{"type":"object","properties":{"월요일":{"type":"string"}},"description":"요일별 영업시간"},"website":{"type":"string","description":"웹사이트 주소. 없으면 빈 문자열"},"latitude":{"type":"number","description":"위도"},"longitude":{"type":"number","description":"경도"},"place_id":{"type":"string","description":"구글 지도 장소 ID"},"map_link":{"type":"string","description":"구글 지도 주소"},"thumbnail":{"type":"string","description":"대표 사진 주소"}}},"description":"장소 목록 (최대 20곳)"}},"description":"조회 데이터. 실패하면 error 에 안내 문구가 담깁니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"차감된 포인트. 실패한 응답은 0"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"},"ms":{"type":"integer","description":"API 응답 시간(밀리초)"}},"description":"API 호출 공통 데이터"}}}}}},"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":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}