TikTok Song Videos
같은 오디오 트랙에 연결된 동영상 게시물을 추적하면 크리에이터들이 유행하는 챌린지와 인기 배경음악을 어떻게 해석하는지 알 수 있습니다. 정규화된 동영상 항목에는 사운드 클러스터별로 크리에이터 정보, 캡션, 재생 링크, 공개된 참여도 지표가 담겨 있습니다.
TikTok Song Videos API 주요 기능
- 사운드 중심의 동영상 수집숫자로 된 사운드 클립 ID를 하나 이상 제출하면 정확히 그 오디오로 게시된 동영상을 모아 줍니다.
- 크리에이터 및 게시물 정보반환되는 동영상마다 크리에이터의 사용자 이름, 닉네임, 캡션 전체 텍스트, 해시태그, 멘션을 가져옵니다.
- 참여도 세부 지표조회수, 좋아요 수, 댓글 수, 공유 수, 저장 수를 추출해 같은 트랙을 쓴 동영상끼리 성과를 비교할 수 있습니다.
- 미디어 다운로드 링크커버 이미지와 동영상 스트림 URL을 크기 및 재생 시간 메타데이터와 함께 직접 받을 수 있습니다.
TikTok Song Videos API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
music_ids | 필수 | 공개 동영상을 수집할 TikTok 사운드 클립 ID(숫자)의 배열입니다. |
results_limit | 선택 | 사운드 ID마다 반환할 동영상의 최대 개수입니다. 기본값은 100이며 허용 범위는 1~2,000입니다. |
TikTok Song Videos API 사용 방법
사운드 클립 ID 목록을 비동기 작업으로 제출하고, 정규화된 동영상 결과를 페이지 단위로 가져옵니다.
- music_ids에 숫자 클립 ID 배열을 넣고, 선택 사항으로 최대 2,000까지 results_limit을 지정합니다.
- SocQ API 키와 함께 /v1/tiktok/song-videos로 POST 요청을 보냅니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, 추가 페이지는 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_ids":["7439295283975702544"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.TikTok Song Videos API 추천 활용 사례
- 바이럴 사운드 캠페인 분석: 브랜드 사운드나 프로모션 오디오 트랙이 크리에이터 커뮤니티에 얼마나 효과적으로 퍼지고 있는지 평가합니다.
- 크리에이티브 패턴 조사: 같은 오디오 구간을 쓴 크리에이터들이 채택한 공통 영상 형식, 안무, 콩트를 분석합니다.
- 성과 좋은 UGC 발굴: 라이선싱이나 협업을 위해 특정 인기 음악과 연결된 사용자 제작 동영상 중 성과가 좋은 것을 찾아냅니다.
TikTok Song Videos API 활용 팁
- 숫자로 된 music_id는 TikTok Song 엔드포인트나 TikTok 음악 웹 URL의 끝부분에서 얻을 수 있습니다.
- 결과는 플랫폼의 사운드 피드에 따라 최신순 역순 또는 인기순으로 반환됩니다.
- results_limit으로 사운드별 결과 수를 제한하세요. ID를 여러 개 넣은 작업은 사운드 ID마다 독립적으로 페이지네이션됩니다.
- 각 동영상 항목의 extra.clip_id를 확인하면 항목을 입력한 사운드 ID와 대응시킬 수 있습니다.
관련 API
TikTok Song Videos API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Video Transcript API — 공개 동영상 URL에서 제공되는 스크립트 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- TikTok Song API — 클립 ID 또는 음악 URL로 공개 사운드 메타데이터를 가져옵니다.
- TikTok Profiles API
- TikTok Hashtags 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 Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists 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