douyin/
user-profile

지원되는 프로필 URL 또는 사용자 식별자로 공개 Douyin 프로필 하나를 조회하여 정규화된 계정 정보, 소개, 이미지, 계정 속성, 공개된 수치를 반환합니다.

Douyin User Profile API

URL 또는 사용자 ID
공개 프로필 1개
정규화된 계정 필드
요청당 0.1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

지원되는 프로필 식별자 하나를 제출하고, 비동기 작업을 추적한 뒤, 저장된 결과 구조에서 정규화된 계정을 읽습니다.

  1. /user/<identifier> 경로가 있는 전체 Douyin 프로필 URL 또는 지원되는 공개 user_id 중 하나를 준비합니다.
  2. 식별자 하나를 /v1/douyin/user-profile로 POST하고, 반환된 task_id를 저장합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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.items

Douyin 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을 보존하세요.

Douyin User Profile API 외에 Douyin의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Douyin 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Douyin User Profile API — 자주 묻는 질문

Douyin User Profile API는 지원되는 프로필 URL 또는 사용자 식별자로 공개 Douyin 계정 하나를 조회해, 정규화된 계정 정보, 소개, 이미지, 계정 플래그, 공개된 수치, 수집 시각을 반환합니다.

어느 필드든 요청 요건을 충족합니다. 두 값이 모두 있으면 user_id가 우선하므로, 조회하려는 식별자만 제출하세요.

파싱된 호스트 이름은 douyin.com, iesdouyin.com 또는 그 서브도메인이어야 하고, 경로에는 /user/ 뒤에 영문자, 숫자, 밑줄, 하이픈으로 이루어진 식별자가 이어져야 합니다. 동영상 링크와 관련 없는 호스트는 거부됩니다.

계정 스키마에는 프로필 ID와 URL, 사용자 이름, 표시 이름, 소개, 아바타, 커버 이미지, 웹사이트, 인증·비공개 플래그, 위치, 팔로워 수, 팔로잉 수, 게시물 수, collected_at이 포함될 수 있습니다. 사용할 수 있는 값이 없는 선택적 공개 필드는 null로 유지됩니다.

아니요. 공급자 조회는 단일 상세 요청이며 원본 프로필을 최대 1개 만듭니다. next_cursor와 has_more는 SocQ에 이미 저장된 결과의 페이지네이션만 나타냅니다.

작업이 성공할 때마다 고정 0.10 SocQ 크레딧이 차감됩니다. 채워진 선택적 프로필 필드의 수와는 관계없이 같은 요금이 적용됩니다.