Douyin User Profile
Douyin 사용자 프로필은 계정 정보, 소개, 프로필 이미지, 인증·비공개 상태, 공개된 팔로워·팔로잉·게시물 수를 담은 공개 계정 화면입니다. 이러한 필드는 계정 정보 보강, 신원 확인, 스냅샷 모니터링, 프로필 비교 조사에 활용할 수 있습니다.
Douyin User Profile API 주요 기능
- 두 가지 지원 식별자지원되는 Douyin 사용자 URL 또는 런타임 식별자 규칙에 맞는 user_id 중 하나로 공개 프로필 하나를 조회합니다.
- 프로필 정보와 표시 요소확인 가능한 프로필 ID, 공개 URL, 사용자 이름, 표시 이름, 소개, 아바타, 커버 이미지, 연결된 웹사이트를 하나의 계정 레코드로 반환합니다.
- 명시적인 계정 상태 필드확인 가능한 인증·비공개 플래그를 null 허용 값으로 보존하며, 공개 원본에 없는 상태를 추정하지 않습니다.
- 공개된 프로필 수치확인 가능한 팔로워·팔로잉·게시물 수를 collected_at과 함께 정규화해, 특정 시점의 공개 프로필 상태를 제공합니다.
Douyin User Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수(하나 이상) | url 또는 user_id를 제공하세요. 비어 있지 않은 URL은 douyin.com, iesdouyin.com 또는 그 서브도메인을 사용하고 /user/<identifier> 경로를 포함해야 합니다. |
user_id | 필수(하나 이상) | user_id 또는 url을 제공하세요. user_id는 1~256자의 ASCII 영문자, 숫자, 콜론, 밑줄, 하이픈을 받으며, 두 필드를 모두 제출하면 user_id가 우선합니다. |
Douyin User Profile API 사용 방법
지원되는 프로필 식별자 하나를 제출하고, 비동기 작업을 추적한 뒤, 저장된 결과 구조에서 정규화된 계정을 읽습니다.
- /user/<identifier> 경로가 있는 전체 Douyin 프로필 URL 또는 지원되는 공개 user_id 중 하나를 준비합니다.
- 식별자 하나를 /v1/douyin/user-profile로 POST하고, 반환된 task_id를 저장합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽습니다. 원본 조회는 프로필을 최대 1개 만들지만, 저장된 결과 구조는 여전히 has_more와 next_cursor를 보고합니다.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.itemsDouyin User Profile API 추천 활용 사례
- 크리에이터 레코드 정보 보강: 기존 크리에이터 레코드에 확인 가능한 Douyin 계정 정보, 소개, 이미지, 웹사이트, 계정 플래그, 공개 수치를 추가합니다.
- 프로필 신원 확인: 내부 엔터티에 연결하기 전에 알고 있는 프로필 URL 또는 사용자 식별자를 일관된 계정 객체로 변환합니다.
- 공개 계정 비교: 따로 수집한 프로필들의 팔로워·팔로잉·게시물 수를 같은 정규화된 지표 키로 비교합니다.
- 프로필 스냅샷 모니터링: 계정 정보 필드와 공개 지표를 collected_at과 함께 저장해, 이후 작업도 구분 가능한 특정 시점 관측값으로 유지합니다.
Douyin User Profile API 활용 팁
- 정식 사용자 식별자가 이미 있다면 user_id만 제출하세요. url과 user_id가 서로 다르면 공급자 요청에는 user_id가 사용됩니다.
- URL을 제출하기 전에 호스트 이름을 확인하고 /user/<identifier> 경로를 필수로 검사하면, 동영상이나 다른 Douyin 리소스 링크를 로컬에서 거부할 수 있습니다.
- 원본 프로필 레코드는 0개 또는 1개입니다. 작업 결과 조회의 커서는 저장된 SocQ 항목을 페이지네이션할 뿐, 이 조회에서 공급자의 다른 페이지를 요청할 수는 없습니다.
- 계정 정보, 이미지, 웹사이트, 계정 플래그, 위치, 각 지표는 null일 수 있는 값으로 취급하고, 반복 수집한 스냅샷을 비교할 때는 collected_at을 보존하세요.
관련 API
Douyin User Profile API 외에 Douyin의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Douyin Live Room Detail API — 숫자형 방 ID로 알고 있는 Douyin 라이브 방송 하나를 가져오며, 정규화된 방송 맥락, 호스트 정보, 미디어, 공개된 시청자 수를 포함합니다.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API