# 抖音 API

搜索视频、话题、音乐、达人、商品和联想词，按 secUid 查作者资料与作品，读取评论、语音文稿、热榜和热点宝榜单，查看达人画像与星图数据；作品文案不同于转写，榜单热度不跨榜混排。

- Domain: social · 37 data actions
- Canonical page: https://everyinfra.com/douyin-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 600 credits ($8.33 / 千次)
- Required: keyword

- Optional: page_token, publish_time, sort
- Allowed values: publish_time (half_year/one_day/one_week/unlimited), sort (most_liked/newest/relevance)

- Returns fields: next_page_token, id, url, text, media_type, video_url, like_count, comment_count, share_count, collect_count, view_count, author_name, author_id, author_douyin_id, author_uid, author_bio, author_avatar_url, author_follower_count, cover_image_url, video_width, video_height, duration_seconds, region, hashtags, posted_at, platform, image_urls, duration_sec, hashtag_ids, search_rank, author_is_verified, 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_resolution, animated_cover_url, city, city_code, location, text_language, video_bitrates, download_url, has_watermark, video_url_expires_at, permissions, author_gender, author_age

### profile — 主页或对象详情
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Returns fields: 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, age, has_series, platform, verify_reason

### user_posts — 用户内容
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Optional: page_token, since

- Returns fields: next_page_token, id, url, text, media_type, video_url, like_count, comment_count, share_count, collect_count, view_count, author_name, author_id, author_douyin_id, author_uid, author_bio, author_avatar_url, author_follower_count, cover_image_url, video_width, video_height, duration_seconds, region, hashtags, posted_at, platform, image_urls, duration_sec, hashtag_ids, search_rank, author_is_verified, 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_resolution, animated_cover_url, city, city_code, location, text_language, video_bitrates, download_url, has_watermark, video_url_expires_at, permissions, author_gender, author_age

### video — 视频详情
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: url

- Returns fields: id, url, text, media_type, video_url, like_count, comment_count, share_count, collect_count, view_count, author_name, author_id, author_douyin_id, author_uid, author_bio, author_avatar_url, author_follower_count, cover_image_url, video_width, video_height, duration_seconds, region, hashtags, posted_at, platform, image_urls, duration_sec, hashtag_ids, search_rank, author_is_verified, 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_resolution, animated_cover_url, city, city_code, location, text_language, video_bitrates, download_url, has_watermark, video_url_expires_at, permissions, author_gender, author_age

### comments — 评论
- Mode: sync · Price: 40 credits ($0.56 / 千次) per 20 rows asked
- Required: url

- Optional: page_token

- Returns fields: 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

### comment_replies — 评论回复
- Mode: sync · Price: 40 credits ($0.56 / 千次) per 20 rows asked
- Required: url, comment_id

- Optional: page_token

- Returns fields: next_page_token, id, text, like_count, author_name, author_id, author_uid, author_avatar_url, ip_location, liked_by_author, is_reply, reply_to_id, reply_to_reply_id, reply_to_author_name, posted_at, video_id, images, mentioned_users, platform

### trending — 热榜
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: —

- Optional: boards
- Allowed values: boards (challenge/entertainment/hotspot/seeding/social)

- Returns fields: 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, topic_view_count, sentence_tag, label_icon_url, related_music_id, platform

### transcript — 视频文稿
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: url

- Returns fields: 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_search — 达人搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: keyword

- Optional: follower_range, user_type
- Allowed values: follower_range (100k_to_1m/10k_to_100k/1k_to_10k/over_1m/under_1k), user_type (business/general/verified_individual)

- Returns fields: user_id, douyin_id, nickname, url, avatar_url, follower_count, gender, is_verified, verify_reason, is_live, uid, source_keyword, platform

### creator_audience — 达人粉丝画像
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Optional: dimension
- Allowed values: dimension (age/device_price_band/gender/province)

- Returns fields: user_id, audience_distribution, audience_tgi, dimension_code, platform

### creator_trend — 达人涨粉趋势
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Returns fields: user_id, follower_trend, average_follower_count, dimension_code, platform

### creator_benchmark — 同类达人对比
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Returns fields: 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_search — 星图达人搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: keyword

- Returns fields: 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_analytics — 星图达人分析
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: douyin_id

- Returns fields: 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_card — 星图达人报价
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: douyin_id

- Returns fields: creator_id, rate_tiers, platform

### xingtu_creator_rankings — 星图达人榜单
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: industry, ranking_type, time_window
- Allowed values: industry (apparel_accessories/automotive/beauty/electronics/food_beverage/household_goods/mother_baby_pets), ranking_type (all_top/head_tier/paid_ad_performers/rising_stars/sales_champions/top_creators/viral_drivers), time_window (all_history_monthly/all_history_weekly/latest_monthly/latest_weekly)

- Returns fields: 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, industry_tags, primary_tag, industry_id, top_videos, source_kind, platform

### product_search — 商品搜索
- Mode: sync · Price: 960 credits ($13.33 / 千次)
- Required: keyword

- Returns fields: 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_detail — 商品详情
- Mode: sync · Price: 960 credits ($13.33 / 千次)
- Required: product_id

