抖音数据 API：商品、用户、视频与评论 | Douyin API

这是社媒数据助手 SocialDataX 的 Apify Actor 适配层，提供只读抖音 / Douyin data API，面向商品搜索与详情、用户搜索、作品搜索、评论数据、博主信息、热榜和批量 Dataset export 场景。

Apify 用户无需配置 SocialDataX API Key；直接通过 Apify Console、Apify API、Dataset export 或自动化工作流运行即可。

Overview / 概览

This Actor turns SocialDataX's read-only Douyin data API into an Apify Dataset workflow. It supports product search and details, user search, comments export, creator data, video search and details, creator series, hot-list data, and CSV / Excel / JSON exports.

这个 Actor 适合把抖音商品搜索与详情、用户搜索、评论数据、博主信息、视频搜索、博主作品列表、合集/短剧列表和热榜数据导出到 Apify Dataset，再通过 CSV、Excel、JSON、JSONL 或 Apify API 使用。

Features / 支持能力

• 作品搜索 / video search / 抖音视频数据
• 商品搜索 / product search
• 商品详情 / product details
• 用户搜索 / user search
• 作品详情 / video details / 单条视频数据
• 评论列表 / comments / 抖音评论数据
• 评论回复 / comment replies
• 博主信息 / creator profiles / profile data
• 博主作品列表 / creator videos
• 博主合集/短剧列表 / creator series
• 热榜 / hot list

This Actor is a read-only, unofficial data API integration. It is not affiliated with Douyin or ByteDance.

Support / 联系我们

如果 run 失败、需要更高用量，或想接入批量数据工作流，请通过 SocialDataX support 联系我们：

• Website: https://socialdatax.com/ai?from=apify

If a run fails, you need higher limits, or you want to discuss a bulk data workflow, contact SocialDataX support:

• Website: https://socialdatax.com/ai?from=apify

Input / 输入字段

先选择 operation，再填写该 operation 需要的字段。Apify 表单里其它字段可以留空；不要用无关字段替代当前 operation 的必填字段，否则 Actor 会返回错误或修正提示，避免跑错查询。

Operation	必填字段	可选字段	说明
search_videos	keyword	sort_type, publish_time_range, duration_range, content_type, page_token, max_items, auto_paginate	按关键词搜索抖音作品，支持排序和筛选，默认会自动翻页直到达到 max_items。
search_products	keyword	sort_type, min_price, max_price, only_live, dispatch_within_24h, shipping_insurance, seven_day_return, selling_point, official_store, page_token, max_items, auto_paginate	按关键词搜索商品，支持销量/价格排序和服务条件筛选。
get_product_detail	product_id 或 url 至少填一个	无	获取单个抖音商品详情；两者都填时优先使用 url。
search_users	keyword	follower_count_range, user_type, page_token, max_items, auto_paginate	按昵称、抖音号、账号名或达人名称搜索用户，并按粉丝数和认证类型筛选。
search_hot_list	无	max_items	抖音热榜，请求一次并按 max_items 限制写入 Dataset。
get_video_detail	aweme_id 或 url 至少填一个	无	获取单个抖音作品详情；两者都填时优先使用 url。
get_video_comments	aweme_id 或 url 至少填一个	page_token, max_items, auto_paginate	获取一级评论列表；两者都填时优先使用 url。
get_video_sub_comments	aweme_id, comment_id	page_token, max_items, auto_paginate	获取某条一级评论下的回复。先运行 get_video_comments，从 Dataset 复制 reply_count > 0 行里的 aweme_id + comment_id。
get_user_info	sec_user_id 或 profile_url 至少填一个	无	获取博主信息；两者都填时优先使用 profile_url。
list_user_videos	sec_user_id 或 profile_url 至少填一个	page_token, max_items, auto_paginate	获取博主作品列表；两者都填时优先使用 profile_url。
list_user_series	sec_user_id 或 profile_url 至少填一个	page_token, max_items, auto_paginate	获取博主合集/短剧列表；两者都填时优先使用 profile_url。

