Skip to main content
GET
사이트 키워드 분석 상태 조회

인증

API-Key
string
header
필수

"조직 API 키를 입력하세요. 예: 'cs_live_xxxx'"

경로 매개변수

taskID
string
필수

조회할 분석 작업 ID — 분석 제출 응답의 id 를 그대로 넣습니다

쿼리 매개변수

includeSourceURLs
boolean

true면 키워드별 sources 항목에 url을 포함합니다 (기본 false). sourceURLCount는 항상 포함됩니다

includeContext
boolean

true면 키워드별 sources 항목에 contexts(키워드가 등장한 원문 인용 목록)를 포함합니다 (기본 false). includeSourceURLs와 독립적으로 지정할 수 있으며, 인용문이 확인되지 않은 페이지는 contexts가 비어 있을 수 있습니다

응답

OK

error
string

example 을 붙이지 않는다 — status=COMPLETED 예시에 실패 사유가 섞여 보인다.

id
string

조회한 분석 작업 ID. 제출 응답의 id 이자 요청 경로의 taskID 와 같은 값입니다

예시:

"Ck1hRr4mQ2yVX8pTd0LsJw"

keywords
object[]

COMPLETED일 때만 채워짐

maxPages
integer

제출 시 요청한 최대 분석 페이지 수

예시:

30

processedPages
integer

지금까지 시도(성공+실패) 완료한 페이지 수

예시:

8

status
enum<string>

분석 작업의 진행 상태. PENDING: 접수됐고 아직 시작 전, IN_PROGRESS: 페이지를 수집·분석하는 중(totalPages·processedPages 로 진척 확인), COMPLETED: 분석이 끝나 keywords 가 채워짐, FAILED: 분석이 실패해 결과가 없음(error 에 사유). PENDING → IN_PROGRESS → COMPLETED 또는 FAILED 순으로 전이하며, 종료(COMPLETED·FAILED) 후에는 바뀌지 않습니다. 시작 전 실패하면 PENDING 에서 바로 FAILED 가 될 수 있습니다

사용 가능한 옵션:
PENDING,
IN_PROGRESS,
COMPLETED,
FAILED
예시:

"COMPLETED"

totalPages
integer

처리 대상 페이지 수 (IN_PROGRESS 진입 후 확정)

예시:

8