TikTok Song
음악과 오디오 트랙은 숏폼 트렌드가 퍼지는 핵심 동력입니다. 사운드 메타데이터를 조회하면 오디오 제목, 아티스트 정보, 오디오 길이, 직접 재생용 스트림 참조, 현재 동영상 사용 횟수를 확인할 수 있습니다.
TikTok Song API 주요 기능
- 두 가지 입력 방식 지원숫자 클립 ID로 조회하거나 공개 TikTok 사운드 페이지의 전체 URL을 제공해도 되며, 둘 중 어느 쪽이든 사용할 수 있습니다.
- 트랙·아티스트 메타데이터공식 노래 제목, 아티스트 핸들, 닉네임, 앨범 이름, 커버 아트워크 URL을 추출합니다.
- 오디오 미리 듣기 스트림미디어 연동에 쓸 수 있는 공개 오디오 재생 URL과 정밀한 재생 시간 값을 가져옵니다.
- 사용 규모 지표이 사운드로 만들어진 공개 동영상이 몇 개인지 나타내는 user_count 값을 추적합니다.
TikTok Song API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
music_id | 필수(하나 이상) | 숫자로 된 TikTok 사운드 클립 ID입니다(예: 7439295283975702544). url을 생략하면 필수입니다. |
url | 필수(하나 이상) | 공개 TikTok 사운드·음악 페이지의 URL입니다. music_id를 생략하면 필수입니다. |
TikTok Song API 사용 방법
사운드 클립 ID 또는 음악 URL을 비동기 작업으로 제출하고, 작업을 폴링해 정규화된 트랙 정보를 가져옵니다.
- 공개 TikTok 게시물이나 사운드 공유 링크에서 숫자 클립 ID 또는 사운드 URL을 확인합니다.
- music_id 또는 url 중 하나를 지정해 /v1/tiktok/song으로 POST 요청을 보냅니다.
- 작업이 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 확인해 정규화된 music 객체를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/song" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_id":"7439295283975702544"}'
# Or pass {"url":"https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"}TikTok Song API 추천 활용 사례
- 트렌드 수명 주기 추적: 동영상 사용 횟수를 시간에 따라 모니터링해 오디오 트렌드가 확산 중인지 정체 중인지 가늠합니다.
- 음악 카탈로그 정보 보강: 아티스트 카탈로그에 TikTok 플랫폼 ID, 사운드 커버, 오디오 재생 시간 정보를 추가합니다.
- 오디오 기반 크리에이티브 조사: 숏폼 영상에 쓰이며 유행한 오디오 클립의 원작 아티스트와 트랙 정보를 찾아냅니다.
TikTok Song API 활용 팁
- TikTok 음악 URL은 경로 끝에 클립 ID가 들어 있으며, 전체 URL과 ID 단독 입력을 모두 사용할 수 있습니다.
- 확인한 music_id를 TikTok Song Videos에 전달하면 이 트랙을 사용한 동영상을 정확히 가져올 수 있습니다.
- metrics.videos_count 속성은 이 오디오 클립을 사용한 공개 동영상의 전체 개수를 나타냅니다.
- 일반 사용자가 만든 오리지널 사운드는 extra 메타데이터에서 is_original이 true로 설정됩니다.
관련 API
TikTok Song API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Song Videos API — 지정한 사운드 ID를 사용한 공개 동영상을 수집합니다.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Video Transcript 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