tiktok/
live-ranking

호출 한 번으로 TikTok LIVE 일간 크리에이터 순위를 받습니다. 최대 99명 호스트의 순위, 선물 기반 점수, 사용자 ID, 핸들, 표시 이름, 팔로워 수, 프로필 링크를 반환합니다.

TikTok Live Ranking API

입력값 없음
호스트 최대 99명
선물 기반 점수
요청당 0.5 크레딧
준비됨
준비됨

빈 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

빈 요청을 보내고 순위가 매겨진 호스트를 읽습니다.

  1. {}를 /v1/tiktok/live-ranking으로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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에 보내 지금 누가 방송 중인지 확인하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Live Ranking API — 자주 묻는 질문

TikTok Live Ranking API는 입력값 없이 TikTok LIVE 일간 크리에이터 순위를 읽어 오는 프로그래밍 인터페이스입니다. 최대 99명 호스트의 순위, 선물 기반 점수, 사용자 ID, 핸들, 표시 이름, 팔로워 수를 반환합니다.

score는 오늘 TikTok이 호스트를 줄 세우는 기준 값으로, 방송이 받은 선물을 바탕으로 합니다. 순위를 위한 점수일 뿐 어떤 통화의 지급액이 아닙니다.

이 엔드포인트로는 불가능합니다. 입력값이 없고 현재 일간 순위만 반환하므로, 과거 내역이 필요하면 직접 저장해 두세요.

하루 동안 선물이 들어올 때마다 순위가 움직입니다. 순위표 전체를 한 번 가져오는 데 0.5 크레딧이 일정하게 들기 때문에, 1시간마다 가져와도 하루 12 크레딧입니다.

아니요. 선물을 받은 호스트의 순위, 점수, 프로필만 나오며 선물을 보낸 사람 목록은 없습니다.