{"openapi":"3.0.3","info":{"title":"APICK 구글 지도 장소 상세·리뷰 조회","version":"1.0.0","description":"구글 지도 장소의 평점·리뷰 수·별점 분포(1~5점)·대표 리뷰·영업시간·시간대별 혼잡도·비슷한 장소·사진을 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_maps_place/jobs":{"post":{"summary":"구글 지도 장소 상세·리뷰 조회","description":"구글 지도 장소의 평점·리뷰 수·별점 분포(1~5점)·대표 리뷰·영업시간·시간대별 혼잡도·비슷한 장소·사진을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"max_results":{"type":"integer"},"unit_point":{"type":"integer"},"reserved_point":{"type":"integer"},"charged_point":{"type":"integer"},"result_count":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string","nullable":true},"result_expires_at":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"address":{"type":"string"},"country_code":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"description":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"},"rating_distribution":{"type":"object","properties":{"1":{"type":"integer"},"2":{"type":"integer"},"3":{"type":"integer"},"4":{"type":"integer"},"5":{"type":"integer"}}},"top_reviews":{"type":"array","items":{"type":"object","properties":{"reviewer_name":{"type":"string"},"rating":{"type":"integer"},"posted_at":{"type":"string"},"text":{"type":"string"}}}},"open_hours":{"type":"object","properties":{"Monday":{"type":"string"},"Sunday":{"type":"string"}}},"popular_times":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"hours":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"string"},"busy_percent":{"type":"integer"}}}}}}},"similar_places":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"}}}},"photo_urls":{"type":"array","items":{"type":"string"}},"main_image_url":{"type":"string"},"is_claimed":{"type":"boolean"},"permanently_closed":{"type":"boolean"},"temporarily_closed":{"type":"boolean"},"latitude":{"type":"number"},"longitude":{"type":"number"},"place_id":{"type":"string"},"map_url":{"type":"string"}}}},"result_expired":{"type":"boolean"}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"place_id":{"type":"string","description":"구글 장소 ID (google_maps_search 결과의 place_id, ChIJ 로 시작. place_id 또는 url 중 하나 필수) (string)","example":"ChIJobb671mhfDURrcE4SebLfyw"},"url":{"type":"string","description":"구글 지도 장소 주소 (google_maps_search 결과의 map_link, 또는 cid= 가 들어 있는 지도 주소) (string)"},"idempotency_key":{"type":"string","description":"응답을 못 받아 다시 보낼 때 같은 접수로 처리할 키(8~128자, 영문·숫자·_.:-) (string)"}}}}}}}},"/rest/scrape_jobs/5f0c2a9e7b1d4c3a8e6f90a1b2c3d4e5":{"get":{"summary":"구글 지도 장소 상세·리뷰 조회","description":"구글 지도 장소의 평점·리뷰 수·별점 분포(1~5점)·대표 리뷰·영업시간·시간대별 혼잡도·비슷한 장소·사진을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"max_results":{"type":"integer"},"unit_point":{"type":"integer"},"reserved_point":{"type":"integer"},"charged_point":{"type":"integer"},"result_count":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string","nullable":true},"result_expires_at":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"address":{"type":"string"},"country_code":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"description":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"},"rating_distribution":{"type":"object","properties":{"1":{"type":"integer"},"2":{"type":"integer"},"3":{"type":"integer"},"4":{"type":"integer"},"5":{"type":"integer"}}},"top_reviews":{"type":"array","items":{"type":"object","properties":{"reviewer_name":{"type":"string"},"rating":{"type":"integer"},"posted_at":{"type":"string"},"text":{"type":"string"}}}},"open_hours":{"type":"object","properties":{"Monday":{"type":"string"},"Sunday":{"type":"string"}}},"popular_times":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"hours":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"string"},"busy_percent":{"type":"integer"}}}}}}},"similar_places":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"}}}},"photo_urls":{"type":"array","items":{"type":"string"}},"main_image_url":{"type":"string"},"is_claimed":{"type":"boolean"},"permanently_closed":{"type":"boolean"},"temporarily_closed":{"type":"boolean"},"latitude":{"type":"number"},"longitude":{"type":"number"},"place_id":{"type":"string"},"map_url":{"type":"string"}}}},"result_expired":{"type":"boolean"}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/scrape_jobs/{job_id}":{"get":{"summary":"구글 지도 장소 상세·리뷰 조회","description":"구글 지도 장소의 평점·리뷰 수·별점 분포(1~5점)·대표 리뷰·영업시간·시간대별 혼잡도·비슷한 장소·사진을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"max_results":{"type":"integer"},"unit_point":{"type":"integer"},"reserved_point":{"type":"integer"},"charged_point":{"type":"integer"},"result_count":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string","nullable":true},"result_expires_at":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"address":{"type":"string"},"country_code":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"description":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"},"rating_distribution":{"type":"object","properties":{"1":{"type":"integer"},"2":{"type":"integer"},"3":{"type":"integer"},"4":{"type":"integer"},"5":{"type":"integer"}}},"top_reviews":{"type":"array","items":{"type":"object","properties":{"reviewer_name":{"type":"string"},"rating":{"type":"integer"},"posted_at":{"type":"string"},"text":{"type":"string"}}}},"open_hours":{"type":"object","properties":{"Monday":{"type":"string"},"Sunday":{"type":"string"}}},"popular_times":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"hours":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"string"},"busy_percent":{"type":"integer"}}}}}}},"similar_places":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"rating":{"type":"number"},"reviews_count":{"type":"integer"}}}},"photo_urls":{"type":"array","items":{"type":"string"}},"main_image_url":{"type":"string"},"is_claimed":{"type":"boolean"},"permanently_closed":{"type":"boolean"},"temporarily_closed":{"type":"boolean"},"latitude":{"type":"number"},"longitude":{"type":"number"},"place_id":{"type":"string"},"map_url":{"type":"string"}}}},"result_expired":{"type":"boolean"}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-code-tables":[{"title":"Body (data)","columns":["이름","타입","설명"],"rows":[["job_id","String","작업 ID (32자리). 상태·결과 조회에 씁니다"],["product","String","수집 상품 이름"],["status","String","waiting · processing · completed · failed"],["max_results","Integer","요청한 최대 결과 수"],["unit_point","Integer","결과 1건당 포인트(이 작업에 적용된 단가)"],["reserved_point","Integer","현재 예약 중인 포인트. 완료·실패하면 0"],["charged_point","Integer","최종 차감 포인트(완료 시 결과 건수 × 단가)"],["result_count","Integer","받은 결과 수"],["created_at","String","접수 시각 (ISO 8601)"],["completed_at","String","완료 시각. 진행 중이면 null"],["items","Array","수집 결과(완료 시). 각 항목의 필드는 아래 표"],["name","String","장소 이름"],["category","String","대표 업종"],["categories","Array","업종 목록"],["address","String","주소"],["country_code","String","국가 코드"],["phone","String","전화번호"],["website","String","웹사이트"],["description","String","장소 소개"],["rating","Number","평균 별점"],["reviews_count","Integer","리뷰 수"],["rating_distribution","Object","별점별 리뷰 수 { \"1\"~\"5\" }"],["top_reviews","Array","대표 리뷰 [{ reviewer_name, rating, posted_at, text }]"],["open_hours","Object","요일별 영업시간"],["popular_times","Array","요일별 시간대 혼잡도 [{ day(1=월~7=일), hours: [{ hour, busy_percent }] }]"],["similar_places","Array","비슷한 장소 [{ name, category, rating, reviews_count }]"],["photo_urls","Array","사진 주소(최대 10개)"],["main_image_url","String","대표 이미지"],["is_claimed","Boolean","업주 인증 여부"],["permanently_closed","Boolean","폐업 여부"],["temporarily_closed","Boolean","임시 휴업 여부"],["latitude","Number","위도"],["longitude","Number","경도"],["place_id","String","구글 장소 ID"],["map_url","String","구글 지도 주소"],["result_expires_at","String","결과 보관 기한(완료 후 72시간)"],["result_expired","Boolean","보관 기한이 지나 결과를 지웠으면 true"],["error","Object","실패 시 { code, message }"]]},{"title":"오류 코드","columns":["HTTP","error_code","설명"],"rows":[["400","SCRAPE_INPUT_INVALID","입력 형식 또는 max_results 범위 오류. 상류를 호출하지 않으며 포인트는 차감되지 않습니다"],["402","SCRAPE_POINTS_INSUFFICIENT","max_results 만큼의 포인트가 부족합니다"],["403","SCRAPE_PAYMENT_REQUIRED","충전 이력이 있는 계정만 이용할 수 있습니다"],["404","SCRAPE_JOB_NOT_FOUND","작업이 없거나 다른 계정의 작업입니다"],["409","SCRAPE_IDEMPOTENCY_CONFLICT","같은 idempotency_key 로 다른 내용을 접수했습니다"],["429","SCRAPE_TOO_MANY_JOBS","진행 중인 작업이 5개입니다. 끝난 뒤 다시 접수해 주세요"],["503","SCRAPE_TEMPORARILY_UNAVAILABLE","일시적으로 접수하지 못했습니다. 포인트는 차감되지 않습니다"],["작업 실패","TARGET_NOT_FOUND · TARGET_PRIVATE · SCRAPE_TIMEOUT · SCRAPE_FAILED","상태 조회의 error.code. 예약한 포인트는 모두 돌려드립니다"]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}