Douyin API

Douyin search 파라미터는 각각 무엇을 의미하나요?

검색어로 Douyin 동영상을 찾습니다. 캡션, 해시태그, 좋아요, 댓글, 공유, 저장 수, 작성자 정보, 서명된 재생 링크를 가져옵니다. Douyin은 재생 수를 공개하지 않습니다. 따라서 view_count는 대개 없거나 0이며 실제 재생 수를 나타내지 않습니다. 도달 범위는 좋아요, 댓글, 공유로 판단하세요.

keyword필수

동영상 검색 액션에 사용할 검색어로, 문자열로 전달합니다(예: latte art). 동영상을 찾는 데 사용하며, 계정 닉네임이나 동영상 ID가 아닙니다.

page_token선택

페이지 토큰입니다. 페이지네이션을 시작하려면 빈 문자열 page_token=""을 보내고, 다음 페이지는 이전 응답의 next_page_token을 받은 그대로 전달해 가져옵니다. 이때 keyword, sort, publish_time은 바꾸지 않습니다. 페이지마다 호출 1건이며, Douyin 결과 페이지 단위로 잘리지 않고 반환됩니다. 페이지당 최소 limit개(기본값 10, 최대 50, 마지막 페이지는 더 적음)의 동영상이 오며, 몇 개 더 오는 경우가 많습니다. Douyin이 이전 페이지에서 반복한 동영상은 제외됩니다. 토큰은 24시간 동안 유효하며 같은 계정과 같은 파라미터에서만 작동합니다. 만료되었거나 일치하지 않는 토큰은 422를 반환하므로 첫 페이지부터 다시 시작해야 합니다. 마지막 페이지의 응답에는 next_page_token이 없습니다. page_token 없이 호출하면 최대 limit개의 동영상을 한 번만 가져오며 next_page_token은 없습니다.

publish_time선택

게시 기간으로 동영상 검색 결과를 필터링합니다. 허용 값은 unlimited(기본값), one_day(최근 24시간), one_week(최근 7일), half_year(최근 6개월)입니다.

허용 값:half_yearone_dayone_weekunlimited

sort선택

동영상 검색 결과를 정렬합니다. 허용 값은 relevance(기본값), 최신 게시일순인 newest, 좋아요가 가장 많은 순인 most_liked입니다. 이전 버전 호환용 별칭인 general(relevance로 매핑)과 latest(newest로 매핑)도 지원합니다.

허용 값:most_likednewestrelevance

Douyin profile 파라미터는 각각 무엇을 의미하나요?

secUid로 Douyin 계정을 조회합니다. 닉네임, 핸들, 소개, 팔로워·좋아요·동영상 수, IP 위치, 인증 및 상점 여부를 가져옵니다. user_id에는 닉네임이나 짧은 ID가 아닌 secUid(보통 MS4w로 시작)를 전달하세요. 동영상은 user_posts로 가져옵니다.

user_id필수

Douyin 사용자의 secUid 문자열로(보통 MS4w로 시작), 닉네임이나 짧은 숫자 형식의 Douyin ID가 아닙니다. profile과 user_posts 액션에서 계정을 식별하는 데 사용하며, 검색 결과의 author_id 필드나 사용자 프로필 URL에서 얻을 수 있습니다.

Douyin 오픈 플랫폼: Open ID와 Union ID — Douyin 오픈 플랫폼은 Open ID를 단일 앱 내 사용자 식별자로, Union ID를 개발자 계정 범위 전체에서 쓰이는 식별자로 정의합니다. 이 페이지의 user_id에는 위 안내에 따라 secUid를 넣어야 하며, 오픈 플랫폼 식별자를 동등한 입력값으로 보고 그대로 넣으면 안 됩니다. · 확인일 2026-09-04

Douyin user_posts 파라미터는 각각 무엇을 의미하나요?

Douyin 계정이 게시한 동영상을 최신순으로 추적합니다. 각 동영상에는 캡션, 해시태그, 길이, 참여 수치, 게시 시각이 포함됩니다. 첫 페이지는 page_token을 비워 두고 요청하세요. 각 next_page_token은 24시간 이내에 다시 전달해야 합니다. since로 가장 이른 게시일을 지정합니다.

user_id필수

Douyin 사용자의 secUid 문자열로(보통 MS4w로 시작), 닉네임이나 짧은 숫자 형식의 Douyin ID가 아닙니다. profile과 user_posts 액션에서 계정을 식별하는 데 사용하며, 검색 결과의 author_id 필드나 사용자 프로필 URL에서 얻을 수 있습니다.

Douyin 오픈 플랫폼: Open ID와 Union ID — Douyin 오픈 플랫폼은 Open ID를 단일 앱 내 사용자 식별자로, Union ID를 개발자 계정 범위 전체에서 쓰이는 식별자로 정의합니다. 이 페이지의 user_id에는 위 안내에 따라 secUid를 넣어야 하며, 오픈 플랫폼 식별자를 동등한 입력값으로 보고 그대로 넣으면 안 됩니다. · 확인일 2026-09-04

