douyin/
user-videos

Douyin 프로필 URL 또는 알고 있는 사용자 ID 하나에서 공개 동영상을 최대 20개 수집하여 정규화된 콘텐츠, 작성자, 미디어, 길이, 타임스탬프, 공개된 참여도 필드를 반환합니다.

Douyin User Videos API

프로필 URL 또는 사용자 ID
최대 20개 동영상
정규화된 reel-video 레코드
요청당 0.1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Douyin User Videos

이 엔드포인트는 Douyin 크리에이터 한 명의 식별 정보를 한 페이지 분량의 공개 동영상 레코드로 변환합니다. 각 레코드에는 원본이 제공하는 경우 캡션, 작성자 정보, 원본 URL, 게시·수집 시각, 미디어, 길이, 공개된 재생·좋아요·댓글·공유·조회 수를 담을 수 있습니다.

Douyin User Videos API 주요 기능

  • 크리에이터를 식별하는 두 가지 방법지원되는 Douyin 프로필 URL 또는 알고 있는 user_id를 제출합니다. 두 필드가 모두 있으면 user_id가 직접 사용됩니다.
  • 명확한 1페이지 범위요청 결과 수를 1~20개로 선택하며, 기본값이자 최댓값은 20입니다. 공급자 요청은 항상 첫 페이지에서 시작합니다.
  • 동영상과 크리에이터 정보를 함께각 동영상 레코드에 정규화된 캡션, 공개 작성자 필드, 원본 URL, 타임스탬프, 미디어 참조, 길이를 함께 유지합니다.
  • 관측에 바로 쓸 수 있는 참여도 필드확인 가능한 재생, 좋아요, 댓글, 공유, 조회 수를 collected_at과 함께 보관해 공개된 수치가 항상 수집 시각과 연결되도록 합니다.

Douyin User Videos API 매개변수

매개변수필수설명
url필수(하나 이상)호스트 이름이 douyin.com, iesdouyin.com 또는 그 서브도메인이고 경로에 /user/{identifier}가 포함된 Douyin 프로필 참조입니다. url 또는 user_id를 제공하세요. 두 필드가 모두 있으면 user_id가 우선합니다.
user_id필수(하나 이상)1~256자의 ASCII 영문자, 숫자, 콜론, 밑줄, 하이픈으로 이루어진 알고 있는 사용자 식별자입니다. user_id 또는 url을 제공하세요.
results_limit선택단일 공급자 페이지에서 요청할 레코드 수입니다. 1~20 범위의 정수를 받으며 기본값은 20입니다.

Douyin User Videos API 사용 방법

공개 크리에이터 식별 정보 하나를 제출하고, 비동기 작업을 따라간 뒤, 저장된 정규화된 동영상 레코드를 읽습니다.

  1. douyin.com 또는 iesdouyin.com의 /user/{identifier} 경로가 있는 Douyin 프로필 URL 또는 알고 있는 user_id를 준비합니다.
  2. 식별 정보와 1~20 범위의 선택 항목 results_limit을 /v1/douyin/user-videos로 POST하고, task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. next_cursor는 공급자의 다른 페이지가 아니라 SocQ에 이미 저장된 추가 레코드를 읽을 때만 따라가세요.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

Douyin User Videos API 추천 활용 사례

  • 크리에이터 피드 스냅샷: 선택한 관측 시점에 크리에이터 한 명의 공개 동영상을 범위가 정해진 묶음으로 저장하고, 수집 타임스탬프를 함께 남깁니다.
  • 동영상 카탈로그 정보 보강: 기존 크리에이터 레코드에 정규화된 캡션, 작성자 정보, 원본 URL, 게시 시각, 길이, 확인 가능한 미디어를 추가합니다.
  • 크리에이티브·포맷 검토: 반환된 캡션, 길이, 미디어 필드를 살펴 확인 가능한 동영상을 콘텐츠 구성이나 포맷별로 분류합니다.
  • 스냅샷 내 참여도 비교: collected_at을 유지한 채 반환된 동영상들의 재생, 좋아요, 댓글, 공유, 조회 수를 비교합니다.

Douyin User Videos API 활용 팁

  • 요청마다 식별 필드는 하나만 쓰는 것이 좋습니다. url과 user_id를 모두 보내면 백엔드는 user_id를 선택합니다.
  • 제출 전에 URL 호스트와 /user/{identifier} 경로를 검증하세요. 일반 Douyin 동영상 URL은 이 엔드포인트의 조건을 충족하지 않습니다.
  • 기본값 20개보다 적은 레코드로 충분할 때만 results_limit을 설정하세요. 1~20 범위의 정수여야 합니다.
  • 작업 결과 커서를 Douyin 원본 커서로 취급하지 마세요. 원본 요청은 공급자 커서가 첫 페이지로 고정된 1페이지 요청입니다.
  • 선택 항목인 작성자 정보, 미디어, 길이, 게시 시각, 개별 지표는 null이거나 비어 있을 수 있음을 감안하고, 관측값을 저장할 때는 id와 collected_at을 함께 사용하세요.

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

다른 플랫폼 둘러보기

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

Douyin User Videos API — 자주 묻는 질문

Douyin User Videos API는 크리에이터 한 명의 공개 동영상 레코드를 정규화해 반환하며, 확인 가능한 경우 식별 정보, 캡션, 작성자 정보, 원본 URL, 타임스탬프, 미디어, 길이, 공개된 참여도 필드를 포함합니다.

어느 필드든 입력 요건을 충족합니다. URL은 지원되는 Douyin 호스트를 사용하고 /user/{identifier}를 포함해야 하며, 알고 있는 user_id는 바로 제공할 수 있고 두 필드가 모두 있으면 user_id가 우선합니다.

단일 공급자 페이지에서 요청하는 레코드 수를 제어합니다. 1~20 범위의 정수여야 하며 기본값은 20입니다.

결과에는 재생, 좋아요, 댓글, 공유, 조회 수가 포함될 수 있습니다. 각 필드는 선택 항목이므로 원본에서 제공되지 않는 값은 추정하지 않고 null로 유지됩니다.

아니요. 공급자 요청은 첫 페이지만 사용합니다. SocQ 작업 결과 조회의 next_cursor는 해당 작업에 이미 저장된 레코드를 페이지네이션합니다.

Douyin User Videos 작업은 성공할 때마다 고정 0.10 SocQ 크레딧이 차감되며, 20개 상한 안에서 반환된 레코드 수와는 관계없습니다.