TikTok Popular Songs
TikTok 사운드는 게시물에 붙는 오디오이며, TikTok 앱에는 Top 50과 Viral 50 노래 차트가 있습니다. 반환되는 각 레코드는 제목, 아티스트, 사운드 ID로 특정 사운드를 식별하므로, 음악 목록을 만들고 각 항목을 사운드 상세 정보나 해당 사운드를 쓴 동영상과 연결할 수 있습니다.
TikTok Popular Songs API 주요 기능
- 두 가지 노래 차트 중 선택chart_type을 top으로 지정하면 Top 50, viral로 지정하면 Viral 50입니다. TikTok 앱의 이름이 붙은 두 차트 중 검토할 차트를 골라 최대 50개 항목을 요청합니다.
- 노래 제목 뒤의 정확한 사운드 식별제목, 아티스트, 사운드 ID, 커버, 재생 시간을 함께 읽습니다. 사운드 ID는 이름이 같은 오디오 클립을 구분하는 데 도움이 되며, TikTok Song 또는 TikTok Song Videos로 해당 사운드를 조회할 수 있게 해 줍니다.
- 제공되는 사운드 사용 횟수 확인원본에서 수치를 제공하는 경우 metrics.videos_count로 해당 사운드를 쓴 동영상 수를 알 수 있습니다. 청취자·재생수·좋아요 수가 아니라 동영상 수이며, 제공되지 않는 수치는 null로 남습니다.
TikTok Popular Songs API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
chart_type | 선택 | 차트 선택 값으로, 선택 사항입니다. top은 TikTok 앱의 Top 50, viral은 Viral 50을 고릅니다. 기본값은 top입니다. 예를 들어 예제의 값을 viral로 바꾸면 다른 차트를 요청합니다. |
results_limit | 선택 | 노래 수의 최댓값으로, 1~50 사이의 정수이며 선택 사항입니다. 기본값은 20입니다. 예를 들어 10은 선택한 차트에서 최대 10개 항목을 요청합니다. 원본에서 더 적게 반환할 수 있으며, 결과 페이지네이션으로 이 한도가 늘어나지는 않습니다. |
TikTok Popular Songs API 사용 방법
이 요청은 백그라운드 수집 작업을 시작하므로 첫 응답에는 완성된 데이터가 아니라 작업 ID가 담겨 있습니다. 이 ID로 진행 상황을 확인하고 결과를 가져옵니다.
- chart_type을 선택합니다. top은 Top 50, viral은 Viral 50입니다. 생략하면 API는 top을 사용하며, results_limit의 기본값은 20이고 1~50 사이의 정수를 받습니다.
- $SOCQ_API_KEY를 자신의 API 키로 바꾸거나 해당 환경 변수를 설정합니다. Authorization 헤더와 함께 JSON 요청을 POST /v1/tiktok/popular-songs로 보내고, 반환된 task_id를 저장합니다.
- 수집은 백그라운드에서 실행되므로 첫 응답에는 작업 ID가 담겨 있습니다. GET /v1/tasks/{task_id}를 조회하세요. queued, running, retrying은 작업이 아직 진행 중이라는 뜻입니다. succeeded가 되면 결과를 읽고, failed가 되면 error_message를 확인합니다.
- data.results.items를 읽습니다. 각 항목은 특정 사운드를 나타내며, audio.id는 사운드 ID, audio.artist는 아티스트 이름, metrics.videos_count는 제공되는 동영상 사용 횟수입니다. items 배열이 비어 있으면 반환된 레코드가 없다는 뜻입니다.
- data.results.has_more가 true이면 next_cursor를 그대로 cursor로 GET /v1/tasks/{task_id}?cursor=...에 전달하고, has_more가 false가 될 때까지 이어서 가져옵니다. 같은 저장된 작업의 다른 페이지를 읽는 것이며, 차트 수집 한도 50을 늘리지는 않습니다.
curl -X POST "https://api.socq.ai/v1/tiktok/popular-songs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"chart_type":"top","results_limit":20}'TikTok Popular Songs API 추천 활용 사례
- 음악 검토 시트 준비: Top 50 또는 Viral 50을 고른 뒤 제목, 아티스트, 사운드 ID, 재생 시간, 제공되는 동영상 수를 표로 내보냅니다. 팀에서 사운드 페이지를 열어 콘텐츠 아이디어에 맞는 클립을 검토할 수 있습니다.
- 사운드를 쓴 동영상 사례 수집: 반환된 사운드 ID를 music_ids로 TikTok Song Videos에 전달해 공개 동영상 사례를 수집합니다. 클립이 어떻게 쓰이는지는 해당 동영상을 직접 검토해 파악하세요. 이 차트 API는 그 분석을 수행하지 않습니다.
- 따로 수집한 차트 스냅샷 비교: 작업을 실행할 때마다 선택한 chart_type, 사운드 ID, 제공되는 동영상 수, collected_at을 저장합니다. 저장한 표를 사운드 ID로 조인하면 시간에 따른 노래와 사용 횟수의 변화를 비교할 수 있으며, API 자체는 과거 순위를 제공하지 않습니다.
TikTok Popular Songs API 활용 팁
- 저장한 실행 결과를 비교할 때는 chart_type을 일관되게 유지하세요. top에서 viral로 바꾸면 선택한 차트가 달라지므로, 노래 목록이 다르다는 것만으로 인기의 상승이나 하락이 입증되지는 않습니다.
- audio.id로 작업 간 레코드를 연결하고 TikTok Song 또는 TikTok Song Videos를 요청하세요. 제목만으로는 이름이 같은 서로 다른 사운드 클립을 구분할 수 없습니다.
- audio.url이 null이면 추가 조사를 위해 사운드 ID와 공개 사운드 페이지 URL을 보관하세요. 오디오 URL이 제공되더라도 수집 시점에 사용할 수 있던 미디어 링크일 뿐, 영구적인 다운로드 주소로 취급하지 마세요.
관련 API
TikTok Popular Songs API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Video Transcript API — 공개 동영상 URL에서 제공되는 스크립트 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- TikTok Song API — 클립 ID 또는 음악 URL로 공개 사운드 메타데이터를 가져옵니다.
- TikTok Song Videos API — 지정한 사운드 ID를 사용한 공개 동영상을 수집합니다.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Comments 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 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