TikTok Profiles
TikTok 프로필은 계정 정보, 소개글, 아바타, 인증·비공개 상태, 공개된 팔로워·팔로잉·동영상·좋아요 총계를 담은 공개 크리에이터 또는 계정 페이지입니다. 이러한 프로필 신호는 크리에이터 탐색, 오디언스 비교, 제휴 조사, 디렉터리 정보 보강에 활용할 수 있습니다.
TikTok Profiles API 주요 기능
- 사용자 이름 일괄 조회공개 크리에이터 사용자 이름 하나 이상을 한 번의 요청으로 조회합니다.
- 사용자 이름 입력 정규화프로필을 수집하기 전에 nasa와 @nasa 같은 입력 형태를 정규화합니다.
- 변하지 않는 프로필 식별 정보계정 ID, 사용자 이름, 표시 이름, 프로필 URL로 식별 정보 인덱스를 구성합니다.
- 프로필 및 오디언스 필드소개글, 아바타, 인증·비공개 상태와 함께 팔로워·팔로잉·동영상·전체 좋아요 수를 하나의 레코드로 반환합니다.
- 추적 가능한 프로필 스냅샷제출한 입력값과 collected_at으로 모든 정보 보강과 반복 스냅샷을 추적할 수 있습니다.
TikTok Profiles API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 공개 TikTok 사용자 이름의 목록으로, 필수 값입니다. 각 값의 앞에 붙는 @는 있어도 없어도 됩니다. |
TikTok Profiles API 사용 방법
크리에이터 사용자 이름 목록에서 시작해 디렉터리나 CRM에 바로 넣을 수 있는 레코드를 만듭니다.
- 크리에이터 목록의 nasa, @nasa 같은 항목을 같은 형태로 정규화한 뒤 중복을 제거합니다.
- usernames 배열을 /v1/tiktok/profiles로 POST하고, 반환된 task_id를 저장합니다.
- /v1/tasks/{task_id}를 폴링합니다. queued와 running은 정상적인 중간 상태입니다.
- 성공하면 data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@tiktok"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Profiles API 추천 활용 사례
- 인재 디렉터리 정보 보강: 사용자 이름 목록을 계정 ID, 아바타, 소개글, 상태, 규모 지표가 담긴 크리에이터 카드로 바꿉니다.
- 제휴 준비: 연락하기 전에 크리에이터의 식별 정보, 게시 이력, 오디언스 규모를 검토합니다.
- 크리에이터 성장 추적: 일정한 크리에이터 그룹을 대상으로 팔로워, 동영상, 전체 좋아요 수 스냅샷을 주기적으로 저장합니다.
- 데이터셋 간 계정 매칭: 계정 ID로 크리에이터 레코드를 관련 동영상 및 댓글과 연결합니다.
TikTok Profiles API 활용 팁
- id를 크리에이터 키로 사용하고, username은 검색과 표시용으로 보관하세요.
- 제출한 입력값을 보관해, 모든 API 레코드가 원본 인재 목록과 깔끔하게 대응되도록 하세요.
- 고정된 주기로 수집하고, 지표 스냅샷마다 collected_at을 함께 저장하세요.
- 앞의 @를 제거한 뒤 사용자 이름 기준으로 중복을 제거하세요.
- avatar, display_name, biography, profile_url을 조합해 쓸모 있는 크리에이터 카드를 만드세요.
- 계정 ID로 관련 프로필, 동영상, 댓글 레코드를 조인하면 크리에이터를 더 풍부하게 볼 수 있습니다.
관련 API
TikTok Profiles API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
- TikTok Following List API — TikTok 계정이 팔로우하는 공개 프로필을 수집하며, 정규화된 계정 정보, 소개글, 공개된 지표, 출처 계정 맥락을 포함합니다.
- 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