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. 엔드포인트 선택
이미 알고 있는 공개 참조에 맞는 프로필, 동영상, 댓글, 검색, 라이브 방송 엔드포인트를 선택합니다.
2. 올바른 입력 제출
선언된 필드만 POST하고 반환된 task_id를 저장합니다.
3. 정규화된 결과 읽기
작업이 최종 상태가 될 때까지 폴링한 뒤 data.results.items를 읽고, next_cursor는 저장된 결과의 페이지네이션에만 사용합니다.
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 successDouyin 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 크레딧이 고정으로 차감됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.





