Admin API틱톡 해시태그 수집
결과 엑셀 다운로드
GET /ai/admin/tiktok-hashtag/export/{runId}
모든 요청에 ADMIN 권한의 액세스 토큰이 필요합니다.
실행 하나에서 발견한 계정과 상세 지표·오토라벨링 결과를 xlsx 파일로 내려줍니다.
실행 중에 받으면 그 시점까지 쌓인 결과가 들어 있고, 상세 수집 전인 계정은 단계가 발견만입니다.
HTTP 요청
GET /ai/admin/tiktok-hashtag/export/{runId}
Authorization: Bearer {access_token}경로 파라미터
응답 (200 OK)
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="tiktok_hashtag_6dab8706_20261001.xlsx"파일명은 tiktok_hashtag_{runId 앞 8자리}_{다운로드 날짜}.xlsx입니다. 계정당 한 행, 팔로워 많은 순으로 정렬합니다.
| 컬럼 | 설명 |
|---|---|
| 입력한_시드 | 실행의 시작 해시태그 |
| 발견된_해시태그 | 이 계정을 발견한 해시태그 (여러 개면 쉼표로 구분) |
| 계정ID · 핸들 · 링크 | 틱톡 숫자 ID, @ 핸들, 프로필 URL |
| 이름 · 팔로워 · 소개글 | 프로필 정보 |
| 평균조회수 · 평균좋아요 · 한달게시물수 · 조회수_팔로워비 | 상세 수집 지표 |
| 오토라벨링 카테고리 · 사유 · 요약 · 팔로워 추정 · 타겟 국가 · 타겟 국가 사유 | Gemini 오토라벨링 결과 |
| 단계 | 심화완료 또는 발견만 |
에러 응답
| HTTP 상태 | 의미 |
|---|---|
400 | 잘못된 UUID |
404 | 실행 없음 |