page_token선택

user_posts용 페이지 토큰입니다. 최신 페이지부터 시작하려면 빈 문자열 page_token=""을 보내고, 이후에는 다른 파라미터를 바꾸지 않은 채 각 응답의 next_page_token을 받은 그대로 전달합니다. 토큰은 24시간 동안 유효하며 같은 계정과 파라미터에서만 작동하고, 마지막 페이지에는 next_page_token이 없습니다. 페이지당 최대 100행이 최신순으로 담기며 since 하한은 적용되지 않습니다. 날짜 범위가 필요하면 직접 posted_at으로 필터링해야 합니다. 페이지마다 호출 1건입니다.

since선택

profile과 user_posts 액션에서 동영상 게시일의 하한을 YYYY-MM-DD 형식으로 지정합니다. 계정 생성일이 아니라 요청에서 가져온 동영상을 필터링합니다. 이 파라미터를 생략하면 날짜 필터가 적용되지 않습니다.

Douyin video 파라미터는 각각 무엇을 의미하나요?

동영상 링크로 Douyin 동영상 하나의 캡션, 해시태그, 길이, 참여 수치, 작성자 프로필, 배경 음악, 게시 시각을 가져옵니다. video_url의 재생 링크는 서명된 링크로 만료되므로, 보관해야 한다면 바로 다운로드하세요.

url필수

대상 Douyin 동영상의 전체 URL로, https://www.douyin.com/video/<video_id> 형식입니다. video에서는 동영상 상세 정보, comments에서는 댓글, comment_replies에서는 한 댓글의 답글(해당 댓글이 달린 동영상), transcript에서는 오디오 전사문을 가져옵니다. 사용자 프로필 URL이나 검색 페이지 URL은 전달하면 안 됩니다.

Douyin comments 파라미터는 각각 무엇을 의미하나요?

Douyin 동영상의 시청자 댓글을 가져옵니다. 좋아요 수, 답글 수, IP 지역, 인기 댓글 여부, 동영상 작성자의 좋아요 여부, 멘션, 이미지(있는 경우)가 포함됩니다. next_page_token을 page_token으로 다시 전달해 최상위 댓글의 페이지를 넘기세요.

url필수

대상 Douyin 동영상의 전체 URL로, https://www.douyin.com/video/<video_id> 형식입니다. video에서는 동영상 상세 정보, comments에서는 댓글, comment_replies에서는 한 댓글의 답글(해당 댓글이 달린 동영상), transcript에서는 오디오 전사문을 가져옵니다. 사용자 프로필 URL이나 검색 페이지 URL은 전달하면 안 됩니다.

page_token선택

user_posts와 comments용 페이지 토큰입니다. 페이지네이션을 시작하려면 빈 문자열 page_token=""을 보내고, 다음 페이지는 이전 응답의 next_page_token을 받은 그대로 다시 전달해 가져옵니다. 이때 다른 파라미터는 모두 그대로 유지해야 합니다. 토큰은 24시간 동안 유효하며 같은 계정과 같은 파라미터에서만 동작합니다. 만료되었거나 일치하지 않는 토큰은 422를 반환하므로 첫 페이지부터 다시 시작해야 합니다. 마지막 페이지의 응답에는 next_page_token이 없습니다(pagination.has_more는 false). user_posts의 각 페이지는 1회 호출이며 최신순으로 최대 100행을 담고, since로 필터링되지 않습니다(날짜 범위가 필요하면 posted_at으로 직접 필터링해야 합니다). comments 페이지는 최상위 댓글을 최대 50개 담으며 행 블록 단위로 과금됩니다. 20행마다 1회 호출로 계산되므로 50행짜리 페이지는 3회 호출로 계산되고(limit을 더 작게 지정하면 해당 행 수만큼 계산), 행 없이 반환된 블록은 과금되지 않습니다. page_token 없이 호출하면 한 번만 가져옵니다. user_posts는 최신 묶음을 반환하고(since 적용), comments는 답글을 포함해 목록 앞부분만 반환하며 마찬가지로 20행당 1회 호출로 계산됩니다. 기본값은 20행이고, limit을 아무리 높여도 최대 약 50~60행이며, 대개 next_page_token이 없습니다.

Douyin comment_replies 파라미터는 각각 무엇을 의미하나요?

Douyin 동영상의 최상위 댓글 하나에 달린 답글을 호출당 최대 100개까지, 20개씩 읽어 옵니다. 각 답글에는 텍스트, 좋아요 수, 답글 작성자, IP 지역, 동영상 작성자의 좋아요 여부가 포함되며, 다른 답글에 대한 답글이면 reply_to_reply_id와 reply_to_author_name도 포함됩니다. 동영상 링크와 comments에서 얻은 comment_id를 함께 전달하고, next_page_token으로 페이지를 넘기세요.

url필수

