Douyin API
Search Douyin videos and creator profiles, or retrieve transcripts, trending boards, analytics, and ecommerce listings.
Use the creator identifier returned in video records for account lookups. Product search, detail, and current live discovery are separate from creator sales history; transcripts, rankings, and commerce signals describe different information.
Platform availability
- 24h health
- 96%
Last 30 days
Available capabilities
Each Douyin action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Find Douyin videos for a search term, with caption, hashtags, likes, comments, shares, saves, author details and a signed play link. | $0.56 per 1,000 requests | Healthy · health 98% |
Profilesprofile | Look up a Douyin account by secUid for its nickname, handle, bio, follower, like and video counts, IP location, verification and shop status. | $0.56 per 1,000 requests | Normal |
Posts by useruser_posts | Track the videos a Douyin account publishes, newest first, with caption, hashtags, length, engagement counts and publish time. | $0.56 per 1,000 requests | Normal |
Video detailsvideo | Fetch one Douyin video's caption, hashtags, length, engagement counts, author profile, background music and publish time from its video link. | $0.56 per 1,000 requests | Healthy · health 98% |
Commentscomments | Pull viewer comments on a Douyin video, with likes, reply count, IP region, hot-comment and author-liked flags, mentions and any images. | $0.56 per 1,000 requestsEvery 20 rows count as one call | Normal |
Trendingtrending | Check Douyin's trending boards for hot keywords, each with rank, heat score, related video, article and live-room counts, label and peak rank. | $0.56 per 1,000 requests | Healthy · health 100% |
Transcripttranscript | Turn a Douyin video's speech into text with sentence-level timestamps, plus its title, publish time, engagement counts, author and an audio track link. | $0.56 per 1,000 requests | Normal |
Creator searchcreator_search | Search Douyin creator accounts by nickname, handle or phrase, with follower count, gender, verification and live status, plus the secUid for follow-up calls. | $0.56 per 1,000 requests | Normal |
Creator audiencecreator_audience | Break down a Douyin creator's followers by device price band, gender, age or province, with each bucket's share and its TGI index. | $0.56 per 1,000 requests | Normal |
Creator growth trendcreator_trend | Track a Douyin creator's follower count over time as a dated series, with the average follower count across the window. | $0.56 per 1,000 requests | Normal |
Creator benchmarkcreator_benchmark | Compare a Douyin creator with similar accounts through average posts, likes, comments, shares and follower growth, each with a percentile rank. | $0.56 per 1,000 requests | Normal |
Xingtu creator searchxingtu_creator_search | Search Douyin's Xingtu creator records by keyword for engagement rate, expected plays, follower growth, commerce score, GMV ranges (not exact GMV), value indices and CNY quotes by video length. | $0.56 per 1,000 requests | Normal |
Xingtu creator analyticsxingtu_creator_analytics | Get a creator's Xingtu commercial profile on Douyin, including type and grade, followers, average plays, content themes, commerce flag and lowest CNY quote. | $0.56 per 1,000 requests | Normal |
Xingtu creator rate cardxingtu_rate_card | See the rate tiers a Douyin creator lists on Xingtu, each with format, current and original quote, settlement note, video type and open status. | $0.56 per 1,000 requests | Normal |
Xingtu creator rankingsxingtu_creator_rankings | Pull up to five creators from a Douyin Xingtu ranking board, chosen by industry, board type and time window, with rank, previous rank, score, CPM and order ranges. | $0.56 per 1,000 requests | Normal |
Product searchproduct_search | Find up to five Douyin Mall products for a keyword, with CNY price, 30-day sales, positive review rate, shop, commission rate and number of partnering creators. | $0.56 per 1,000 requests | Normal |
Product detailsproduct_detail | Read one Douyin Mall product by numeric ID for displayed and discount price in CNY, sales figure, shop, images, assurances, shipping notes, variants and on-sale status. | $0.56 per 1,000 requests | Healthy · health 91% |
Live product searchlive_product_search | Find up to three Douyin products currently sold in live streams for a keyword, with SKU, title, CNY price, shop and live room ID. | $0.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Douyin action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Find Douyin videos for a search term, with caption, hashtags, likes, comments, shares, saves, author details and a signed play link. Douyin does not publish play counts, so | keyword | publish_time, sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
profileProfiles Look up a Douyin account by secUid for its nickname, handle, bio, follower, like and video counts, IP location, verification and shop status. Pass the secUid (often starting MS4w) in | user_id | — | Sync delivery | — | $0.56 per 1,000 requests | user_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · uid · background_image_url · country · language · is_live · likes_given_count · has_shop · platform · verify_reason |
user_postsPosts by user Track the videos a Douyin account publishes, newest first, with caption, hashtags, length, engagement counts and publish time. Start paging with an empty | user_id | page_token, since | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. For the next page, pass next_page_token back as page_token with the other parameters unchanged; each page is one call. | $0.56 per 1,000 requests | next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
videoVideo details Fetch one Douyin video's caption, hashtags, length, engagement counts, author profile, background music and publish time from its video link. The play link in | url | — | Sync delivery | — | $0.56 per 1,000 requests | id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
commentsComments Pull viewer comments on a Douyin video, with likes, reply count, IP region, hot-comment and author-liked flags, mentions and any images. Pass back | url | page_token | Sync delivery | Catalog values: defaultLimit=20, maxLimit=150. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. For the next page, pass next_page_token back as page_token with the other parameters unchanged; each page is one call. | $0.56 per 1,000 requestsEvery 20 rows count as one call | next_page_token · id · text · like_count · reply_count · author_name · author_id · ip_location · is_hot · is_reply · reply_to_id · posted_at · video_id · platform · liked_by_author · author_avatar_url · author_uid · images · mentioned_users |
trendingTrending Check Douyin's trending boards for hot keywords, each with rank, heat score, related video, article and live-room counts, label and peak rank. Choose boards with | boards | Sync delivery | Catalog values: defaultLimit=20, maxLimit=60. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | rank · keyword · hot_value · video_count · board · image_url · event_time · sentence_id · group_id · label · word_type · article_count · is_pinned · max_rank · live_room_count · platform | |
transcriptTranscript Turn a Douyin video's speech into text with sentence-level timestamps, plus its title, publish time, engagement counts, author and an audio track link. Not every video has recognizable speech, and the text is not translated. | url | — | Sync delivery | — | $0.56 per 1,000 requests | id · url · title · text · posted_at · play_count · like_count · comment_count · share_count · collect_count · author_name · author_avatar · author_follower_count · segments · video_url · audio_url · duration_sec · duration_seconds · recommend_count · author_like_count · platform |
creator_searchCreator search Search Douyin creator accounts by nickname, handle or phrase, with follower count, gender, verification and live status, plus the secUid for follow-up calls. Narrow with | keyword | follower_range, user_type | Sync delivery | Catalog values: defaultLimit=20, maxLimit=20. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | user_id · douyin_id · nickname · url · avatar_url · follower_count · gender · is_verified · verify_reason · is_live · uid · source_keyword · platform |
creator_audienceCreator audience Break down a Douyin creator's followers by device price band, gender, age or province, with each bucket's share and its TGI index. Shares are decimals between 0 and 1, not percentages, and the buckets are not buyer records or individual people. | user_id | dimension | Sync delivery | — | $0.56 per 1,000 requests | user_id · audience_distribution · audience_tgi · dimension_code · platform |
creator_trendCreator growth trend Track a Douyin creator's follower count over time as a dated series, with the average follower count across the window. Pass the creator's secUid in | user_id | — | Sync delivery | — | $0.56 per 1,000 requests | user_id · follower_trend · average_follower_count · dimension_code · platform |
creator_benchmarkCreator benchmark Compare a Douyin creator with similar accounts through average posts, likes, comments, shares and follower growth, each with a percentile rank. These are relative account signals, not sales, conversions or proof of cause. | user_id | — | Sync delivery | — | $0.56 per 1,000 requests | user_id · average_post_count · average_comment_count · average_share_count · average_follower_growth · average_like_count · post_count_percentile · comment_count_percentile · share_count_percentile · follower_growth_percentile · like_count_percentile · platform |
xingtu_creator_searchXingtu creator search Search Douyin's Xingtu creator records by keyword for engagement rate, expected plays, follower growth, commerce score, GMV ranges (not exact GMV), value indices and CNY quotes by video length. | keyword | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=20. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | creator_id · user_id · nickname · follower_count · gender · city · province · creator_score · engagement_rate_30d · expected_play_count · expected_natural_play_count · interaction_median_30d · play_over_rate_30d · follower_growth_30d · follower_growth_rate_15d · content_themes · ecommerce_level · ecommerce_score · gmv_30d_range · gpm_30d_range · average_order_value_30d_range · commercial_index · conversion_index · spread_index · shopping_index · quote_1_20s_cny · quote_20_60s_cny · quote_60s_plus_cny · platform |
xingtu_creator_analyticsXingtu creator analytics Get a creator's Xingtu commercial profile on Douyin, including type and grade, followers, average plays, content themes, commerce flag and lowest CNY quote. Pass the visible | douyin_id | — | Sync delivery | — | $0.56 per 1,000 requests | creator_id · creator_type · follower_count · average_play_count · city · province · gender · category_id · content_themes · tags · creator_grade · is_xingtu_creator · ecommerce_enabled · lowest_quote_cny · platform |
xingtu_rate_cardXingtu creator rate card See the rate tiers a Douyin creator lists on Xingtu, each with format, current and original quote, settlement note, video type and open status. Use the | douyin_id | — | Sync delivery | — | $0.56 per 1,000 requests | creator_id · rate_tiers · platform |
xingtu_creator_rankingsXingtu creator rankings Pull up to five creators from a Douyin Xingtu ranking board, chosen by industry, board type and time window, with rank, previous rank, score, CPM and order ranges. Ranks and scores compare only within the returned board and window, and order and repurchase ranges are not exact totals. | industry, ranking_type, time_window | — | Sync delivery | Catalog values: defaultLimit=5, maxLimit=5. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | creator_id · user_id · url · nickname · avatar_url · gender · city · province · follower_count · cpm_cny · completed_order_range · repurchase_rate_range · item_order_rate · average_view_count · industry · rank · previous_rank · ranking_score · is_new · ranking_board · period_days · snapshot_date · source_kind · platform |
product_searchProduct search Find up to five Douyin Mall products for a keyword, with CNY price, 30-day sales, positive review rate, shop, commission rate and number of partnering creators. The partnering creator count does not show that any particular creator sold the item. | keyword | — | Sync delivery | Catalog values: defaultLimit=5, maxLimit=5. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | product_id · promotion_id · title · url · image_url · white_image_url · price_cny · price_cny_minor · price_label · monthly_sales · good_review_ratio · sales_trend · category_path · category_ids · category_depth · shop_id · shop_name · shop_logo_url · shop_score · commission_rate_percent · commission_cny · cooperating_creator_count · tags · source_keyword · search_rank · recommend_reason · platform |
product_detailProduct details Read one Douyin Mall product by numeric ID for displayed and discount price in CNY, sales figure, shop, images, assurances, shipping notes, variants and on-sale status. Take | product_id | — | Sync delivery | — | $0.56 per 1,000 requests | product_id · title · price_cny · discount_price_cny · sales_text · sold_count · shop_id · shop_name · shop_avatar_url · image_url · main_image_urls · detail_image_urls · assurances · shipping_fee_text · shipping_estimate_text · variant_groups · on_sale · platform |
live_product_searchLive product search Find up to three Douyin products currently sold in live streams for a keyword, with SKU, title, CNY price, shop and live room ID. The room ID reflects this search only and does not attribute past live sales. | keyword | — | Sync delivery | Catalog values: defaultLimit=3, maxLimit=3. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | product_id · sku_id · title · image_url · price_cny · shop_id · live_room_id · is_live_product · source_keyword · platform |
What do the Douyin search parameters mean?
Find Douyin videos for a search term, with caption, hashtags, likes, comments, shares, saves, author details and a signed play link. Douyin does not publish play counts, so view_count is usually absent or 0 and never real plays; judge reach by likes, comments and shares.
keywordRequired- Search term for the video search action, passed as a string, for example
latte art. It finds videos; it is not an account nickname or a video ID. publish_timeOptional- Filters video search results by publishing time window. Allowed values are
unlimited(default),one_day(last 24 hours),one_week(last 7 days), andhalf_year(last 6 months).Allowed values:half_yearone_dayone_weekunlimited sortOptional- Sorts video search results. Allowed values are
relevance(default),newestfor the latest publish date, andmost_likedfor highest likes. Supports legacy compatibility aliasesgeneral(mapped torelevance) andlatest(mapped tonewest).Allowed values:most_likednewestrelevance
What do the Douyin profile parameters mean?
Look up a Douyin account by secUid for its nickname, handle, bio, follower, like and video counts, IP location, verification and shop status. Pass the secUid (often starting MS4w) in user_id, not a nickname or short ID; videos come from user_posts.
user_idRequired- The Douyin user's
secUidstring (typically starting withMS4w), not a nickname or short numerical Douyin ID. Used to identify accounts forprofileanduser_postsactions; can be obtained from anauthor_idfield in search results or a user profile URL.Douyin Open Platform: Open ID and Union ID — Douyin Open Platform defines Open ID as the user identifier within a single app, whereas Union ID operates across the developer account scope. For this page, user_id expects a secUid per the instructions above; do not supply Open Platform identifiers directly as equivalent inputs. · Checked
What do the Douyin user_posts parameters mean?
Track the videos a Douyin account publishes, newest first, with caption, hashtags, length, engagement counts and publish time. Start paging with an empty page_token and pass back each next_page_token within 24 hours; since sets an earliest publish date.
user_idRequired- The Douyin user's
secUidstring (typically starting withMS4w), not a nickname or short numerical Douyin ID. Used to identify accounts forprofileanduser_postsactions; can be obtained from anauthor_idfield in search results or a user profile URL.Douyin Open Platform: Open ID and Union ID — Douyin Open Platform defines Open ID as the user identifier within a single app, whereas Union ID operates across the developer account scope. For this page, user_id expects a secUid per the instructions above; do not supply Open Platform identifiers directly as equivalent inputs. · Checked page_tokenOptional- Page token for
user_posts: send an empty stringpage_token=""to start from the newest page, then pass back each response'snext_page_tokenexactly as received, keeping the other parameters unchanged. Tokens last 24 hours and only work for the same account and parameters; the last page has nonext_page_token. Pages hold up to 100 rows, newest first, and skip thesincelower bound; filter byposted_aton your side if you need a date window. Each page is one call. sinceOptional- Sets a lower bound for video publish dates in
profileanduser_postsactions using theYYYY-MM-DDformat. Filters videos retrieved for the request rather than account creation date. Omitting this parameter removes the date filter.
What do the Douyin video parameters mean?
Fetch one Douyin video's caption, hashtags, length, engagement counts, author profile, background music and publish time from its video link. The play link in video_url is signed and expires, so download promptly if you need to keep it.
urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs.
What do the Douyin comments parameters mean?
Pull viewer comments on a Douyin video, with likes, reply count, IP region, hot-comment and author-liked flags, mentions and any images. Pass back next_page_token as page_token to page through the top-level comments.
urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs. page_tokenOptional- Page token for
user_postsandcomments. To start paging, send an empty stringpage_token=""; then pass back the previous response'snext_page_tokenexactly as received to get the next page, keeping every other parameter unchanged. Tokens last 24 hours and only work for the same account and the same parameters; an expired or mismatched token returns 422, so start again from the first page. On the last page the response has nonext_page_token(pagination.has_moreis false). Eachuser_postspage is one call and holds up to 100 rows, newest first, and is not filtered bysince(filter byposted_aton your side if you need a date window).commentspages hold up to 50 top-level comments and are priced per block of rows: every 20 rows count as one call, so a page counts as 3 calls for its 50 rows (a smallerlimitcounts that many rows), and blocks that come back with no rows are not charged. Withoutpage_tokenthe call is a single fetch:user_postsreturns the newest batch (sinceapplies) andcommentsreturns only the head of the list, replies included, also at one call per 20 rows: 20 rows by default and at most about 50-60 however highlimitis, usually with nonext_page_token.
What do the Douyin trending parameters mean?
Check Douyin's trending boards for hot keywords, each with rank, heat score, related video, article and live-room counts, label and peak rank. Choose boards with boards (default hotspot); hot_value is Douyin's own score and only comparable within a board.
boardsOptional- Specifies trending board types to query in the
trendingaction, passed as a single string or an array of strings:hotspot,seeding,entertainment,social, andchallenge. Defaults tohotspotif omitted or passed as an empty array.Allowed values:challengeentertainmenthotspotseedingsocial
What do the Douyin transcript parameters mean?
Turn a Douyin video's speech into text with sentence-level timestamps, plus its title, publish time, engagement counts, author and an audio track link. Not every video has recognizable speech, and the text is not translated.
Full API reference: parameters, code samples, response example and health →urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs.
What do the Douyin creator_search parameters mean?
Search Douyin creator accounts by nickname, handle or phrase, with follower count, gender, verification and live status, plus the secUid for follow-up calls. Narrow with follower_range and user_type; matches are candidates, not a confirmed identity.
keywordRequired- A creator nickname, Douyin ID, or related search phrase used for account discovery. It does not run the video
searchaction or guarantee an exact identity match. follower_rangeOptional- Filters
creator_searchby an account's follower-count band. Useunder_1k,1k_to_10k,10k_to_100k,100k_to_1m, orover_1m; omit it to leave the band unrestricted.Allowed values:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k user_typeOptional- Filters
creator_searchby account category:general,business, orverified_individual. It is not a buyer category or proof of legal identity.Allowed values:businessgeneralverified_individual
What do the Douyin creator_audience parameters mean?
Break down a Douyin creator's followers by device price band, gender, age or province, with each bucket's share and its TGI index. Shares are decimals between 0 and 1, not percentages, and the buckets are not buyer records or individual people.
Full API reference: parameters, code samples, response example and health →user_idRequired- The Douyin creator's
secUid, usually beginning withMS4w, used to read the available audience distribution and TGI signals. Useuser_idfrom creator discovery, not a nickname, short Douyin ID, or buyer identifier. dimensionOptional- Selects the
creator_audiencefollower-segment view:device_price_band(default),gender,age, orprovince. Distribution values are raw share decimals from 0 to 1, not percentages; TGI remains a separate index. This parameter does not request individual follower records or buyer data.Allowed values:agedevice_price_bandgenderprovince
What do the Douyin creator_trend parameters mean?
Track a Douyin creator's follower count over time as a dated series, with the average follower count across the window. Pass the creator's secUid in user_id; the series alone does not show what caused any growth.
user_idRequired- The Douyin creator's
secUid, usually beginning withMS4w, used to read the available follower-trend series. It is not a nickname or short numerical Douyin ID.
What do the Douyin creator_benchmark parameters mean?
Compare a Douyin creator with similar accounts through average posts, likes, comments, shares and follower growth, each with a percentile rank. These are relative account signals, not sales, conversions or proof of cause.
Full API reference: parameters, code samples, response example and health →user_idRequired- The Douyin creator's
secUid, usually beginning withMS4w, used to read the available account averages and percentiles. It is not a nickname or short numerical Douyin ID.
What do the Douyin xingtu_creator_search parameters mean?
Search Douyin's Xingtu creator records by keyword for engagement rate, expected plays, follower growth, commerce score, GMV ranges (not exact GMV), value indices and CNY quotes by video length. creator_id is only for comparing these rows; analytics and rate cards need the douyin_id from creator_search.
keywordRequired- A creator search phrase for
xingtu_creator_search. The returnedcreator_ididentifies and compares records within this Xingtu search result; it is not accepted byxingtu_creator_analyticsorxingtu_rate_card, which require thedouyin_idreturned by ordinarycreator_search. It is not a product keyword or video search.
What do the Douyin xingtu_creator_analytics parameters mean?
Get a creator's Xingtu commercial profile on Douyin, including type and grade, followers, average plays, content themes, commerce flag and lowest CNY quote. Pass the visible douyin_id returned by creator_search, not a secUid or Xingtu ID; the lowest quote is an asking price, not a closed deal.
douyin_idRequired- The visible Douyin account ID (
unique_id) returned by the ordinarycreator_searchaction and required byxingtu_creator_analyticsandxingtu_rate_card;xingtu_creator_searchdoes not return it. It is distinct from auser_id(secUid), Xingtucreator_id, and nickname.
What do the Douyin xingtu_rate_card parameters mean?
See the rate tiers a Douyin creator lists on Xingtu, each with format, current and original quote, settlement note, video type and open status. Use the douyin_id from creator_search; these are posted rates, not an accepted contract or final settlement.
douyin_idRequired- The visible Douyin account ID (
unique_id) returned by the ordinarycreator_searchaction and required byxingtu_creator_analyticsandxingtu_rate_card;xingtu_creator_searchdoes not return it. It is distinct from auser_id(secUid), Xingtucreator_id, and nickname.
What do the Douyin xingtu_creator_rankings parameters mean?
Pull up to five creators from a Douyin Xingtu ranking board, chosen by industry, board type and time window, with rank, previous rank, score, CPM and order ranges. Ranks and scores compare only within the returned board and window, and order and repurchase ranges are not exact totals.
Full API reference: parameters, code samples, response example and health →industryRequired- Selects the Xingtu creator-ranking industry:
apparel_accessories,automotive,beauty,electronics,food_beverage,household_goods, ormother_baby_pets. It is a board filter, not a creator-authored tag.Allowed values:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets ranking_typeRequired- Selects the Xingtu ranking board:
all_top,head_tier,paid_ad_performers,rising_stars,sales_champions,top_creators, orviral_drivers. Board names do not turn rank into a forecast or guaranteed outcome.Allowed values:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers time_windowRequired- Selects the Xingtu ranking snapshot:
latest_weekly,latest_monthly,all_history_weekly, orall_history_monthly. This scopes the returned leaderboard and does not accept an arbitrary date range.Allowed values:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly
What do the Douyin product_search parameters mean?
Find up to five Douyin Mall products for a keyword, with CNY price, 30-day sales, positive review rate, shop, commission rate and number of partnering creators. The partnering creator count does not show that any particular creator sold the item.
Full API reference: parameters, code samples, response example and health →keywordRequired- A Douyin product search phrase. Results form an independent product pool and do not establish that any specified creator promoted or sold those items.
What do the Douyin product_detail parameters mean?
Read one Douyin Mall product by numeric ID for displayed and discount price in CNY, sales figure, shop, images, assurances, shipping notes, variants and on-sale status. Take product_id from product_search or live_product_search, not a SKU or promotion ID.
product_idRequired- A numeric Douyin product ID returned by
product_searchorlive_product_search. It is not a SKU ID, promotion ID, title, or URL.
What do the Douyin live_product_search parameters mean?
Find up to three Douyin products currently sold in live streams for a keyword, with SKU, title, CNY price, shop and live room ID. The room ID reflects this search only and does not attribute past live sales.
Full API reference: parameters, code samples, response example and health →keywordRequired- A Douyin Mall product search phrase. Only products that carry a live tag and a live room ID at the time of the request come back; the results are not a record of what any given creator has sold on live streams.
How to use the Douyin API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"douyin","action":"search","params":{"keyword":"<keyword>"}}'
Douyin guides
Worked examples and methods built on these actions. Check the current actions, parameters and fields on this page first; an article's examples and limits do not replace the live catalog.
Retrieving Douyin Comments: From Video URL to JSON Preserving Reply Structure
Start with live parameters for douyin.comments, read comments using minimal requests, preserve video source, comment IDs, and reply relationships, and handle limits, empty results, timestamp parsing, and repeated observations.
Read the article →Multiplatform Reputation Monitoring Blueprint: Define Scope Before Evaluating Negative Shifts
Design a traceable reputation monitoring workflow starting with target lists, comment identities, and incremental cursors; use offline samples to demonstrate deduplication and ingestion gaps while preserving manual review.
Read the article →Unified Data API Getting Started: From Capability Catalog to First Available Result
Access multi-platform data using platform, action, and params: read the capability catalog, complete minimal requests, handle asynchronous tasks, partial results, and billing, and establish traceable data records.
Read the article →Douyin API questions
What can I retrieve with the Douyin API?
Set platform to douyin. The current catalog lists search, profiles, posts by user, video details, comments, and more. These action names identify different Douyin objects or views; they are not interchangeable search modes.
Does Douyin have an official API?
Douyin Open Platform offers OAuth-based APIs to mobile and web apps registered by verified business entities, and data access is limited to users who authorize the app. Its keyword video search capability is listed as experimental and not open to developers.
Official sources: Douyin Open Platform: joining as a developer · Douyin Open Platform: video search capability · Checked
Do I need a Douyin developer account or API key?
No. Requests go through EveryInfra with an EveryInfra API key: sign up, create a key in the console and send it as Authorization: Bearer <API_KEY>. You do not register a Douyin developer app, apply for Douyin API access or sign in with a Douyin account, and the actions return public Douyin data only.
How much does the Douyin API cost per 1,000 requests?
$0.56 per 1,000 requests, depending on the action; each action's price is listed in the table on this page and in the public catalog. There is no subscription: you top up a USD balance and pay per call, and failed calls and empty results are not charged.
Which input starts a Douyin `search` request?
Search term for the video search action, passed as a string, for example latte art. It finds videos; it is not an account nickname or a video ID. Send it as keyword inside params.
Which fields can Douyin `search` return?
Its declared schema includes text, media_type, video_url, and like_count. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Douyin action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.