tiktok/
following-list

하나 이상의 사용자 이름이 팔로우하는 공개 TikTok 프로필을 수집하고, 식별 정보, 소개글, 아바타, 공개 수치, 출처 계정 정보를 정규화된 레코드로 반환합니다.

TikTok Following List API

팔로잉 관계
프로필 레코드
사용자별 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

공개 출처 핸들을 제출한 뒤, 완료된 비동기 작업에서 정규화된 팔로잉 프로필 레코드를 읽습니다.

  1. 앞의 @는 있어도 없어도 되는 공개 TikTok 사용자 이름을 하나 이상 준비하고, 사용자 이름마다 20~2000 사이의 results_limit을 정합니다.
  2. usernames와 results_limit을 /v1/tiktok/following-list로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링하고, 성공 또는 실패하면 중단합니다.
  4. 성공하면 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 true

TikTok Following List API 추천 활용 사례

  • 관심사 네트워크 조사: 출처 계정 정보를 팔로잉 계정의 ID, 사용자 이름, 소개글과 함께 활용해, 알고 있는 계정을 둘러싼 공개 관심사를 살펴봅니다.
  • 시드 계정 기반 크리에이터 탐색: 표시 이름, 소개글, 아바타, 프로필 링크, 공개 수치를 검토해 계정이 공개적으로 팔로우하는 프로필에서 후보 목록을 구성합니다.
  • 프로필 데이터셋 보강: 사용자 이름 기반의 프로필 레코드에 고유 ID, 정식 URL, 공개 소개글, 아바타, 공개된 계정 수치를 추가합니다.

TikTok Following List API 활용 팁

  • 제출하기 전에 앞의 @를 제거하고 사용자 이름의 중복을 정리해, 같은 핸들이 출처 계정 작업을 중복으로 일으키지 않게 하세요.
  • 필요한 깊이에 맞춰 사용자 이름별로 results_limit을 설정하세요. 입력 목록이 클수록 목록 끝과 중복 제거 전에는 최대 usernames × results_limit건의 레코드가 만들어질 수 있습니다.
  • id를 기본 프로필 키로 사용하고, 없으면 url로 대체하며, 출처 추적을 위해 extra.input_username을 보관하세요.
  • 결과가 비어 있거나 적다면 공개 범위에 따른 결과로 보고, 재시도하기 전에 계정의 비공개 여부와 목록 제공 여부를 확인하세요.
  • 다운스트림 데이터가 명시적으로 신호를 제공하지 않는 한, 반환된 순서를 최신성이나 관계의 강도로 해석하지 마세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Following List API — 자주 묻는 질문

TikTok Following List API는 하나 이상의 TikTok 사용자 이름이 팔로우하는 공개 프로필을 수집하는 프로그래밍 인터페이스입니다. 정규화된 프로필 식별 정보, 소개글, 아바타, 공개 수치, 정식 URL, 출처 계정 정보를 반환합니다.

usernames 배열에 비어 있지 않은 핸들을 하나 이상 보냅니다. 앞의 @는 있어도 없어도 되며, 수집 전에 제거됩니다.

정규화된 레코드에는 팔로우 중인 사용자의 ID, 사용자 이름, 표시 이름, 정식 프로필 URL, 공개 소개글, 아바타, 공개된 프로필 수치, 수집 시각, extra.input_username이 포함될 수 있습니다.

results_limit은 기본값이 100이고 20~2000 사이의 정수를 받으며, 사용자 이름마다 따로 적용됩니다. 공개된 목록이 끝나거나 중복된 프로필이 제거되면 저장되는 총 개수가 더 적을 수 있습니다.

계정의 비공개 설정, 플랫폼의 제한, 사용할 수 없는 목록 페이지, 공개된 관계 목록의 끝 때문에 반환되는 레코드가 줄어들 수 있습니다. 재시도하기 전에 출처 계정의 공개 범위를 확인하세요.

아니요. 별도의 출처에서 친밀도나 최신성 의미를 명시적으로 제공하지 않는 한, 반환된 순서는 수집 순서로만 취급하세요.

저장된 정규화 프로필 레코드 1건당 0.5 크레딧이 차감됩니다. 실제로 저장된 레코드 수를 기준으로 과금하므로, 결과가 없는 작업에는 결과 단위 요금이 부과되지 않습니다.