대상 Douyin 동영상의 전체 URL로, https://www.douyin.com/video/<video_id> 형식입니다. video에서는 동영상 상세 정보, comments에서는 댓글, comment_replies에서는 한 댓글의 답글(해당 댓글이 달린 동영상), transcript에서는 오디오 전사문을 가져옵니다. 사용자 프로필 URL이나 검색 페이지 URL은 전달하면 안 됩니다.

comment_id필수

답글을 가져올 최상위 댓글의 ID로, 숫자만 사용하며 comments 행의 id에서 가져옵니다. reply_count가 0보다 큰 댓글에만 답글이 있습니다. comment_replies에서 같은 동영상의 url과 함께 사용하며, 동영상 ID나 답글 ID가 아닙니다.

page_token선택

comment_replies용 페이지 토큰입니다. 첫 답글부터 시작하려면 빈 문자열 page_token=""을 보내고, 이후에는 다른 파라미터를 바꾸지 않은 채 각 응답의 next_page_token을 받은 그대로 전달합니다. 토큰은 24시간 동안 유효하며 같은 계정과 같은 파라미터에서만 작동합니다. 마지막 페이지의 응답에는 next_page_token이 없습니다. 페이지당 최대 20개 답글이 담기며 행 블록 단위로 과금됩니다. 20행마다 호출 1건으로 계산하며, 행 없이 반환된 블록은 과금되지 않습니다.

Douyin trending 파라미터는 각각 무엇을 의미하나요?

Douyin 인기 급상승 보드에서 인기 키워드를 확인합니다. 각 키워드에는 순위, 화제성 점수, 관련 동영상·게시글·라이브 방 수, 라벨, 최고 순위가 포함됩니다. boards로 보드를 선택하세요(기본값 hotspot). hot_value는 Douyin 자체 점수이므로 한 보드 안에서만 비교할 수 있습니다.

boards선택

trending 액션에서 조회할 인기 급상승 보드 유형으로, hotspot, seeding, entertainment, social, challenge 중에서 단일 문자열 또는 문자열 배열로 지정합니다. 생략하거나 빈 배열을 전달하면 기본값 hotspot이 적용됩니다.

허용 값:challengeentertainmenthotspotseedingsocial

Douyin transcript 파라미터는 각각 무엇을 의미하나요?

Douyin 동영상의 음성을 문장 단위 타임스탬프가 포함된 텍스트로 변환합니다. 제목, 게시 시각, 참여 수치, 작성자, 오디오 트랙 링크도 함께 가져옵니다. 모든 동영상에 인식 가능한 음성이 있는 것은 아니며, 텍스트는 번역되지 않습니다.

url필수

대상 Douyin 동영상의 전체 URL로, https://www.douyin.com/video/<video_id> 형식입니다. video에서는 동영상 상세 정보, comments에서는 댓글, comment_replies에서는 한 댓글의 답글(해당 댓글이 달린 동영상), transcript에서는 오디오 전사문을 가져옵니다. 사용자 프로필 URL이나 검색 페이지 URL은 전달하면 안 됩니다.

Douyin creator_search 파라미터는 각각 무엇을 의미하나요?

닉네임, 핸들, 문구로 Douyin 크리에이터 계정을 검색합니다. 팔로워 수, 성별, 인증 및 라이브 상태, 후속 호출에 쓸 secUid를 가져옵니다. follower_range와 user_type으로 범위를 좁힐 수 있습니다. 일치 결과는 후보일 뿐 신원이 확인된 것은 아닙니다.

keyword필수

계정 탐색에 사용할 크리에이터 닉네임, Douyin ID 또는 관련 검색어입니다. 동영상 search 액션을 실행하지 않으며, 정확히 일치하는 계정을 보장하지 않습니다.

follower_range선택

계정의 팔로워 수 구간으로 creator_search를 필터링합니다. under_1k, 1k_to_10k, 10k_to_100k, 100k_to_1m, over_1m 중 하나를 사용하며, 생략하면 구간을 제한하지 않습니다.

허용 값:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k

user_type선택

general, business, verified_individual 중 계정 유형으로 creator_search를 필터링합니다. 구매자 카테고리나 법적 신원 증명이 아닙니다.

허용 값:businessgeneralverified_individual

Douyin creator_audience 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터의 팔로워를 기기 가격대, 성별, 연령, 성(省)별로 나누어 각 구간의 비중과 TGI 지수를 제공합니다. 비중은 백분율이 아닌 0~1 사이의 소수이며, 구간은 구매자 기록이나 개인 단위 데이터가 아닙니다.

user_id필수

Douyin 크리에이터의 secUid로, 보통 MS4w로 시작하며 제공되는 오디언스 분포와 TGI 지표를 조회하는 데 사용합니다. 닉네임, 짧은 Douyin ID, 구매자 식별자가 아닌 크리에이터 탐색 결과의 user_id를 사용해야 합니다.

dimension선택

device_price_band(기본값), gender, age, province 중에서 creator_audience의 팔로워 세그먼트 기준을 선택합니다. 분포 값은 백분율이 아닌 0~1 사이의 원시 비율(소수)이며, TGI는 별도 지수입니다. 이 파라미터로 개별 팔로워 레코드나 구매자 데이터를 요청할 수는 없습니다.

