API 목록으로 돌아가기
Douyin 공개 데이터

Douyin 공개 데이터 API

공개 프로필과 동영상을 가져오고, 동영상을 검색하고, 댓글이나 크리에이터 동영상 한 페이지를 수집하고, 알고 있는 라이브 방송을 확인합니다.

사용할 수 있는 Douyin API

프로필, 동영상, 댓글, 검색, 라이브 방송 워크플로에 맞춰 6가지 API 중에서 선택합니다.

어떤 Douyin 데이터를 가져올 수 있나요?

Douyin 카탈로그는 공개 원본 데이터에서 정규화된 계정, 숏폼 동영상, 댓글, 라이브 방송 레코드를 반환합니다.

프로필과 크리에이터 동영상

공개 프로필을 확인하거나, 지원되는 프로필 URL 또는 user_id에서 동영상의 원본 한 페이지를 수집합니다.

동영상 상세 정보, 검색, 댓글

지원되는 동영상 참조를 확인하고, 검색어로 고정된 첫 번째 원본 페이지를 검색하거나, 댓글 한 페이지를 수집합니다.

라이브 방송 상세 정보

숫자로만 이루어진 room_id로 알고 있는 라이브 방송 하나를 조회하며, 제공되는 호스트, 상태, 미디어, 공개된 시청자 필드를 가져옵니다.

Douyin API 사양 한눈에 보기

각 엔드포인트는 범위가 정해진 원본 요청을 사용하며, 선언되지 않은 매개변수는 거부합니다.

API 그룹시작 입력원본 범위
프로필과 크리에이터 동영상url 또는 user_id프로필 하나 또는 원본 한 페이지. 크리에이터 동영상은 results_limit 1~20 지원
동영상 상세 정보와 댓글지원되는 URL상세 레코드 하나 또는 댓글 한 페이지. 댓글은 results_limit 1~20 지원
동영상 검색비어 있지 않은 query고정된 첫 번째 원본 페이지이며 results_limit 없음
라이브 방송숫자로만 이루어진 room_id라이브 방송 레코드 최대 1건

Douyin API 작동 방식

6가지 엔드포인트 모두 제출, 폴링, 저장된 결과 읽기로 이어지는 같은 비동기 워크플로를 사용합니다.

  1. 1. 엔드포인트 선택

    이미 알고 있는 공개 참조에 맞는 프로필, 동영상, 댓글, 검색, 라이브 방송 엔드포인트를 선택합니다.

  2. 2. 올바른 입력 제출

    선언된 필드만 POST하고 반환된 task_id를 저장합니다.

  3. 3. 정규화된 결과 읽기

    작업이 최종 상태가 될 때까지 폴링한 뒤 data.results.items를 읽고, next_cursor는 저장된 결과의 페이지네이션에만 사용합니다.

공개 Douyin 동영상 검색

SocQ API 키로 인증하고 비어 있지 않은 query를 제출합니다. 성공한 Douyin 작업은 0.10 크레딧이 고정으로 차감됩니다.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Douyin API 주요 활용 사례

크리에이터 리서치

공개 프로필 신원 정보를 범위가 정해진 크리에이터 동영상 한 페이지, 공개된 참여 수치와 결합합니다.

콘텐츠·대화 검토

알고 있는 동영상 정보를 보강하고, 주제 스냅샷을 검색하고, 공개 댓글 한 페이지를 확인합니다.

라이브 방송 모니터링

명시적인 숫자 방송 식별자를 사용해 알고 있는 공개 라이브 방송의 스냅샷을 기록합니다.

제한 사항과 공개 데이터 정책

이 엔드포인트들은 범위가 정해진 원본 요청으로 공개 데이터를 읽으며, 계정 조작이나 지속적인 모니터링은 제공하지 않습니다.

  • user_id는 ASCII 영문자, 숫자, 콜론, 밑줄, 하이픈으로 이루어진 1~256자를 받습니다. 프로필 URL은 지원되는 Douyin 호스트에서 /user/{identifier}를 포함해야 합니다.
  • room_id는 숫자로만 이루어진 문자열입니다. 긴 식별자가 JavaScript 숫자 값에 들어가지 않도록 하세요.
  • results_limit은 User Videos와 Video Comments에서만 사용할 수 있으며, 범위는 1~20이고 기본값은 20입니다.
  • Video Search는 첫 번째 원본 페이지로 고정되어 있으며, 작업 결과 커서는 해당 작업에 이미 저장된 레코드만 페이지 단위로 넘깁니다.
  • 성공한 Douyin 작업은 모두 0.10 크레딧이 고정으로 차감됩니다.

Douyin API 자주 묻는 질문

Douyin API란 무엇인가요?

Douyin API는 공개 프로필, 동영상, 댓글, 동영상 검색 결과, 라이브 방송 상세 정보를 정규화된 레코드로 가져옵니다.

어떤 엔드포인트가 results_limit을 받나요?

User Videos와 Video Comments는 1부터 20까지의 정수를 받습니다. 그 밖의 Douyin 엔드포인트는 results_limit을 거부합니다.

원본을 페이지 단위로 넘길 수 있나요?

아니요. 호출자가 제어할 수 있는 원본 커서는 없습니다. 반환된 next_cursor는 완료된 작업에 이미 저장된 결과만 페이지 단위로 넘깁니다.

Douyin 요청의 요금은 어떻게 되나요?

성공한 작업은 건당 0.10 SocQ 크레딧이 고정으로 차감됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.