TikTok Reposts
TikTok 리포스트는 다른 크리에이터의 동영상을 내 팔로워에게 다시 공유한 것으로, 리포스트 목록을 보면 그 계정이 누구의 콘텐츠를 널리 알리고 싶어 하는지 드러납니다. 이 목록을 사용자 이름으로 읽으면 크리에이터 간 관계를 그리고, 브랜드 지지 여부를 확인하고, 본인이 올린 영상만으로는 보이지 않는 계정의 관심사까지 파악할 수 있습니다.
TikTok Reposts API 주요 기능
- 공개 사용자 이름으로 리포스트 조회사용자 이름을 보내면 TikTok 로그인 없이 해당 계정의 리포스트 목록에 있는 동영상을 최신순으로 받습니다.
- 원작자와 리포스트한 계정을 구분author에는 리포스트한 계정이 아니라 동영상을 만든 크리에이터의 핸들, 표시 이름, 아바타, 인증 여부가 들어 있습니다.
- 동영상별 콘텐츠와 반응리포스트마다 캡션, 해시태그, 멘션, 조회수, 좋아요, 댓글, 공유 수, 재생 시간과 함께 사운드의 제목과 아티스트가 들어 있습니다.
- 동영상 파일과 썸네일 참조media에 동영상 URL, 썸네일, 가로·세로 크기, 길이가 담겨 있어 응답만으로 리포스트를 미리 보거나 보관할 수 있습니다.
TikTok Reposts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | 리포스트를 수집할 TikTok 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 반환할 리포스트 동영상의 개수로, 1~500 사이 값입니다. 기본값은 20입니다. |
TikTok Reposts API 사용 방법
사용자 이름을 제출하고 리포스트를 페이지 단위로 읽어 갑니다.
- {"username": "mrbeast", "results_limit": 20}을 /v1/tiktok/user-reposts로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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도 함께 훑어 보세요. 크리에이터가 반복해서 리포스트하는 주제와 사운드가 보입니다.
관련 API
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 Hashtags 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 Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts 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