tiktok/
user-playlists

사용자 이름으로 TikTok 크리에이터 프로필의 공개 재생목록을 조회하고, 재생목록별 이름, 링크, 커버 이미지, 동영상 수, 소유자 정보를 반환합니다.

TikTok Playlists API

사용자 이름 입력
재생목록 이름
재생목록별 동영상 수
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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

사용자 이름을 제출하고 크리에이터의 재생목록을 읽습니다.

  1. {"username": "zachking"}을 /v1/tiktok/user-playlists로 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/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 내림차순으로 정렬하면 가장 오래 이어 온 시리즈가 맨 위로 올라옵니다.

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

TikTok Playlists API — 자주 묻는 질문

TikTok Playlists API는 사용자 이름으로 TikTok 크리에이터 프로필의 공개 재생목록을 조회하는 프로그래밍 인터페이스입니다. 재생목록별 ID, 이름, 링크, 커버 이미지, 동영상 수, 소유자 정보를 반환합니다.

아니요. 각 레코드는 재생목록 자체를 설명하며, 담긴 동영상이 몇 개인지는 item_count로 알 수 있습니다. 크리에이터의 동영상은 TikTok User Videos로 조회하세요.

아니요. 재생목록은 크리에이터가 프로필에 공개로 묶어 둔 자기 동영상 모음이고, 이 조회가 반환하는 것도 이쪽입니다. 컬렉션은 저장한 동영상을 담는 개인 폴더이며 결과에 포함되지 않습니다.

공개 재생목록이 없는 크리에이터입니다. TikTok이 재생목록 만들기를 자격을 갖춘 크리에이터로 제한하고 있어 흔한 경우입니다. 작업은 성공 처리되고 요금은 청구되지 않으며, 반환된 재생목록 1개당 0.5 크레딧이 차감됩니다.

같은 사용자 이름을 나중에 다시 조회해 재생목록별 item_count를 비교하세요. 레코드마다 collected_at이 있어 스냅샷 시점을 알 수 있습니다.