- Returns fields: 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_search — 直播商品搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: keyword

- Returns fields: product_id, sku_id, title, image_url, price_cny, shop_id, live_room_id, is_live_product, source_keyword, platform

### hashtag_search — 话题搜索
- Mode: sync · Price: 1120 credits ($15.56 / 千次)
- Required: keyword

- Returns fields: hashtag_id, hashtag_name, search_rank, heat_index, period_video_count, period_like_count, period_view_count, period_start, period_end, platform

### hashtag_detail — 话题详情
- Mode: sync · Price: 1120 credits ($15.56 / 千次)
- Required: hashtag_id

- Returns fields: hashtag_id, hashtag_name, total_view_count, participant_count, created_at, url, platform

### billboard_video_hot — 热点宝视频热榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: board, keyword, page_token, time_window
- Allowed values: board (all/follower_growth/like_rate), time_window (1d/1h/3d/7d)

- Returns fields: id, url, text, media_type, image_count, cover_image_url, video_url, duration_seconds, duration_sec, author_name, author_avatar_url, author_follower_count, play_count, like_count, like_rate, new_follower_count, follower_growth_rate, hot_value, posted_at, next_page_token, platform

### billboard_low_fan_explosion — 热点宝低粉爆款榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: keyword, page_token, time_window
- Allowed values: time_window (1d/1h/3d/7d)

- Returns fields: id, url, text, media_type, image_count, cover_image_url, video_url, duration_seconds, duration_sec, author_name, author_avatar_url, author_follower_count, play_count, like_count, like_rate, new_follower_count, follower_growth_rate, hot_value, posted_at, next_page_token, platform

### billboard_high_completion — 热点宝高完播率榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: keyword, page_token, time_window
- Allowed values: time_window (1d/1h/3d/7d)

- Returns fields: id, url, text, media_type, image_count, cover_image_url, video_url, duration_seconds, duration_sec, author_name, author_avatar_url, author_follower_count, play_count, like_count, like_rate, new_follower_count, follower_growth_rate, hot_value, posted_at, next_page_token, platform

### billboard_search_hot — 热点宝搜索热榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: keyword, page_token, time_window
- Allowed values: time_window (1d/1h/3d/7d)

- Returns fields: rank, keyword, hot_value, search_trend, platform

### billboard_account_search — 热点宝账号搜索
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: user_id, nickname, url, avatar_url, follower_count, like_count, video_count, next_page_token, platform

### music_search — 音乐搜索
- Mode: sync · Price: 576 credits ($8 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: id, url, title, author_name, duration_seconds, duration_sec, use_count, cover_image_url, audio_url, lyric_url, tags, next_page_token, platform

### search_suggest — 搜索联想词
- Mode: sync · Price: 576 credits ($8 / 千次)
- Required: keyword

- Returns fields: rank, keyword, platform

### billboard_rise_list — 热点宝上升热点榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: keyword, page_token

- Returns fields: rank, rank_change, title, topic_id, hot_value, video_count, category, created_at, hot_trend, next_page_token, platform

### billboard_challenge_hot — 热点宝挑战热榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Returns fields: rank, title, topic_id, hot_value, video_count, created_at, hot_trend, platform

### billboard_topic_hot — 热点宝话题热榜
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: —

- Optional: keyword, page_token, time_window
- Allowed values: time_window (1d/1h/3d/7d)

- Returns fields: rank, hashtag_id, hashtag_name, hot_value, total_view_count, total_video_count, average_view_count, cover_image_url, created_at, daily_trend, next_page_token, platform

### music_detail — 音乐详情
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: music_id

- Returns fields: id, url, title, author_name, duration_seconds, duration_sec, use_count, cover_image_url, audio_url, lyric_url, platform

### xingtu_conversion_ability — 星图达人转化能力
- Mode: sync · Price: 115 credits ($1.6 / 千次)
- Required: douyin_id

- Optional: time_window
- Allowed values: time_window (30d/7d/90d)

- Returns fields: creator_id, time_window, related_video_count, video_play_median, component_click_count_range, component_click_rate_range, cpc_range_cny, gpm_range_cny, average_sales_range_cny, product_count, product_price_range_cny, categories, platform

### xingtu_link_structure — 星图达人连接用户结构
- Mode: sync · Price: 1152 credits ($16 / 千次)
- Required: douyin_id

- Returns fields: creator_id, link_type, total_user_count, total_rank_top_percent, levels, platform

### xingtu_recommended_videos — 星图达人推荐视频
- Mode: sync · Price: 115 credits ($1.6 / 千次)
- Required: douyin_id

- Returns fields: creator_id, signature_videos, latest_videos, top_xingtu_order_videos, top_personal_videos, platform

### xingtu_touch_distribution — 星图达人连接用户来源
- Mode: sync · Price: 1152 credits ($16 / 千次)
- Required: douyin_id

- Returns fields: creator_id, categories, platform

### xingtu_video_performance — 星图达人视频表现
- Mode: sync · Price: 1152 credits ($16 / 千次)
- Required: douyin_id

- Returns fields: creator_id, personal_videos, xingtu_videos, latest_videos, latest_xingtu_videos, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md