Admin API틱톡 해시태그 수집
실행 기록 목록
GET /ai/admin/tiktok-hashtag/runs
모든 요청에 ADMIN 권한의 액세스 토큰이 필요합니다.
응답은 ApiResponse.data로 감싸지 않은 JSON 객체입니다.
어드민 화면에서 계정 발견 시작으로 시작한 실행만 최신순으로 반환합니다.
매일 자동 수집(Cloud Scheduler /daily)은 제외합니다. 브라우저 저장소와 달리 다른 기기·다른 관리자가 시작한 실행도 보입니다.
HTTP 요청
GET /ai/admin/tiktok-hashtag/runs?page=0&size=20
Authorization: Bearer {access_token}쿼리 파라미터
| 이름 | 타입 | 필수 | 범위·기본값 |
|---|---|---|---|
page | Integer | 아니오 | 0 이상, 기본 0 |
size | Integer | 아니오 | 1~100, 기본 20 |
응답 (200 OK)
{
"items": [
{
"runId": "6dab8706-0276-49e2-bdd3-72015ed515f8",
"mode": "DAILY",
"status": "COMPLETED",
"enrichStatus": "COMPLETED",
"seedHashtags": ["usc", "ucla"],
"targetCreators": 0,
"discoveredCreators": 244,
"newCreators": 240,
"enrichedCreators": 186,
"errorMessage": null,
"createdAt": "2026-10-01T06:56:06.60486Z",
"completedAt": "2026-10-01T07:05:49.953792Z"
}
],
"page": 0,
"size": 20,
"total": 7
}| 필드 | 설명 |
|---|---|
status | 계정 발견 상태. PENDING, RUNNING, COMPLETED, FAILED, CANCELLED |
enrichStatus | 상세 수집 상태. 시작 전이면 null. DAILY는 발견이 끝나면 자동으로 시작 |
completedAt | 계정 발견 완료 시각. 상세 수집 완료 시각이 아님 |
에러 응답
| HTTP 상태 | 의미 |
|---|---|
400 | 허용 범위를 벗어난 page·size |