{"openapi":"3.0.3","info":{"title":"APICK 구글 검색 순위 확인","version":"1.0.0","description":"키워드로 구글을 검색했을 때 지정한 도메인이 1~100위 중 몇 위에 노출되는지 확인합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_rank_check":{"post":{"summary":"구글 검색 순위 확인","description":"키워드로 구글을 검색했을 때 지정한 도메인이 1~100위 중 몇 위에 노출되는지 확인합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"keyword":{"type":"string","description":"요청한 검색어"},"domain":{"type":"string","description":"확인한 도메인"},"found":{"type":"boolean","description":"100위 안 노출 여부"},"rank":{"type":"integer","description":"가장 높은 순위. 없으면 null","nullable":true},"matches":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"순위"},"title":{"type":"string","description":"검색 결과 제목"},"link":{"type":"string","description":"검색 결과 주소"}}},"description":"노출된 결과 목록 (최대 10개)"},"checked_results":{"type":"integer","description":"확인한 검색 결과 수"},"checked_pages":{"type":"integer","description":"확인한 10위 구간 수 (최대 10)"},"complete":{"type":"boolean","description":"1~100위를 모두 확인했거나, 앞에서부터 끊김 없이 확인한 구간에서 찾았으면 true"},"unchecked_ranks":{"type":"array","items":{},"description":"확인하지 못한 순위 구간 (예: \"41-50\"). complete 가 true 면 빈 배열"}},"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":"주소 검색 API"},"domain":{"type":"string","description":"순위를 확인할 도메인 (예: apick.app). 하위 도메인도 함께 찾습니다 (string)","example":"apick.app"}},"required":["keyword","domain"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}