허용 값:agedevice_price_bandgenderprovince

Douyin creator_trend 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터의 팔로워 수 변화를 날짜별 시계열로 추적하며, 해당 기간의 평균 팔로워 수도 제공합니다. user_id에 크리에이터의 secUid를 전달하세요. 시계열만으로는 증가 원인을 알 수 없습니다.

user_id필수

Douyin 크리에이터의 secUid로, 보통 MS4w로 시작하며 제공되는 팔로워 추이 시계열을 조회하는 데 사용합니다. 닉네임이나 짧은 숫자 Douyin ID가 아닙니다.

Douyin creator_benchmark 파라미터는 각각 무엇을 의미하나요?

평균 게시물 수, 좋아요, 댓글, 공유, 팔로워 증가를 기준으로 Douyin 크리에이터를 유사 계정과 비교하며, 각 항목에 백분위 순위가 함께 제공됩니다. 이는 계정 간 상대적 지표일 뿐 매출, 전환, 인과관계의 근거가 아닙니다.

user_id필수

Douyin 크리에이터의 secUid로, 보통 MS4w로 시작하며 제공되는 계정 평균값과 백분위수를 조회하는 데 사용합니다. 닉네임이나 짧은 숫자 Douyin ID가 아닙니다.

Douyin xingtu_creator_search 파라미터는 각각 무엇을 의미하나요?

키워드로 Douyin Xingtu 크리에이터 레코드를 검색합니다. 참여율, 예상 재생 수, 팔로워 증가, 커머스 점수, GMV 구간(정확한 GMV 아님), 가치 지수, 영상 길이별 CNY 견적가를 가져옵니다. creator_id는 이 행들을 비교하는 용도로만 쓰입니다. 분석 데이터와 단가표를 조회하려면 creator_search에서 받은 douyin_id가 필요합니다.

keyword필수

xingtu_creator_search용 크리에이터 검색어입니다. 반환되는 creator_id는 이 Xingtu 검색 결과 안에서 레코드를 식별하고 비교하는 데 쓰입니다. xingtu_creator_analytics와 xingtu_rate_card에서는 받지 않으며, 이 두 액션에는 일반 creator_search가 반환하는 douyin_id가 필요합니다. 상품 키워드나 동영상 검색이 아닙니다.

Douyin xingtu_creator_analytics 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터의 Xingtu 상업 프로필을 가져옵니다. 유형과 등급, 팔로워, 평균 재생 수, 콘텐츠 주제, 커머스 여부, 최저 CNY 견적이 포함됩니다. secUid나 Xingtu ID가 아니라 creator_search에서 얻은 표시용 douyin_id를 전달하세요. 최저 견적은 성사된 거래가가 아니라 제시 가격입니다.

douyin_id필수

일반 creator_search 액션이 반환하는, 화면에 표시되는 Douyin 계정 ID(unique_id)로, xingtu_creator_analytics와 xingtu_rate_card에서 필수입니다. xingtu_creator_search는 이 값을 반환하지 않습니다. user_id(secUid), Xingtu creator_id, 닉네임과는 다른 값입니다.

Douyin xingtu_rate_card 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터가 Xingtu에 게시한 단가 등급을 확인합니다. 각 등급에는 형식, 현재 견적가와 원래 견적가, 정산 안내, 영상 유형, 오픈 상태가 포함됩니다. creator_search에서 받은 douyin_id를 사용하세요. 게시된 단가일 뿐 합의된 거래나 최종 정산 금액이 아닙니다.

douyin_id필수

일반 creator_search 액션이 반환하는, 화면에 표시되는 Douyin 계정 ID(unique_id)로, xingtu_creator_analytics와 xingtu_rate_card에서 필수입니다. xingtu_creator_search는 이 값을 반환하지 않습니다. user_id(secUid), Xingtu creator_id, 닉네임과는 다른 값입니다.

Douyin xingtu_creator_rankings 파라미터는 각각 무엇을 의미하나요?

Douyin Xingtu 랭킹 보드에서 크리에이터를 최대 5명까지 가져옵니다. 업종, 보드 유형, 기간으로 보드를 선택합니다. 순위, 이전 순위, 점수, CPM, 주문 범위를 가져옵니다. 순위와 점수는 반환된 보드와 기간 안에서만 비교할 수 있습니다. 주문 및 재구매 범위는 정확한 합계가 아닙니다.

industry필수

apparel_accessories, automotive, beauty, electronics, food_beverage, household_goods, mother_baby_pets 중에서 Xingtu 크리에이터 랭킹의 업종을 선택합니다. 랭킹 보드 필터이며, 크리에이터가 직접 붙인 태그가 아닙니다.

허용 값:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets

ranking_type필수

all_top, head_tier, paid_ad_performers, rising_stars, sales_champions, top_creators, viral_drivers 중에서 Xingtu 랭킹 보드를 선택합니다. 보드 이름과 관계없이 순위는 예측이나 보장된 결과를 의미하지 않습니다.

허용 값:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers

