tiktok/
search-music

키워드로 TikTok 사운드를 검색하고 사운드별 사용 영상 수를 확인합니다. 사운드 ID, 제목, 아티스트, 커버, 길이, 미리듣기를 관련도순, 사용량순, 최신순으로 반환합니다.

TikTok Sound Search API

키워드 검색
사운드별 영상 수
사용량순 정렬
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Sound Search

TikTok 사운드는 동영상에 입힌 오디오로, 음악 라이브러리의 곡일 수도 있고 크리에이터가 직접 녹음한 소리일 수도 있습니다. 사운드마다 제목, 아티스트 또는 업로더, 커버, 이 사운드로 만든 영상의 누적 수가 담긴 전용 페이지가 있으며, 그 영상 수를 보면 마니아층에 머무는 사운드인지 자리 잡은 사운드인지 막 뜨는 사운드인지 가장 빨리 읽을 수 있습니다.

TikTok Sound Search API 주요 기능

  • 제목, 아티스트, 분위기로 검색query에 곡 제목, 아티스트 이름, lofi 같은 분위기를 넣으면 TikTok이 일치시킨 사운드가 돌아옵니다.
  • 사운드별 사용 영상 수metrics.videos_count는 각 사운드를 쓴 동영상의 총 개수이므로, 검증된 사운드와 마니아용 사운드를 바로 구분할 수 있습니다.
  • 정렬 기준 세 가지sort_by로 relevance, most_used, latest 중에서 정렬하므로 같은 키워드로 검증된 사운드와 새로 나온 사운드를 모두 찾을 수 있습니다.
  • 시장 선택region에 두 글자 국가 코드를 넣으면 해당 TikTok 시장에서 검색하며, 기본값은 US입니다.
  • 미리듣기가 포함된 사운드 레코드결과마다 사운드 페이지 url, audio.id, title, artist, cover_url, duration_seconds, 재생할 수 있는 audio.url이 들어 있습니다.

TikTok Sound Search API 매개변수

매개변수필수설명
query필수검색할 곡 제목, 아티스트 또는 사운드 이름입니다.
sort_by선택결과 정렬 기준으로, relevance(기본값), most_used, latest 중 하나입니다.
region선택검색할 TikTok 시장의 두 글자 국가 코드입니다. 기본값은 US입니다.
results_limit선택반환할 사운드의 개수로, 1~500 사이 값입니다. 기본값은 20입니다.

TikTok Sound Search API 사용 방법

키워드로 검색하고 일치하는 사운드를 페이지 단위로 읽습니다.

  1. {"query": "lofi", "results_limit": 20}을 /v1/tiktok/search-music으로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 사운드를 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"lofi","sort_by":"most_used","results_limit":20}'

# metrics.videos_count is the number of videos using each sound.

TikTok Sound Search API 추천 활용 사례

  • 브랜드 영상에 쓸 사운드 후보 추리기: 분위기 키워드를 sort_by most_used로 검색한 뒤, videos_count와 duration_seconds, 오디오 미리듣기를 확인해 검증됐고 클립 길이에 맞는 사운드만 남깁니다.
  • 뜨기 전의 신규 사운드 선점: 같은 키워드를 sort_by latest로 검색해, 트렌드 모음 기사에 오르기 전인 videos_count가 아직 작은 사운드를 골라 둡니다.
  • 곡을 사운드 ID로 확정하기: 곡 제목과 아티스트를 함께 검색해 audio.artist가 일치하는지 확인하고, audio.id를 보관하면 정확히 그 사운드를 쓴 영상을 따라갈 수 있습니다.
  • 시장별 사운드 목록 만들기: 같은 검색어를 region 코드만 바꿔 반복하면, 캠페인을 집행하는 국가마다 별도의 후보 목록을 만들 수 있습니다.

TikTok Sound Search API 활용 팁

  • 정식 라이선스 곡은 제목과 아티스트를 함께 검색하세요. Lofi처럼 짧은 제목은 관련 없는 사운드와도 일치합니다. audio.id를 보관하기 전에 audio.artist를 꼭 확인하세요.
  • 여러 키워드의 검색 결과를 합칠 때는 id로 중복을 제거하세요. 사운드 하나가 둘 이상의 검색어에 걸릴 수 있습니다.
  • videos_count는 증가율이 아닌 누적 합계입니다. 어떤 사운드가 빠르게 오르는지 보려면 같은 검색어를 일정 주기로 실행해 실행 간 수치를 비교하세요.
  • 파일이 필요하면 작업이 끝난 직후 audio.url과 cover_url을 내려받으세요. TikTok은 이 파일을 서명된 링크로 제공하고, 링크는 시간이 지나면 작동하지 않습니다.

TikTok Sound Search API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
  • TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
  • TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
  • TikTok Song API — 클립 ID 또는 음악 URL로 공개 사운드 메타데이터를 가져옵니다.
  • TikTok Song Videos API — 지정한 사운드 ID를 사용한 공개 동영상을 수집합니다.
  • TikTok Popular Songs API — TikTok 앱의 Top 50 또는 Viral 50 곡 차트를 가져오며, 트랙 이름, 아티스트, 사운드 ID, 확인 가능한 동영상 수를 포함합니다.

다른 플랫폼 둘러보기

TikTok 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Sound Search API — 자주 묻는 질문

TikTok Sound Search API는 곡 제목, 아티스트, 분위기 같은 키워드로 TikTok 사운드를 검색하는 프로그래밍 인터페이스입니다. 사운드별 ID, 제목, 아티스트, 커버, 길이, 오디오 미리듣기와 그 사운드를 쓴 영상 수를 반환합니다.

곡 제목을 검색하되, 제목이 흔하면 아티스트도 함께 넣고, 일치하는 결과의 metrics.videos_count를 읽으세요. 그 사운드로 만든 동영상의 총 개수입니다.

아니요. 앱의 해당 기능은 노래를 부르거나 흥얼거리거나 틀어서 곡을 찾아 주지만, 이 엔드포인트는 텍스트로 검색해 제목, 아티스트, 분위기에 맞는 사운드를 돌려줍니다. 녹음된 소리로 곡을 알아내지는 못합니다.

sort_by를 most_used로 하면 가장 많이 쓰인 사운드부터, latest로 하면 가장 새로운 사운드부터 나옵니다. 기본값인 relevance는 키워드와 얼마나 가깝게 일치하는지를 기준으로 합니다.

결과에서 사운드의 id를 가져와 TikTok Song Videos에 보내면, 그 사운드로 올라온 동영상을 수집할 수 있습니다.

region을 두 글자 국가 코드로 지정하지 않으면 미국(US) 시장에서 검색합니다. 코드를 지정하면 그 나라의 TikTok 시장에서 실행됩니다.

results_limit은 1~500을 받으며 기본값은 20입니다. 반환된 사운드 1개당 0.6 크레딧이 청구되고, 일치하는 결과가 없는 검색은 비용이 들지 않습니다.