Input tips / 字段填写建议

• url: 商品详情可粘贴抖音商品短链接、商品页面链接或分享文案；作品详情和评论可粘贴作品链接、短链接或分享文案。get_video_sub_comments 不使用 url。
• product_id: 只用于 get_product_detail；用户已提供完整 ID 时直接使用，无需先搜索，否则可从 search_products Dataset 行原样复制；不要填 sku_id 或搜索词。
• profile_url: 推荐直接粘贴抖音主页链接、短链接或分享文案，适用于 get_user_info、list_user_videos 和 list_user_series。
• aweme_id: 只填真实作品 ID；如果把作品链接或分享文案误填到 aweme_id，Actor 会尽量自动按 url 处理。get_video_sub_comments 例外，它必须使用 get_video_comments Dataset 行里的真实 aweme_id。
• sec_user_id: 只填真实 sec_user_id / author_sec_user_id。不要填昵称、主页名称或抖音号；如果只有主页链接或分享文案，请填 profile_url。
• keyword: 根据 operation 搜索作品、商品或用户；商品价格、服务条件和排序请填写对应筛选字段，不要拼进关键词。
• page_token: 搜索和列表接口续页时原样使用上一页 Dataset 行的完整 page_next_page_token（对应 API 返回的 next_page_token）；修改关键词或筛选条件后请清空令牌重新搜索。
• comment_id: 只填 get_video_comments Dataset row 里的 comment_id。请选择 reply_count > 0 的一级评论行，不要填评论内容、昵称或其它文本。

如果用户把作品链接填到博主类 operation、把主页链接填到作品类 operation，或在 get_video_sub_comments 的 aweme_id 里粘贴作品链接/分享文案，Actor 会跳过 SocialDataX API 请求并在 OUTPUT 写入中英文 warning 和支持链接，避免因为明显可修正的输入问题直接失败。

Examples / 输入示例

商品详情输出使用 variant_groups 表示 name/options 可选规格组，shipping.text 表示发货说明，shipping.fee 表示运费展示文本；不再返回旧字段 specifications、shipping_text、shipping_fee_text。price / discount_price 是起售价 / 优惠后起售价，不是指定 SKU 的最终实付价；sales_text 保留销量原文，带 + 的数量不是精确销量。sold_count 提供可解析的已售数量（如 已售 178 返回 178）；不带 + 的万级展示数量换算为整数（如 已售 1.5万 返回 15000），不代表精确销量，须结合原文解读。带 +、缺失或无法解析时返回 null，明确的 已售 0 返回 0。on_sale 不等同于指定 SKU 有库存或当前用户可购买。历史 Dataset 行不会自动改写。

作品搜索：

{
  "operation": "search_videos",
  "keyword": "露营",
  "sort_type": "general",
  "publish_time_range": "all",
  "duration_range": "all",
  "content_type": "all",
  "max_items": 20,
  "auto_paginate": true
}

商品搜索：

{
  "operation": "search_products",
  "keyword": "露营桌",
  "sort_type": "sales_descending",
  "min_price": 100,
  "max_price": 500,
  "shipping_insurance": true,
  "max_items": 50,
  "auto_paginate": true
}

商品详情：

{
  "operation": "get_product_detail",
  "url": "https://v.douyin.com/VnF1KS4vmmQ/"
}

用户搜索：

{
  "operation": "search_users",
  "keyword": "露营",
  "follower_count_range": "10k_to_100k",
  "user_type": "all",
  "max_items": 50,
  "auto_paginate": true
}

热榜：

{
  "operation": "search_hot_list",
  "max_items": 20
}

作品详情：

{
  "operation": "get_video_detail",
  "url": "https://www.douyin.com/video/7648208200076573925"
}

评论列表：

