tiktok/
song-videos

특정 사운드를 사용한 공개 TikTok 동영상을 수집하고, 정규화된 동영상 메타데이터, 크리에이터 정보, 캡션, 미디어 링크, 참여도 수치를 반환합니다.

TikTok Song Videos API

오디오 연결 동영상
사운드 챌린지
트렌드 클러스터링
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 목록을 비동기 작업으로 제출하고, 정규화된 동영상 결과를 페이지 단위로 가져옵니다.

  1. music_ids에 숫자 클립 ID 배열을 넣고, 선택 사항으로 최대 2,000까지 results_limit을 지정합니다.
  2. SocQ API 키와 함께 /v1/tiktok/song-videos로 POST 요청을 보냅니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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와 대응시킬 수 있습니다.

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

TikTok Song Videos API — 자주 묻는 질문

TikTok Song Videos API는 특정 TikTok 사운드 또는 음악 클립 ID를 사용한 공개 동영상을 수집합니다. 트렌드와 챌린지 분석에 쓸 수 있도록 정규화된 동영상 게시물, 작성자 정보, 캡션, 미디어 링크, 공개된 참여도 지표를 반환합니다.

music_ids에는 TikTok 사운드 페이지에서 확인할 수 있는 숫자 클립 ID를 문자열로 바꾼 배열을 넣습니다. 예: ["7439295283975702544"]

네. 클립 ID 여러 개를 배열로 넣을 수 있으며, 각 사운드가 처리되어 하나로 합쳐진 작업 결과로 반환됩니다.