tiktok/
song

클립 ID 또는 사운드 URL로 공개 TikTok 사운드·음악의 상세 메타데이터를 수집하고, 아티스트, 앨범, 재생 시간, 오디오 링크, 동영상 사용 횟수를 반환합니다.

TikTok Song API

사운드 상세 정보
오디오 메타데이터
트랙 확산도
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 비동기 작업으로 제출하고, 작업을 폴링해 정규화된 트랙 정보를 가져옵니다.

  1. 공개 TikTok 게시물이나 사운드 공유 링크에서 숫자 클립 ID 또는 사운드 URL을 확인합니다.
  2. music_id 또는 url 중 하나를 지정해 /v1/tiktok/song으로 POST 요청을 보냅니다.
  3. 작업이 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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로 설정됩니다.

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

TikTok Song API — 자주 묻는 질문

TikTok Song API는 숫자 클립 ID 또는 사운드 URL로 공개 TikTok 사운드 메타데이터와 클립 상세 정보에 프로그래밍 방식으로 접근하게 해 줍니다. 트랙 제목, 아티스트 정보, 재생 시간, 커버 아트, 전체 동영상 사용 횟수를 표준화된 구조로 반환합니다.

네. 숫자 클립 ID 또는 TikTok 음악 URL 전체 중 하나만 제공하면 됩니다. 일치하는 값이라면 둘 다 제공하는 것도 지원됩니다.

아니요. 이 엔드포인트는 알고 있는 사운드 ID나 URL의 메타데이터를 가져옵니다. 이 사운드를 사용한 동영상을 찾으려면 TikTok Song Videos를 사용하세요.