검색
종량제, 최소 5 크레딧/v1/douyin/search공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.
query, limit, sort, published, duration
Douyin API공개 더우인 데이터 API
SocialCrawl API 키 하나로 공개 더우인 영상, 크리에이터, 댓글과 답글, 인기 검색 순위를 구조화 JSON으로 가져옵니다. 다른 플랫폼과 동일한 Post, Comment, Author 스키마를 사용합니다. 호출은 크레딧으로 과금됩니다.
/v1/douyin
활성 엔드포인트는 8개입니다.
- GET /v1/douyin/search
- GET /v1/douyin/profile
- GET /v1/douyin/profile/posts
- GET /v1/douyin/post
- GET /v1/douyin/post/comments
- GET /v1/douyin/comment/replies
- GET /v1/douyin/search/users
- GET /v1/douyin/trending
Douyin 엔드포인트
공개 더우인 읽기 엔드포인트는 8개입니다. 키워드 영상 검색, 크리에이터 프로필과 업로드, 단일 영상, 댓글, 답글 스레드, 크리에이터 검색, 인기 검색 순위를 제공합니다. 데이터 API만 지원하며 게시와 메시지는 제공하지 않습니다.
프로필
6 크레딧/v1/douyin/profile공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.
handle, url, id
프로필 게시물
종량제, 최소 5 크레딧/v1/douyin/profile/posts공개 프로필 게시물 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.
handle, url, id, limit
게시물
10 크레딧/v1/douyin/post공개 게시물 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.
url
게시물 댓글
종량제, 최소 2 크레딧/v1/douyin/post/comments공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.
url, limit
Comment Replies
종량제, 최소 5 크레딧/v1/douyin/comment/replies공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.
url, comment_id, limit, cursor
사용자 검색
종량제, 최소 5 크레딧/v1/douyin/search/users공개 사용자 검색 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.
query, limit, cursor, followers, user_type
트렌딩
25 크레딧/v1/douyin/trending공개 트렌딩 데이터를 반환합니다. 필드는 레지스트리 스키마를 따릅니다.
see docs
Douyin API8개 엔드포인트 지원
문서 보기Search
Profiles
Posts
Comments
Trending
키워드에 맞는 더우인 영상을 캡션, 크리에이터, 좋아요, 댓글, 공유, 저장, 해시태그, 음악, 커버 이미지와 함께 반환합니다.
중국 시장에서 주제나 브랜드 언급을 추적할 때 씁니다. 영상이 아니라 크리에이터를 찾는다면 크리에이터 검색을 부르세요.
5-250크레딧 (metered)
GET/v1/douyin/search?query=%E7%BE%8E%E9%A3%9F
query · Search keywords, for example 美食 or coffee.
$ curl https://www.socialcrawl.dev/v1/douyin/search?query=%E7%BE%8E%E9%A3%9F \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Douyin API 동작 방식
더우인은 일반적인 SocialCrawl 소셜 표면입니다. API 키로 GET /v1/douyin/… 를 호출하면 단일 JSON 봉투로 응답합니다. 중국 계정과 VPN, 별도 SDK가 필요하지 않습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.
연동 순서
대부분의 제품은 주제를 검색하고, 그 뒤의 크리에이터를 확인한 뒤, 필요한 영상과 스레드만 깊게 조회합니다.
01검색
GET /v1/douyin/search키워드에 해당하는 영상 목록과 반응 수치
중국어, 영어, 혼합 질의를 모두 지원합니다.
02크리에이터
GET /v1/douyin/profile팔로워, 받은 좋아요, 지역이 담긴 Author 프로필
sec_uid를 한 번 확인해 두면 이후 추적이 쉽습니다.
03영상
GET /v1/douyin/profile/posts음악, 장소, 해상도까지 포함한 전체 Post
검색 결과에는 단일 영상 레코드보다 적은 정보가 담깁니다.
04스레드
GET /v1/douyin/post댓글 목록과 상위 댓글에 연결된 답글
답글마다 상위 댓글 id가 있어 대화를 그대로 복원합니다.
요청
GET /v1/douyin/search
?query=美食
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here응답 봉투
{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.
Authorsearch
id, username, display_name, avatar_url, bio, followers, url, ext
PostList / Postprofile
items[].post에 id, url, content, engagement, author, published_at, ext
CommentListprofile/posts
댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at
Search / Mediapost
검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.
- 04
정규화 후 반환
upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- 표준 라이브 미스: 티어 비용(보통 1 크레딧)
- 고급 읽기: 보통 5 크레딧
- 프리미엄 읽기: 보통 10 크레딧
- 종량제 라우트: 문서화된 최소 바닥
- 캐시 히트: 0 크레딧
- 빈 응답·하드 실패: 자동 환불
- 잘못된 파라미터: 400, 미과금
- 크레딧 부족: 402, 미과금
- 비활성 라우트: 503, 미과금
데이터 수집 방식
Douyin은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.
이 API에서의 Douyin
레지스트리에 노출된 공개 Douyin 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.
SocialCrawl 접근 방식
하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.
엣지에서 나가는 형태
success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.
제공하지 않는 범위
쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.
필드 매핑
public profile / channel→ author.*프로필 식별자와 카운터
public post / media→ post.* / items[].post게시물 본문과 참여 지표
comment page / tree→ CommentList items[]댓글 또는 검색 결과
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
8active Douyin endpoints in the registry
1 / 5 / 10표준·고급·프리미엄 크레딧 단계
중국 시장 조사와 크리에이터 발굴
호출은 Douyin 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 더우인은 틱톡과 별개의 네트워크로 크리에이터와 콘텐츠, 인기 흐름이 모두 다릅니다. 그 데이터를 글로벌 플랫폼과 같은 스키마, 같은 키로 제공합니다.
상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
모니터링 잡
Python, cron, Slack 봇Douyin 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.
리서치·VoC
Node, 노트북, BI 적재Douyin에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.
백엔드 제품 잡
Go, 워커, Explorer해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.
두 줄로 호출
라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.
curl "https://www.socialcrawl.dev/v1/douyin/search?query=美食" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/douyin/profile?url=https://www.douyin.com/user/MS4wLjABAAAAtxsy7VmVkU3RN9oIX0vdkh_6-LlQAb0gwI-tDf-bYNg" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Douyin API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 스크래핑, 뭐가 다른가요?
같은 Douyin 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 스크래핑 |
|---|---|---|
| 중국 밖에서 접근 | API 키만 있으면 어디서든 | 중국 주거용 IP를 직접 운영해야 함 |
| 요청 서명 | 대신 처리합니다 | a_bogus를 직접 구현하고 바뀔 때마다 갱신 |
| 응답 형태 | 다른 플랫폼과 똑같은 통합 JSON | 필드 수백 개짜리 원본 더우인 JSON |
| 조회 수 | 더우인이 공개하지 않으므로 null | 0이 들어와 시청자가 없는 것처럼 보임 |
| 답글 연결 | 모든 답글에 실제 상위 댓글 ID가 붙습니다 | 어느 엔드포인트를 쓰느냐에 따라 다름 |
| 과금 | 실제로 받은 행만큼 | 프록시 비용에 직접 쓴 개발 시간까지 |
중국 밖에서 접근
SocialCrawl
API 키만 있으면 어디서든
직접 스크래핑
중국 주거용 IP를 직접 운영해야 함
요청 서명
SocialCrawl
대신 처리합니다
직접 스크래핑
a_bogus를 직접 구현하고 바뀔 때마다 갱신
응답 형태
SocialCrawl
다른 플랫폼과 똑같은 통합 JSON
직접 스크래핑
필드 수백 개짜리 원본 더우인 JSON
조회 수
SocialCrawl
더우인이 공개하지 않으므로 null
직접 스크래핑
0이 들어와 시청자가 없는 것처럼 보임
답글 연결
SocialCrawl
모든 답글에 실제 상위 댓글 ID가 붙습니다
직접 스크래핑
어느 엔드포인트를 쓰느냐에 따라 다름
과금
SocialCrawl
실제로 받은 행만큼
직접 스크래핑
프록시 비용에 직접 쓴 개발 시간까지
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기더우인과 틱톡은 같은 서비스인가요
다릅니다. 더우인은 중국 본토용, 틱톡은 해외용이에요. 크리에이터도 콘텐츠도 인기 주제도 따로 돌아가서, 더우인에서 검색한 영상은 틱톡에서 찾을 수 없습니다.
조회 수가 항상 null로 오는 이유는 무엇인가요
더우인이 앱 밖으로 재생 수를 공개하지 않기 때문이에요. 어떤 소스를 써도 0이 오는데, 0을 그대로 주면 시청자가 없는 영상처럼 읽힙니다. 좋아요, 댓글, 공유, 저장 수는 모두 실제 값입니다.
중국 IP나 더우인 계정이 필요한가요
필요 없습니다. 소셜크롤 API 키만으로 어디서든 호출하면 돼요. 중국 쪽 접근과 요청 서명은 엔드포인트 뒤에서 처리하고, 더우인 로그인이나 쿠키도 쓰지 않습니다.
더우인 크리에이터는 무엇으로 지정하나요
프로필 주소에 들어 있는 MS4wLjAB로 시작하는 sec_uid나 숫자 사용자 ID를 씁니다. 사람이 정한 아이디를 안 쓰는 크리에이터가 많아 author.username은 비어 있을 때가 많고, 연결에는 author.id를 쓰세요.
요금은 어떻게 매겨지나요
검색, 크리에이터 업로드, 크리에이터 검색, 답글은 행 단위로 과금하고 실제로 받은 행만 계산해요. 개별 영상, 프로필, 인기 검색 순위는 호출당 고정 요금입니다.
댓글 스레드 전체를 볼 수 있나요
가능합니다. 댓글 엔드포인트로 최상위 댓글을 받고, 답글 수가 0이 아닌 댓글의 id를 답글 엔드포인트에 넘기면 돼요. 답글마다 물어본 댓글이 parent_id로 붙어 옵니다.
Douyin 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Douyin 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Douyin 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Douyin 스크래핑 API와 공식 Douyin API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Douyin 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요