TikTok Playlists
TikTok 재생목록은 크리에이터가 자기 동영상을 이름을 붙여 묶어 둔 것으로, 여러 편으로 나눈 이야기, 강의 시리즈, 고정 코너 등이 커버와 동영상 수와 함께 프로필에 표시됩니다. 사용자 이름으로 목록을 불러오면 그 크리에이터가 어떤 시리즈를 꾸려 두었고 시리즈마다 영상이 몇 편인지 한눈에 볼 수 있습니다.
TikTok Playlists API 주요 기능
- 프로필의 공개 재생목록 전부사용자 이름을 보내면 공개 재생목록이 하나씩 개별 레코드로 오며, 개수는 1~100 범위의 results_limit까지입니다. 기본값은 20입니다.
- item_count로 보는 시리즈 규모item_count는 재생목록에 담긴 동영상 수라서, 오래 이어 온 시리즈와 클립 몇 개를 묶어 둔 목록을 쉽게 구분할 수 있습니다.
- 제목, 커버, 바로가기 링크레코드마다 title, cover_url, 재생목록 url이 들어 있고, author에는 소유자의 id, 핸들, 아바타가 반복되어 레코드 하나만으로도 정보가 완결됩니다.
TikTok Playlists API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | 재생목록을 조회할 TikTok 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 반환할 재생목록의 개수로, 1~100 사이 값입니다. 기본값은 20입니다. |
TikTok Playlists API 사용 방법
사용자 이름을 제출하고 크리에이터의 재생목록을 읽습니다.
- {"username": "zachking"}을 /v1/tiktok/user-playlists로 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/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zachking"}'
# Each item is one playlist with title and item_count.TikTok Playlists API 추천 활용 사례
- 한 분야의 시리즈 형식 벤치마킹: 같은 카테고리 크리에이터들의 title과 item_count를 나란히 비교하면, 어떤 시리즈 형식에 꾸준히 공을 들이고 얼마나 길게 이어 가는지 알 수 있습니다.
- 정기 협업 제안 전에 파트너 검토: 여러 편짜리 협업이나 정기 파트너십을 제안하기 전에, 후보 크리에이터가 이미 콘텐츠를 시리즈로 운영하는지, 그 시리즈가 얼마나 깊은지 확인합니다.
TikTok Playlists API 활용 팁
- 시점별 스냅샷을 맞춰 볼 때는 title이 아니라 id로 대응시키세요. 크리에이터가 재생목록 이름을 바꿀 수 있습니다.
- 제목을 읽기 전에 item_count 내림차순으로 정렬하면 가장 오래 이어 온 시리즈가 맨 위로 올라옵니다.
관련 API
TikTok Playlists API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Video Transcript API — 공개 동영상 URL에서 제공되는 스크립트 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- TikTok Reposts API — 계정이 리포스트한 동영상을 나열하며, 동영상별 원작자, 캡션, 조회수를 포함합니다.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API