TikTok Live Ranking
TikTok LIVE 일간 순위는 시청자가 방송 중에 보낸 선물로 산정한 점수에 따라 그날의 라이브 호스트를 줄 세운 리더보드이며, 항목마다 호스트의 순위, 점수, 팔로워 수가 표시됩니다. 이 순위를 읽으면 오늘 시청자들이 어떤 호스트를 밀어 주는지, 상위권이 어떻게 바뀌는지, 팔로워 규모에 비해 더 큰 지지를 받는 작은 계정이 누구인지 알 수 있습니다.
TikTok Live Ranking API 주요 기능
- 매개변수 없이 전체 순위표요청에 입력값이 없으며, 호스트 최대 99명이 각자의 rank와 함께 담긴 현재 일간 순위가 돌아옵니다.
- 점수와 오디언스 규모를 나란히score는 선물 기반 순위 값이고 followers_count는 호스트의 팔로워 합계라서, 추가 조회 없이 지지 규모와 오디언스 규모를 비교할 수 있습니다.
- 행마다 호스트 신원 정보author에 호스트의 사용자 ID, 핸들, 표시 이름, 프로필 링크, 아바타가 들어 있습니다.
TikTok Live Ranking API 매개변수
바로 실행 가능
이 엔드포인트는 요청 매개변수가 필요하지 않습니다. 빈 JSON 객체를 그대로 전송하세요.
{}TikTok Live Ranking API 사용 방법
빈 요청을 보내고 순위가 매겨진 호스트를 읽습니다.
- {}를 /v1/tiktok/live-ranking으로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 호스트를 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
# Each item has rank, score, author and followers_count.TikTok Live Ranking API 추천 활용 사례
- 하루 동안의 순위 변동 추적: 정해진 시각마다 순위를 가져와 호스트별 rank와 score를 그리면 누가 올라가는지, 순서가 언제 바뀌는지 볼 수 있습니다.
- 에이전시·스폰서를 위한 호스트 발굴: score를 followers_count로 나누면 오디언스 규모에 비해 시청자가 많이 후원하는 호스트를 찾을 수 있고, 이들을 계약이나 후원 후보로 추립니다.
TikTok Live Ranking API 활용 팁
- 매일 같은 시각에 가져오도록 예약하세요. 낮 12시에 읽은 점수와 자정에 읽은 점수는 같은 날의 서로 다른 구간을 반영합니다.
- 순위에는 방송 중 여부가 없습니다. author.id로 호스트를 맞춘 뒤 사용자 이름을 TikTok User Live에 보내 지금 누가 방송 중인지 확인하세요.
관련 API
TikTok Live Ranking API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
- TikTok Following List API — TikTok 계정이 팔로우하는 공개 프로필을 수집하며, 정규화된 계정 정보, 소개글, 공개된 지표, 출처 계정 맥락을 포함합니다.
- TikTok User Live API — 사용자 이름별 라이브 또는 오프라인 상태와 확인 가능한 라이브 방송 상세를 조회합니다.
- TikTok Audience Demographics API — 사용자 이름으로 크리에이터의 팔로워가 어느 국가에 있는지 확인하며, 국가별 오디언스 비중을 포함합니다.
- TikTok Live Search API — 키워드로 지금 방송 중인 LIVE를 찾으며, 호스트, 제목, 현재 시청자 수를 포함합니다.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok User Videos API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API