time_window필수

latest_weekly, latest_monthly, all_history_weekly, all_history_monthly 중에서 Xingtu 랭킹 스냅샷을 선택합니다. 반환되는 순위표의 범위를 정하며, 임의의 날짜 범위는 받지 않습니다.

허용 값:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly

Douyin product_search 파라미터는 각각 무엇을 의미하나요?

키워드로 Douyin Mall 상품을 최대 5개까지 찾습니다. CNY 가격, 30일 판매량, 긍정 리뷰 비율, 상점, 수수료율, 협업 크리에이터 수를 가져옵니다. 협업 크리에이터 수는 특정 크리에이터가 해당 상품을 판매했다는 뜻이 아닙니다. 기본 소스를 사용할 수 없을 때는 백업 소스가 상품 ID, 제목, 링크, 이미지, CNY 가격, 상점 ID만 반환합니다. 이 경우 판매량, 리뷰 비율, 상점 이름, 카테고리, 수수료, 크리에이터 필드는 누락됩니다. 0.1위안 이하의 시작 가격은 제외됩니다.

keyword필수

Douyin 상품 검색어입니다. 결과는 독립된 상품 풀이며, 특정 크리에이터가 해당 상품을 홍보하거나 판매했다는 근거가 되지 않습니다.

Douyin product_detail 파라미터는 각각 무엇을 의미하나요?

숫자 ID로 Douyin Mall 상품 하나를 읽어 옵니다. 표시 가격과 할인 가격(CNY), 판매 수치, 상점, 이미지, 보장 서비스, 배송 안내, 옵션, 판매 상태를 가져옵니다. product_id는 SKU나 프로모션 ID가 아니라 product_search 또는 live_product_search에서 가져오세요.

product_id필수

product_search 또는 live_product_search가 반환하는 숫자 형식의 Douyin 상품 ID입니다. SKU ID, 프로모션 ID, 제목, URL이 아닙니다.

Douyin live_product_search 파라미터는 각각 무엇을 의미하나요?

키워드로 현재 Douyin 라이브 방송에서 판매 중인 상품을 최대 3개까지 찾습니다. SKU, 제목, CNY 가격, 상점, 라이브 방 ID를 가져옵니다. 라이브 방 ID는 이 검색에만 유효하며, 과거 라이브 판매 실적이 해당 방에 귀속된다는 의미는 아닙니다.

keyword필수

Douyin Mall 상품 검색어입니다. 요청 시점에 라이브 태그와 라이브 방 ID가 있는 상품만 반환됩니다. 결과는 특정 크리에이터가 라이브 방송에서 판매한 상품의 기록이 아닙니다.

Douyin hashtag_search 파라미터는 각각 무엇을 의미하나요?

이름에 keyword가 포함된 Douyin 해시태그를 화제성 순으로 찾습니다. 각 해시태그에는 숫자 ID, 화제성 지수, 중국 시간 기준으로 마감된 최근 7일 동안 모인 동영상 수·좋아요·조회수가 포함되며, 모든 행에 해당 기간의 날짜가 표시됩니다. 호출당 최대 200개, 기본 20개 해시태그를 반환합니다. 누적 합계는 hashtag_id를 hashtag_detail에 전달해 확인하세요.

keyword필수

Douyin 해시태그 이름에서 찾을 단어입니다(예: food). 중국어 검색어를 쓰면 보통 더 많은 해시태그가 일치합니다. 동영상이 아닌 해시태그를 찾습니다.

Douyin hashtag_detail 파라미터는 각각 무엇을 의미하나요?

hashtag_search에서 얻은 숫자 hashtag_id로 Douyin 해시태그 하나를 읽어 옵니다. 이름, 생성 이후 누적 조회수, 참여한 사용자 수, 생성 시각, 공유 링크를 가져옵니다. 합계는 특정 기간이 아닌 해시태그 전체에 대한 플랫폼 수치입니다.

hashtag_id필수

hashtag_detail에 사용할 Douyin 해시태그의 숫자 ID로(예: 1767586897793101), hashtag_search 행의 hashtag_id에서 가져옵니다. 해시태그 이름이나 #name을 전달하면 과금 전에 거부됩니다.

Douyin billboard_video_hot 파라미터는 각각 무엇을 의미하나요?

Douyin 자체 트렌드 도구인 Hot Spot Treasure의 동영상 보드를 읽어 옵니다. 최근 1시간, 1일, 3일, 7일 기준으로 종합 보드, 팔로워 증가 최고 보드, 좋아요율 최고 보드 중에서 선택할 수 있습니다. 각 작품에는 재생 수, 좋아요, 좋아요율, 팔로워 증가 수, 팔로워 증가율, 화제성 점수, 작성자 팔로워 수가 포함되며, 화제성이 높은 순으로 정렬됩니다. 페이지당 최대 50개입니다. Douyin이 일부 작품을 걸러내기 때문에 페이지가 더 짧게 반환되는 경우가 많으며, 짧은 페이지가 마지막 페이지라는 뜻은 아닙니다. 행에는 순위가 포함되지 않습니다.

