tiktok/
videos

하나 이상의 동영상 URL로 공개 TikTok 동영상 메타데이터를 조회하고, 정규화된 크리에이터, 캡션, 미디어, 음악, 해시태그, 멘션, 참여도를 반환합니다.

TikTok Videos API

URL 정보 보강
크리에이티브 분석
성과 스냅샷
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Videos

TikTok 동영상은 캡션, 크리에이터 정보, 미디어, 음악, 재생 시간, 해시태그, 멘션, 게시 정보, 공개된 참여도를 담은 숏폼 게시물입니다. 이러한 콘텐츠 신호는 트렌드 조사, 크리에이티브 분석, 캠페인 검토, 성과 비교에 활용할 수 있습니다.

TikTok Videos API 주요 기능

  • 동영상 URL 일괄 조회TikTok 동영상 링크 여러 개를 일관된 콘텐츠 레코드로 변환합니다.
  • 변하지 않는 동영상 식별 정보동영상 ID와 정식 URL로 동영상의 정체와 출처를 확인합니다.
  • 콘텐츠 및 크리에이터 필드캡션, 언어, 게시 시각, 크리에이터, 재생 시간, 커버 정보를 추출합니다.
  • 크리에이티브 맥락 필드해시태그, 멘션, 음악, 콘텐츠 플래그를 크리에이티브 분석에 활용할 수 있습니다.
  • 특정 시점의 지표공개된 참여도 수치를 collected_at과 함께 담아 성과 스냅샷을 만듭니다.

TikTok Videos API 매개변수

매개변수필수설명
urls필수현재 공개적으로 접근할 수 있는 TikTok 동영상 URL의 목록으로, 필수 값입니다.

TikTok Videos API 사용 방법

북마크, 보고서, 내부 시스템에 있는 링크를 분석에 바로 쓸 수 있는 동영상 목록으로 바꿉니다.

  1. 동영상 링크를 모으고 URL 형식을 정규화한 뒤 목록의 중복을 제거합니다.
  2. urls 배열을 /v1/tiktok/videos로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok Videos API 추천 활용 사례

  • 콘텐츠 패턴 분석: 캡션, 해시태그, 멘션, 음악, 재생 시간을 조합해 선택한 동영상 전반에서 반복되는 요소를 비교합니다.
  • 캠페인 동영상 리포팅: 선택한 에셋 세트의 조회수와 참여도를 수집해 캠페인 성과를 일관되게 비교합니다.
  • 동영상 에셋 카탈로그: 동영상 ID, 정식 URL, 커버, 크리에이터, 게시 시각으로 콘텐츠를 색인해 빠르게 찾을 수 있게 합니다.
  • 주제·형식 태깅: 언어, 캡션, 해시태그, 음악으로 주제, 형식, 의도한 타깃 오디언스를 분류합니다.

TikTok Videos API 활용 팁

  • 중복된 에셋은 id 기준으로 병합하고, 검토와 원본 이동을 위해 url을 보관하세요.
  • published_at은 게시 시각으로, collected_at은 지표 스냅샷 시각으로 구분해서 저장하세요.
  • caption, hashtags, mentions, music을 조합해 검색 가능한 콘텐츠 특성으로 만드세요.
  • views가 있고 0보다 클 때, 이를 좋아요·댓글·공유 비율의 분모로 사용하세요.
  • 같은 동영상 ID로 Comments 레코드를 조인하면 에셋 성과를 오디언스 반응과 비교할 수 있습니다.
  • 참여도 스냅샷이 의미를 갖도록 비교할 세트는 시간적으로 가까운 시점에 수집하세요.

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

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
  • TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
  • TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
  • TikTok Video Transcript API — 공개 동영상 URL에서 제공되는 스크립트 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
  • TikTok Fake Views Checker API — 동영상 URL의 가짜 조회수 위험을 점수로 매기며, 추정 가짜 조회수와 트래픽 단계를 포함합니다.

다른 플랫폼 둘러보기

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

TikTok Videos API — 자주 묻는 질문

TikTok Videos API는 하나 이상의 TikTok 동영상 URL에서 공개적으로 접근할 수 있는 동영상 메타데이터를 조회합니다. 정규화된 크리에이터, 캡션, 미디어, 음악, 해시태그, 멘션, 게시 정보, 참여도 데이터를 반환합니다.

urls 배열에 TikTok 동영상 URL을 하나 이상 넣습니다. 각 URL은 알고 있는 동영상 조회로 처리됩니다.

네. urls에는 여러 링크를 넣을 수 있어, 캠페인·크리에이터·경쟁사 동영상 목록의 정보를 일괄 보강할 수 있습니다.

결과에는 동영상 ID, 정식 URL, 캡션, 언어, 게시 시각, 해시태그, 멘션과 함께 공개 크리에이터 식별 정보 및 프로필 필드가 포함됩니다.

결과에는 좋아요 수, 댓글 수, 조회수, 공유 수, 저장 수, 리포스트 수가 포함될 수 있으며, 재생 시간, 미디어, 음악 메타데이터도 함께 제공됩니다.

참여도 지표를 collected_at과 함께 저장한 뒤, 선택한 동영상 세트를 비슷한 수집 시점끼리 비교하세요.

정규화된 동영상 결과 1건이 반환될 때마다 0.7 크레딧이 차감됩니다.