TikTok Following List
TikTok 팔로잉 목록에는 계정이 공개적으로 팔로우하는 프로필이 사용자 ID, 사용자 이름, 표시 이름, 소개글, 아바타, 프로필 링크, 공개된 계정 수치와 함께 담겨 있습니다. 이러한 관계·프로필 레코드는 관심사 네트워크 조사, 크리에이터 탐색, 공개 관계 매핑, 프로필 데이터셋 보강에 활용할 수 있습니다.
TikTok Following List API 주요 기능
- 출처 계정과 프로필의 관계제출한 공개 사용자 이름마다 팔로우 중인 프로필 레코드를 수집하고, 출처 핸들은 extra.input_username에 보관합니다.
- 정규화된 팔로잉 계정 정보저장되는 관계 구성원마다 변하지 않는 사용자 ID, 사용자 이름, 표시 이름, 정식 TikTok 프로필 URL을 반환합니다.
- 공개 프로필 정보팔로우 중인 프로필에 공개된 소개글, 아바타 참조, 공개된 계정 수치를 함께 담습니다.
- 사용자별 수집 범위 제한제공되는 목록 데이터를 페이지 단위로 읽으면서 results_limit을 사용자 이름마다 따로 적용하고, 저장되는 프로필은 고유 식별 정보를 기준으로 중복을 제거합니다.
TikTok Following List API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 비어 있지 않은 공개 TikTok 사용자 이름의 목록으로, 필수 값입니다. 앞의 @는 허용되며 수집 전에 제거됩니다. |
results_limit | 선택 | 사용자 이름마다 요청할 팔로잉 프로필 레코드의 최대 개수입니다. 기본값은 100이며 20~2000 사이의 정수를 허용합니다. |
TikTok Following List API 사용 방법
공개 출처 핸들을 제출한 뒤, 완료된 비동기 작업에서 정규화된 팔로잉 프로필 레코드를 읽습니다.
- 앞의 @는 있어도 없어도 되는 공개 TikTok 사용자 이름을 하나 이상 준비하고, 사용자 이름마다 20~2000 사이의 results_limit을 정합니다.
- usernames와 results_limit을 /v1/tiktok/following-list로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링하고, 성공 또는 실패하면 중단합니다.
- 성공하면 data.results.items를 읽고, has_more가 true이면 같은 작업에 next_cursor를 전달해 저장된 결과의 다음 페이지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueTikTok Following List API 추천 활용 사례
- 관심사 네트워크 조사: 출처 계정 정보를 팔로잉 계정의 ID, 사용자 이름, 소개글과 함께 활용해, 알고 있는 계정을 둘러싼 공개 관심사를 살펴봅니다.
- 시드 계정 기반 크리에이터 탐색: 표시 이름, 소개글, 아바타, 프로필 링크, 공개 수치를 검토해 계정이 공개적으로 팔로우하는 프로필에서 후보 목록을 구성합니다.
- 프로필 데이터셋 보강: 사용자 이름 기반의 프로필 레코드에 고유 ID, 정식 URL, 공개 소개글, 아바타, 공개된 계정 수치를 추가합니다.
TikTok Following List API 활용 팁
- 제출하기 전에 앞의 @를 제거하고 사용자 이름의 중복을 정리해, 같은 핸들이 출처 계정 작업을 중복으로 일으키지 않게 하세요.
- 필요한 깊이에 맞춰 사용자 이름별로 results_limit을 설정하세요. 입력 목록이 클수록 목록 끝과 중복 제거 전에는 최대 usernames × results_limit건의 레코드가 만들어질 수 있습니다.
- id를 기본 프로필 키로 사용하고, 없으면 url로 대체하며, 출처 추적을 위해 extra.input_username을 보관하세요.
- 결과가 비어 있거나 적다면 공개 범위에 따른 결과로 보고, 재시도하기 전에 계정의 비공개 여부와 목록 제공 여부를 확인하세요.
- 다운스트림 데이터가 명시적으로 신호를 제공하지 않는 한, 반환된 순서를 최신성이나 관계의 강도로 해석하지 마세요.
관련 API
TikTok Following List API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Audience Demographics API — 사용자 이름으로 크리에이터의 팔로워가 어느 국가에 있는지 확인하며, 국가별 오디언스 비중을 포함합니다.
- TikTok Similar Accounts API — TikTok이 사용자 이름과 비슷하다고 추천하는 계정을 찾으며, 팔로워 수와 소개를 포함합니다.
- TikTok Live Ranking API — 일간 LIVE 크리에이터 순위를 순위, 선물 기반 점수, 팔로워 수와 함께 가져옵니다.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript 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 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 Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API