board선택

billboard_video_hot에서 조회할 보드입니다. all(기본값)은 종합 보드, follower_growth는 재생 수 대비 팔로워가 가장 많이 늘어난 작품 보드, like_rate는 좋아요 비율이 가장 높은 작품 보드입니다.

허용 값:allfollower_growthlike_rate

keyword선택

선택: 이 단어와 관련된 작품만 남깁니다(예: food). 전체 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 작품이 담기며 페이지마다 호출 1건입니다. Douyin이 일부 작품을 걸러내므로 한 페이지에 50개보다 적게 담기는 경우가 많고, 페이지가 짧다고 해서 끝은 아닙니다. 토큰은 24시간 동안 유효하며, 마지막 페이지에는 next_page_token이 없습니다(랭킹당 최대 약 1,000개 작품).

time_window선택

집계 기간: 1h(최근 1시간), 1d(최근 24시간, 기본값), 3d 또는 7d입니다.

허용 값:1d1h3d7d

Douyin billboard_low_fan_explosion 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure의 저팔로워 히트 보드에서 작은 계정이 올려 크게 뜬 Douyin 작품을 찾습니다. 각 행에는 작성자의 팔로워 수와 함께 작품의 재생 수, 좋아요, 좋아요율, 신규 팔로워 수가 담겨 있어, 작은 계정의 작품이 얼마나 멀리 퍼졌는지 확인할 수 있습니다. 선택 파라미터인 keyword와 1시간부터 7일까지의 기간으로 범위를 좁힐 수 있습니다. 페이지당 최대 50개이며 페이지 크기가 일정하지 않으므로 next_page_token이 없어질 때까지 계속 페이지를 넘기세요.

keyword선택

선택: 이 단어와 관련된 작품만 남깁니다(예: food). 전체 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 작품이 담기며 페이지마다 호출 1건입니다. Douyin이 일부 작품을 걸러내므로 한 페이지에 50개보다 적게 담기는 경우가 많고, 페이지가 짧다고 해서 끝은 아닙니다. 토큰은 24시간 동안 유효하며, 마지막 페이지에는 next_page_token이 없습니다(랭킹당 최대 약 1,000개 작품).

time_window선택

집계 기간: 1h(최근 1시간), 1d(최근 24시간, 기본값), 3d 또는 7d입니다.

허용 값:1d1h3d7d

Douyin billboard_high_completion 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure의 높은 완주율 보드에서 시청자가 끝까지 보는 Douyin 작품을 확인합니다. 각 작품의 재생 시간, 재생 수, 좋아요, 좋아요율, 화제성 점수, 커버, 서명된 재생 링크를 가져오며, 완주율 자체는 반환되지 않습니다. 1시간부터 7일까지의 기간과 선택 파라미터인 keyword를 지정할 수 있습니다. 페이지당 최대 50개이며 그보다 적은 경우가 많고, next_page_token으로 페이지를 넘깁니다.

keyword선택

선택: 이 단어와 관련된 작품만 남깁니다(예: food). 전체 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 작품이 담기며 페이지마다 호출 1건입니다. Douyin이 일부 작품을 걸러내므로 한 페이지에 50개보다 적게 담기는 경우가 많고, 페이지가 짧다고 해서 끝은 아닙니다. 토큰은 24시간 동안 유효하며, 마지막 페이지에는 next_page_token이 없습니다(랭킹당 최대 약 1,000개 작품).

time_window선택

집계 기간: 1h(최근 1시간), 1d(최근 24시간, 기본값), 3d 또는 7d입니다.

허용 값:1d1h3d7d

Douyin billboard_search_hot 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure의 검색 보드에서 Douyin에서 떠오르는 검색어를 찾습니다. 각 검색어에는 순위, 선택한 기간의 검색 화제성, 최대 14일간의 일별 화제성 추이가 포함됩니다. 필요하면 keyword가 포함된 검색어만 필터링할 수 있습니다. 페이지당 50개 검색어이며 next_page_token으로 다음 페이지를 가져옵니다. 화제성은 검색 횟수가 아니라 Douyin 자체 점수입니다.

keyword선택

선택: 이 단어가 포함된 검색어만 남깁니다(예: food). 전체 검색 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지(상위 50개 검색어)에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 검색어가 담기며 페이지마다 호출 1건입니다. 토큰은 24시간 동안 유효하고, 마지막 페이지에는 next_page_token이 없습니다.

time_window선택

검색 인기도 집계 기간: 1h, 1d(기본값), 3d 또는 7d입니다.

허용 값:1d1h3d7d

Douyin billboard_account_search 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure를 통해 keyword와 관련된 Douyin 계정을 찾고, 각 계정의 팔로워 수, 좋아요 수, 동영상 수를 가져옵니다. 반환되는 user_id는 profile과 user_posts에서 받는 secUid입니다. 페이지당 약 30개 계정이 반환되며 몇 개 적을 때도 있습니다. next_page_token으로 다음 페이지를 가져오세요. 결과는 순위가 아니라 관련 계정입니다.

