tiktok/
user-reposts

사용자 이름만으로 공개 TikTok 계정이 리포스트한 동영상을 확인하고, 동영상별 원작자, 캡션, 조회수, 좋아요 수, 해시태그, 동영상 파일을 반환합니다.

TikTok Reposts API

사용자 이름 입력
동영상별 원작자
최신 리포스트순
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Reposts

TikTok 리포스트는 다른 크리에이터의 동영상을 내 팔로워에게 다시 공유한 것으로, 리포스트 목록을 보면 그 계정이 누구의 콘텐츠를 널리 알리고 싶어 하는지 드러납니다. 이 목록을 사용자 이름으로 읽으면 크리에이터 간 관계를 그리고, 브랜드 지지 여부를 확인하고, 본인이 올린 영상만으로는 보이지 않는 계정의 관심사까지 파악할 수 있습니다.

TikTok Reposts API 주요 기능

  • 공개 사용자 이름으로 리포스트 조회사용자 이름을 보내면 TikTok 로그인 없이 해당 계정의 리포스트 목록에 있는 동영상을 최신순으로 받습니다.
  • 원작자와 리포스트한 계정을 구분author에는 리포스트한 계정이 아니라 동영상을 만든 크리에이터의 핸들, 표시 이름, 아바타, 인증 여부가 들어 있습니다.
  • 동영상별 콘텐츠와 반응리포스트마다 캡션, 해시태그, 멘션, 조회수, 좋아요, 댓글, 공유 수, 재생 시간과 함께 사운드의 제목과 아티스트가 들어 있습니다.
  • 동영상 파일과 썸네일 참조media에 동영상 URL, 썸네일, 가로·세로 크기, 길이가 담겨 있어 응답만으로 리포스트를 미리 보거나 보관할 수 있습니다.

TikTok Reposts API 매개변수

매개변수필수설명
username필수리포스트를 수집할 TikTok 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다.
results_limit선택반환할 리포스트 동영상의 개수로, 1~500 사이 값입니다. 기본값은 20입니다.

TikTok Reposts API 사용 방법

사용자 이름을 제출하고 리포스트를 페이지 단위로 읽어 갑니다.

  1. {"username": "mrbeast", "results_limit": 20}을 /v1/tiktok/user-reposts로 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/user-reposts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"mrbeast","results_limit":20}'

# author on each item is the video's original creator.

TikTok Reposts API 추천 활용 사례

  • 계정이 밀어 주는 크리에이터 지도 만들기: 한 크리에이터의 리포스트에서 author.username을 집계하면, 어떤 크리에이터를 가장 자주 공유하는지와 본인 업로드와 취향이 어떻게 다른지 알 수 있습니다.
  • 앰배서더가 우리 브랜드를 리포스트하는지 확인: 협업 중인 크리에이터들의 리포스트를 모은 뒤, 그중 우리 브랜드 계정이 author인 동영상이 몇 건인지 셉니다.
  • 경쟁 브랜드가 띄우는 콘텐츠 살펴보기: 경쟁 브랜드 계정의 리포스트를 가져와 팔로워에게 누구의 콘텐츠를 전하는지, 어떤 해시태그와 사운드가 계속 반복되는지 파악합니다.
  • 퍼져 나가는 클립 찾기: 리포스트된 동영상을 shares_count와 views_count로 정렬하면, 여러 계정이 계속 이어서 공유하는 콘텐츠를 가려낼 수 있습니다.

TikTok Reposts API 활용 팁

  • 크리에이터 관계도는 핸들이 아니라 author.id를 기준으로 만드세요. 핸들은 바뀔 수 있습니다.
  • 지표는 리포스트한 계정의 도달이 아니라 동영상 자체의 수치로 읽으세요. 클립이 전체적으로 얼마나 반응을 얻었는지를 보여 줄 뿐, 이번 리포스트를 통해 몇 명이 봤는지는 아닙니다.
  • 작성자만 보지 말고 hashtags와 audio.title도 함께 훑어 보세요. 크리에이터가 반복해서 리포스트하는 주제와 사운드가 보입니다.

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

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

다른 플랫폼 둘러보기

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

TikTok Reposts API — 자주 묻는 질문

TikTok Reposts API는 사용자 이름으로 공개 TikTok 계정이 리포스트한 동영상을 수집하는 프로그래밍 인터페이스입니다. 동영상별 캡션, 원작자, 반응 수치, 해시태그, 사운드, 동영상 파일 참조를 반환합니다.

네. 공개 계정의 리포스트는 사용자 이름만으로 읽기 때문에 TikTok 로그인이 필요 없고, 내 TikTok 계정과도 연결되지 않습니다.

아니요. 리포스트된 동영상마다 조회수, 좋아요, 댓글, 공유 수는 오지만 시청한 사람의 신원은 제공되지 않습니다.

결과가 비어 있다면 그 계정에 공개된 리포스트가 없다는 뜻입니다. 작업은 정상적으로 성공 처리되며 요금은 청구되지 않습니다.

author입니다. 조회한 계정이 아니라 동영상을 올린 크리에이터를 나타내므로, 한 목록에 같은 author가 여러 번 나올 수 있습니다.

아니요. published_at은 원본 동영상이 올라온 시각이며 리포스트한 시각이 아닙니다. 목록은 계정의 리포스트 탭 순서, 즉 최근에 리포스트한 것부터 정렬됩니다.

최대 500개이고 기본값은 20개이며, has_more가 true이면 next_cursor로 이어서 가져옵니다. 반환된 리포스트 동영상 1개당 0.5 크레딧이 차감됩니다.