{
  "operation": "get_video_comments",
  "url": "https://www.douyin.com/video/7648208200076573925",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

评论回复：

{
  "operation": "get_video_sub_comments",
  "aweme_id": "7648208200076573925",
  "comment_id": "7648330123242324788",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

comment_id 来自 get_video_comments 的 Dataset 结果。选择 reply_count > 0 的一级评论行，复制该行的 aweme_id 和 comment_id。

博主信息：

{
  "operation": "get_user_info",
  "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A"
}

博主作品列表：

{
  "operation": "list_user_videos",
  "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

博主合集/短剧列表：

{
  "operation": "list_user_series",
  "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

max_items 默认 50，最大 1000。auto_paginate=false 时只请求当前 page_token。热榜不需要分页参数，Actor 会请求一次，并按 max_items 限制写入 Dataset 的热榜条目数。

如果用户在 Apify run options 里设置了更低的 paid Dataset item 上限，Actor 会把列表类 max_items 自动裁剪到该上限，避免超预算请求过多页面。 如果该上限为 0，Actor 会直接结束并在 OUTPUT 写入 warning，不会请求 SocialDataX API。

Apify plan requirements / Apify 计划要求

持续使用需要 Apify paid plan。Apify free plan 用户有 5 次 SocialDataX API request 试用额度；每次请求一个接口页面计 1 次，auto_paginate=true 时每翻一页都会计入一次。试用额度用完后，请升级 Apify 计划继续使用。

Ongoing use requires an Apify paid plan. Free-plan users get a 5-request SocialDataX API trial. Each requested page counts as one request, so auto_paginate=true can consume multiple requests in one run.

Output / 输出

Actor 会把结果写入 Apify Dataset，适合 JSON、CSV、Excel / XLSX、JSONL 等格式导出。

列表类接口会为 items[] 或 hot_items[] 中的每个元素写入一条扁平 dataset row：

{
  "operation": "get_video_comments",
  "item_index": 1,
  "query_aweme_id": "7648208200076573925",
  "query_page_token": "",
  "query_max_items": 20,
  "query_auto_paginate": true,
  "aweme_id": "7648208200076573925",
  "comment_id": "7648330123242324788",
  "content": "这套露营装备清单很实用。",
  "reply_count": 8,
  "author_sec_user_id": "MS4wLjABAAAALynj49NNn56hWtVWVcPsfDfNnpMSC-LwECb-ChhQd4lRlQwduE3zeDvy4aj3YTyF",
  "author_name": "露营爱好者",
  "page_request_index": 1,
  "page_item_count": 20,
  "page_next_page_token": "next-token",
  "page_has_more": true
}

详情类接口会写入一条 dataset row。author、video、music 等常见对象会展开为 author_*、video_*、music_* 字段；live_info 保留为直播摘要对象，未直播时为 null。图片和数组字段保留 JSON 值。

如果某一页 items 为空但仍有分页信息，且本次 run 没有继续拿到后续实际 item，Actor 会写入一条 empty_page=true 的 summary row，避免丢失 page_next_page_token。如果自动翻页后拿到了后续实际 item，中间空页不会写入 Dataset row，也不会占用 max_items。如果空页已经没有下一页，则不会写入 Dataset row。

如果 run 失败，OUTPUT 会保留一条轻量失败摘要，方便在 Apify 控制台里直接看到请求次数、状态码和简要错误信息。

Apify API usage / Apify API 调用

同步运行并直接获取 Dataset items：

curl -X POST "https://api.apify.com/v2/acts/socialdatax~socialdatax-douyin-data-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 20,
    "auto_paginate": true
  }'

Python client 示例：

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("socialdatax/socialdatax-douyin-data-api").call(run_input={
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 20,
    "auto_paginate": True,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items

Pricing / 费用

Apify 用户按 Actor 页面展示的 Apify 价格和用量计费，不需要购买或配置 SocialDataX API Key。