keyword필수

관련 Douyin 계정을 찾을 단어입니다(예: food). 각 계정은 팔로워 수, 좋아요 수, 동영상 수와 함께 반환됩니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 30개 계정이 담기며, 마지막 페이지가 아니어도 한두 개 적을 수 있습니다. 페이지마다 호출 1건입니다. 토큰은 24시간 동안 유효하고, 마지막 페이지에는 next_page_token이 없습니다.

Douyin music_search 파라미터는 각각 무엇을 의미하나요?

곡 제목, 아티스트, 사운드 이름으로 Douyin 음원 라이브러리를 검색합니다. 각 음원에는 제목, 아티스트, 길이, 해당 음원을 사용한 작품 수, 커버, 재생 링크, 가사 링크(있는 경우), 태그가 포함됩니다. 페이지당 10개이며 next_page_token으로 다음 페이지를 가져옵니다. Douyin에 있는 음원이라고 해서 상업적 사용이 허용되는 것은 아닙니다.

keyword필수

곡 제목, 아티스트 또는 사운드 이름입니다(예: Jay Chou). 동영상이 아닌 Douyin 음악 라이브러리를 검색합니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 10곡이 담기며 페이지마다 호출 1건입니다. 토큰은 24시간 동안 유효하고, 마지막 페이지에는 next_page_token이 없습니다.

Douyin search_suggest 파라미터는 각각 무엇을 의미하나요?

Douyin 검색창이 keyword에 대해 보여 주는 자동완성 제안을 Douyin의 순서대로 가져오며, rank는 1부터 시작합니다. 호출당 최대 10개이고 Douyin은 보통 5개 정도를 제공하며, 페이지네이션은 없습니다. 제안에는 검색량이 포함되지 않습니다.

keyword필수

Douyin 검색창에 입력한 텍스트입니다(예: artificial intelligence). 추천 검색어는 Douyin이 정한 순서대로 반환됩니다.

Douyin billboard_rise_list 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure의 급상승 보드에서 Douyin에서 가장 빠르게 오르는 트렌드를 찾습니다. 각 트렌드에는 순위와 상승 폭, 제목, ID, 화제성, 관련 동영상 수, 카테고리, 생성 시각, 시간별 화제성 곡선이 포함됩니다. 필요하면 keyword가 포함된 트렌드만 남길 수 있습니다. 페이지당 50개이며 next_page_token으로 다음 페이지를 가져옵니다.

keyword선택

선택: 이 단어가 포함된 트렌드만 남깁니다(예: game). 전체 급상승 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지(상위 50개 트렌드)에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 트렌드가 담기며 페이지마다 호출 1건입니다. 토큰은 24시간 동안 유효하고, 마지막 페이지에는 next_page_token이 없습니다.

Douyin billboard_challenge_hot 파라미터는 각각 무엇을 의미하나요?

Douyin 자체 트렌드 도구인 Hot Spot Treasure의 챌린지 보드를 읽어 옵니다. 호출 한 번으로 보드 전체인 트렌드 50개를 가져옵니다. 각 트렌드에는 순위, 제목, ID, 화제성, 관련 동영상 수, 생성 시각, 약 10분 간격으로 샘플링한 화제성 곡선이 포함됩니다. limit으로는 개수를 줄이는 것만 가능하며, 페이지네이션은 없습니다.

이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.

Douyin billboard_topic_hot 파라미터는 각각 무엇을 의미하나요?

Hot Spot Treasure의 해시태그 보드에서 최근 1시간, 1일, 3일, 7일 동안 화제성이 오르는 Douyin 해시태그를 확인합니다. 각 해시태그에는 순위, hashtag_detail에 쓰는 숫자 ID, 이름, 화제성, 누적 조회수와 작품 수, 작품당 평균 조회수, 커버, 최대 14일간의 일별 화제성이 포함됩니다. 페이지당 50개이며 next_page_token으로 다음 페이지를 가져옵니다.

keyword선택

선택: 이름에 이 단어가 포함된 해시태그만 남깁니다(예: food). 전체 해시태그 랭킹을 보려면 생략합니다.

page_token선택

페이지 토큰입니다. 첫 페이지(상위 50개 해시태그)에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 50개 해시태그가 담기며 페이지마다 호출 1건입니다. 토큰은 24시간 동안 유효하고, 마지막 페이지에는 next_page_token이 없습니다(랭킹당 최대 약 1,000개 해시태그).

time_window선택

해시태그 인기도 집계 기간: 1h, 1d(기본값), 3d 또는 7d입니다.

허용 값:1d1h3d7d

Douyin music_detail 파라미터는 각각 무엇을 의미하나요?

music_search에서 얻은 숫자 music_id나 douyin.com/music 링크로 Douyin 음원 하나를 읽어 옵니다. 제목, 아티스트, 길이, 해당 음원을 사용한 작품 수, 커버, 재생 링크, 가사 링크(있는 경우)를 가져옵니다. 곡 제목으로 조회하려면 music_search를 사용하세요.

