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 사용 방법
공개 크리에이터 식별 정보 하나를 제출하고, 비동기 작업을 따라간 뒤, 저장된 정규화된 동영상 레코드를 읽습니다.
- douyin.com 또는 iesdouyin.com의 /user/{identifier} 경로가 있는 Douyin 프로필 URL 또는 알고 있는 user_id를 준비합니다.
- 식별 정보와 1~20 범위의 선택 항목 results_limit을 /v1/douyin/user-videos로 POST하고, task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 resultsDouyin 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을 함께 사용하세요.
관련 API
Douyin User Videos API 외에 Douyin의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Douyin Live Room Detail API — 숫자형 방 ID로 알고 있는 Douyin 라이브 방송 하나를 가져오며, 정규화된 방송 맥락, 호스트 정보, 미디어, 공개된 시청자 수를 포함합니다.
- Douyin User Profile API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API