music_id필수

숫자 형식의 Douyin 음악 ID로(예: 7699717253151558410), music_search 행의 id에서 가져옵니다. douyin.com/music/<ID> 링크도 사용할 수 있습니다.

Douyin xingtu_conversion_ability 파라미터는 각각 무엇을 의미하나요?

Xingtu가 Douyin 크리에이터 한 명의 Xingtu 주문 동영상에 대해 최근 7일, 30일, 90일 기준으로 보여 주는 전환 수치를 읽어 옵니다. 관련 동영상 수, 재생 수 중앙값, 컴포넌트 클릭 수와 클릭률, CPC, GPM, 평균 판매량, 홍보 상품 수와 카테고리가 포함됩니다. 대부분의 값은 500-1000처럼 Xingtu 고유 표기의 범위이며, "10% 이상"처럼 한쪽이 열린 값은 중국어로 표시됩니다. 해당 기간에 Xingtu 주문이 있는 크리에이터만 수치가 있으며, 나머지는 빈 결과를 반환하고 과금되지 않습니다.

douyin_id필수

크리에이터의 공개 Douyin ID(creator_search에서 얻는 unique_id) 또는 xingtu_creator_search가 반환하는 19자리 Xingtu creator_id입니다. Xingtu에 없는 크리에이터는 빈 결과를 반환하며, 이 경우 과금되지 않습니다.

time_window선택

Xingtu 수치의 집계 기간: 오늘부터 거슬러 계산한 7d, 30d(기본값) 또는 90d입니다. xingtu_creator_rankings의 랭킹 기간과는 다릅니다.

허용 값:30d7d90d

Douyin xingtu_link_structure 파라미터는 각각 무엇을 의미하나요?

Xingtu가 Douyin 크리에이터 한 명과 연결된 것으로 집계한 사용자 수를 Xingtu의 4단계로 나누어 확인합니다. 단계마다 사용자 수, 전체 대비 비중, 같은 업종 크리에이터의 중앙값이 포함됩니다. 전체 합계, Xingtu 크리에이터 중 순위(total_rank_top_percent, 0~1, 작을수록 좋음), 시딩형 또는 확산형을 뜻하는 Xingtu의 연결 유형 라벨(중국어)도 가져옵니다.

douyin_id필수

크리에이터의 공개 Douyin ID(creator_search에서 얻는 unique_id) 또는 xingtu_creator_search가 반환하는 19자리 Xingtu creator_id입니다. Xingtu에 없는 크리에이터는 빈 결과를 반환하며, 이 경우 과금되지 않습니다.

Douyin xingtu_recommended_videos 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터의 Xingtu 페이지에 있는 네 가지 동영상 그룹(대표 동영상, 최신 동영상, 인기 Xingtu 주문 동영상, 인기 개인 동영상)을 나열합니다. 각 동영상에는 ID, 링크, 재생 수, 게시 시각만 포함됩니다. 동영상이 없는 그룹은 제외됩니다.

douyin_id필수

크리에이터의 공개 Douyin ID(creator_search에서 얻는 unique_id) 또는 xingtu_creator_search가 반환하는 19자리 Xingtu creator_id입니다. Xingtu에 없는 크리에이터는 빈 결과를 반환하며, 이 경우 과금되지 않습니다.

Douyin xingtu_touch_distribution 파라미터는 각각 무엇을 의미하나요?

Xingtu 집계 기준으로 Douyin 크리에이터의 연결 사용자가 어떤 콘텐츠 카테고리에서 유입되었는지 확인합니다. 최대 3단계 트리로 제공되며, 보통 개인 콘텐츠와 Xingtu 콘텐츠로 나뉜 뒤 카테고리와 하위 카테고리로 이어지고, 각 단계에 사용자 수가 포함됩니다.

douyin_id필수

크리에이터의 공개 Douyin ID(creator_search에서 얻는 unique_id) 또는 xingtu_creator_search가 반환하는 19자리 Xingtu creator_id입니다. Xingtu에 없는 크리에이터는 빈 결과를 반환하며, 이 경우 과금되지 않습니다.

Douyin xingtu_video_performance 파라미터는 각각 무엇을 의미하나요?

Douyin 크리에이터의 개인 동영상과 Xingtu 주문 동영상을 참여율, 재생 수 중앙값, 완주율로 비교합니다. 각 지표에는 크리에이터의 값, 플랫폼 전체 평균, 백분위(해당 크리에이터가 앞서는 크리에이터의 비율, 0~1)가 포함됩니다. 최신 개인 동영상과 Xingtu 주문 동영상도 각각 최대 15개 정도 가져오며, 제목, 재생 수, 좋아요, 댓글, 공유, 재생 시간이 포함됩니다.

douyin_id필수

크리에이터의 공개 Douyin ID(creator_search에서 얻는 unique_id) 또는 xingtu_creator_search가 반환하는 19자리 Xingtu creator_id입니다. Xingtu에 없는 크리에이터는 빈 결과를 반환하며, 이 경우 과금되지 않습니다.