SocialDataX API

抖音 API 文档

抖音作品搜索、详情、评论、用户资料与发布列表接口，包含请求参数、返回字段和计费说明。

读取抖音主热榜

读取抖音主热榜，返回排名、热点标题、分类标签、热度值、浏览量和封面图。

POST /socialdatax/api/v1/douyin/hot/search/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

请求示例

{}

返回字段

hot_items（必填）：抖音主热榜条目
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "hot_items": [
    {
      "rank": 1,
      "keyword": "露营",
      "tag": "话题互动",
      "hot_value": 12214394,
      "view_count": 61663400,
      "cover_image_url": "https://example.invalid/cover.webp"
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

获取抖音搜索建议

按关键词获取抖音普通搜索输入框中的联想词；不用于搜索作品、用户或商品。

POST /socialdatax/api/v1/douyin/search/suggestions

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：用于获取普通搜索输入框联想词的搜索词

请求示例

{
  "keyword": "露营"
}

返回字段

items（必填）：联想词列表
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "text": "露营地"
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索抖音作品

按关键词和筛选条件搜索公开抖音作品，返回视频或图文作品摘要和下一页分页令牌。

POST /socialdatax/api/v1/douyin/video/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索关键词。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用。
sort_type：搜索排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）。综合或默认排序请传 general，最新发布请传 time_descending，最多点赞请传 like_count_descending。hot、latest、time、relevance、relevance_desc、default、综合、general_desc、liked、like_count、liked_desc、most_liked、most_hot、popularity_descending 等写法均不是可接受值，请直接使用上述三个标准值。
publish_time_range：发布时间范围筛选。
duration_range：视频时长筛选。
content_type：内容形式筛选。

请求示例

{
  "keyword": "露营",
  "page_token": "",
  "sort_type": "general",
  "publish_time_range": "all",
  "duration_range": "all",
  "content_type": "all"
}

返回字段

items（必填）：当前页搜索结果中的作品列表
next_page_token（必填）：下一页分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "aweme_id": "7648208200076573925",
      "content_type": "video",
      "description": "我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告",
      "publish_time": 1780737239,
      "cover_image_url": "https://example.invalid/cover.webp",
      "images": [],
      "video": {
        "play_url": "https://example.invalid/douyin-video.mp4",
        "duration_ms": 289334,
        "width": 1080,
        "height": 1920,
        "media_type": "video"
      },
      "share_url": "https://www.douyin.com/video/7648208200076573925",
      "topic_tags": [
        {
          "name": "露营",
          "id": "1580532647418893"
        },
        {
          "name": "露营装备",
          "id": "1629063161894920"
        },
        {
          "name": "露营入坑",
          "id": "1725909323877464"
        },
        {
          "name": "户外露营",
          "id": "1601409194763277"
        },
        {
          "name": "露营报告",
          "id": "1706866801920072"
        }
      ],
      "author": {
        "user_id": "1234567890",
        "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
        "name": "社媒研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
        "bio": "记录内容趋势和创作者案例。",
        "verification_label": "",
        "verified": false,
        "follower_count": 12000,
        "following_count": 80,
        "received_like_count": 300000
      },
      "like_count": 51740,
      "comment_count": 6089,
      "collect_count": 5483,
      "share_count": 75290
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索抖音用户

按昵称、抖音号、账号名或达人名称搜索公开抖音用户，可按粉丝数量和认证类型筛选，返回用户摘要和下一页分页令牌。

POST /socialdatax/api/v1/douyin/user/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的完整 next_page_token。只能用于同一用户搜索链路，不能跨关键词或筛选条件复用。
follower_count_range：用户粉丝数量筛选，可选：all（不限，默认）、under_1k（1000 以下）、1k_to_10k（1000-1 万）、10k_to_100k（1 万-10 万）、100k_to_1m（10 万-100 万）、over_1m（100 万以上）。
user_type：用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。

请求示例

{
  "keyword": "露营",
  "page_token": "",
  "follower_count_range": "all",
  "user_type": "all"
}

返回字段

items（必填）：当前页用户搜索结果列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "user_id": "1234567890",
      "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
      "douyin_id": "socialdatax-camping",
      "name": "露营研究员",
      "avatar_url": "https://example.invalid/avatar.webp",
      "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
      "bio": "分享露营装备、路线和户外生活。",
      "verification_label": "",
      "verified": false,
      "follower_count": 12000,
      "following_count": 80,
      "received_like_count": 300000,
      "posted_content_count": 128
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索抖音商品

按关键词搜索抖音全局搜索中的商品，支持稳定的排序、价格、物流服务、卖点和抖音旗舰筛选；返回包含商品 ID、SKU ID、价格、店铺和卡片来源的归一化商品列表与不透明分页令牌。该能力对应首页搜索进入商品页，不表示商城频道内完整搜索链路。

POST /socialdatax/api/v1/douyin/product/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。
page_token：不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入。只能用于相同关键词、排序和筛选条件的商品搜索；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致。需要修改任一条件时，清空 page_token 后从第一页重新搜索。
sort_type：商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。
min_price：最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。
max_price：最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。
only_live：true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。
dispatch_within_24h：true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。
shipping_insurance：true 时仅返回支持运费险的商品；false 表示不限（默认）。
seven_day_return：true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。
selling_point：卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。
official_store：true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。

请求示例

{
  "keyword": "露营",
  "page_token": "",
  "sort_type": "general",
  "selling_point": "all"
}

返回字段

items（必填）：当前页商品列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "product_id": "3809228538935115995",
      "sku_id": "3648420065728514",
      "title": "DICHUN夏季小个子森系吊带碎花连衣裙两件套新款清冷系禅意衣服",
      "image_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_7c0004cb9ec0cd00aa0689d8bdb78afc_sx_520717_www1440-1928",
      "price": 308,
      "shop_id": "213374261",
      "card_type": "product",
      "video_id": null,
      "live_room_id": null
    },
    {
      "product_id": "3774502057764061666",
      "sku_id": "3551662306714370",
      "title": "Apple iPhone 17 Pro",
      "image_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_29ffd3b1d4e8e563526d0199226a3f3b_sx_104248_www1280-1280~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid",
      "price": 8499,
      "shop_id": "233228908",
      "card_type": "video",
      "video_id": "7579235510779006208",
      "live_room_id": null
    },
    {
      "product_id": "3675842076119007495",
      "sku_id": "3400912136844802",
      "title": "YSL圣罗兰彩妆套装恒久粉底液+粉饼定妆遮瑕控油 礼物 正品",
      "image_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_89f50b1254d41b4000ace82fb3431abf_sx_453652_www800-800~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid",
      "price": 1266,
      "shop_id": "71868871",
      "card_type": "live",
      "video_id": null,
      "live_room_id": "7677738876055636771"
    }
  ],
  "next_page_token": "opaque-douyin-product-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音商品详情

根据完整 product_id 或抖音商品短链接、商品页面链接、分享文案读取商品详情；已有 ID 时无需先搜索，返回价格、店铺、商品图片、详情图、保障、物流和规格信息。product_id 与 url 二选一；不接受 sku_id 或搜索关键词。商品已删除时返回 HTTP 200、业务 code=1008，错误文案为“当前商品已删除。”；请停止对同一商品自动重试，并确认商品是否仍可访问或更换商品 ID/链接。

POST /socialdatax/api/v1/douyin/product/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

product_id：抖音商品 ID；用户已提供完整商品 ID 时原样使用，无需先搜索；否则从商品搜索结果的 product_id 原样复制。与 url 二选一；不接受 sku_id 或搜索关键词。
url：抖音商品短链接、商品页面链接或包含商品链接的分享文案；与 product_id 二选一

请求示例

{
  "product_id": "3838200348212854845"
}

返回字段

product_id（必填）：商品 ID；可直接使用商品搜索结果中的 product_id
title（必填）：商品标题
price（必填）：商品起售价，单位：元；不是指定 SKU 的价格，也不保证是最终实付价
discount_price（必填）：优惠后起售价，单位：元；不限定为券后价，也不保证是最终实付价；没有单独优惠价时与 price 相同
sales_text（必填）：平台展示的商品销量文本；没有时为空字符串；带“+”的数量表示下限，不是精确销量
sold_count（必填）：从销量文本解析的已售数量；不带“+”的万级展示数量换算为整数（如已售 1.5万返回 15000），不代表精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0
shop_id（必填）：店铺 ID
shop_name（必填）：店铺名称
shop_avatar_url（必填）：店铺头像链接
main_images（必填）：商品顶部主图/轮播图列表；空列表表示当前未返回对应图片
detail_images（必填）：商品详情图列表；空列表表示当前未返回对应图片
assurances（必填）：商品保障服务列表；空列表表示当前未返回保障信息，不代表商品没有保障服务
shipping（必填）：发货信息；不包含发货地
variant_groups（必填）：可选商品规格组（name/options），不是商品属性参数或已选 SKU；空列表表示当前未返回规格信息，不代表商品只有一种规格
on_sale（必填）：商品当前是否在售；不等同于指定 SKU 有库存或当前用户可购买
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "product_id": "3838200348212854845",
  "title": "每日坚果混合坚果礼盒",
  "price": 8.33,
  "discount_price": 3.33,
  "sales_text": "已售 178",
  "sold_count": 178,
  "shop_id": "123207101",
  "shop_name": "零食优选店",
  "shop_avatar_url": "https://example.invalid/shop.webp",
  "main_images": [
    {
      "image_url": "https://example.invalid/product.webp",
      "width": 800,
      "height": 800
    }
  ],
  "detail_images": [
    {
      "image_url": "https://example.invalid/detail.webp",
      "width": 750,
      "height": 1000
    }
  ],
  "assurances": [
    "7 天无理由退货"
  ],
  "shipping": {
    "text": "48 小时内发货",
    "fee": "包邮"
  },
  "variant_groups": [
    {
      "name": "规格",
      "options": [
        {
          "spec_id": "1",
          "name": "默认规格"
        }
      ]
    }
  ],
  "on_sale": true,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音作品详情

按 aweme_id 或作品链接读取公开抖音作品详情，返回文案、媒体资源、互动指标、音乐和作者信息。

POST /socialdatax/api/v1/douyin/video/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

aweme_id：抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。
url：抖音作品页面链接、作品短链接或包含作品链接的分享文案。

请求示例

{
  "aweme_id": "7648208200076573925"
}

返回字段

aweme_id（必填）：作品 aweme_id
content_type（必填）：作品类型：video 表示视频，image 表示图文，unknown 表示未知
description（必填）：作品文案
publish_time（必填）：作品发布时间，秒级 Unix 时间戳
cover_image_url（必填）：作品封面图链接；当前不可用时为 null
images（必填）：作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组
video（必填）：抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null
music（必填）：作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null
share_url（必填）：作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null
mentioned_users（必填）：作品正文中 @ 到的用户列表；无 @ 时为空数组
topic_tags（必填）：作品话题标签列表；无话题标签时为空数组
like_count（必填）：作品点赞数
comment_count（必填）：作品评论数
collect_count（必填）：作品收藏数
share_count（必填）：作品分享数
author（必填）：作品作者信息
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "aweme_id": "7648208200076573925",
  "content_type": "video",
  "description": "我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告",
  "publish_time": 1780737239,
  "cover_image_url": "https://example.invalid/cover.webp",
  "images": [],
  "video": {
    "play_url": "https://example.invalid/douyin-video.mp4",
    "duration_ms": 289334,
    "width": 1080,
    "height": 1920,
    "media_type": "video"
  },
  "share_url": "https://www.douyin.com/video/7648208200076573925",
  "topic_tags": [
    {
      "name": "露营",
      "id": "1580532647418893"
    },
    {
      "name": "露营装备",
      "id": "1629063161894920"
    },
    {
      "name": "露营入坑",
      "id": "1725909323877464"
    },
    {
      "name": "户外露营",
      "id": "1601409194763277"
    },
    {
      "name": "露营报告",
      "id": "1706866801920072"
    }
  ],
  "author": {
    "user_id": "1234567890",
    "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
    "douyin_id": "socialdatax-demo",
    "name": "社媒研究员",
    "avatar_url": "https://example.invalid/avatar.webp",
    "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
    "bio": "记录内容趋势和创作者案例。",
    "verification_label": "",
    "verified": false,
    "follower_count": 12000,
    "following_count": 80,
    "received_like_count": 300000
  },
  "like_count": 51740,
  "comment_count": 6089,
  "collect_count": 5483,
  "share_count": 75290,
  "mentioned_users": [],
  "music": {
    "title": "原声",
    "author": "社媒研究员",
    "play_url": "https://example.invalid/music.mp3",
    "duration_ms": 5000
  },
  "points": {
    "cost": 10,
    "balance": 990
  }
}

生成抖音作品分享链接

按 aweme_id 或作品页面链接、短链接、分享文案生成抖音分享短链接和完整分享文案。aweme_id 与 url 二选一。

POST /socialdatax/api/v1/douyin/video/share/link

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

aweme_id：抖音作品 ID，与 url 二选一。
url：作品页面链接、短链接或包含作品链接的分享文案，与 aweme_id 二选一。

请求示例

{
  "aweme_id": "7648208200076573925"
}

返回字段

share_text（必填）：包含短链接的完整分享文案，可复制分享。
short_url（必填）：抖音作品分享短链接。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "share_text": "复制打开抖音，看看作品 https://v.douyin.com/example/",
  "short_url": "https://v.douyin.com/example/",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音作品一级评论

按 aweme_id、作品链接、短链接或分享文案读取公开抖音作品一级评论，返回评论作者、内容类型、互动指标和下一页分页令牌。

POST /socialdatax/api/v1/douyin/video/comment/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

aweme_id：抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。
url：抖音作品页面链接、作品短链接或包含作品链接的分享文案。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。

请求示例

{
  "aweme_id": "7648208200076573925",
  "page_token": ""
}

返回字段

items（必填）：当前页一级评论列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
comment_count（必填）：作品评论总量；当前不可用时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "7648330123242324788",
      "aweme_id": "7648208200076573925",
      "content": "这套露营装备清单很实用。",
      "content_type": "text",
      "create_time": 1776935604,
      "like_count": 91,
      "reply_count": 8,
      "ip_location": "河北",
      "image_urls": [],
      "sticker": null,
      "is_hot": true,
      "is_folded": false,
      "mentioned_users": [],
      "author": {
        "user_id": "2304997881289384",
        "sec_user_id": "MS4wLjABAAAALynj49NNn56hWtVWVcPsfDfNnpMSC-LwECb-ChhQd4lRlQwduE3zeDvy4aj3YTyF",
        "douyin_id": "a9246",
        "name": "露营爱好者",
        "avatar_url": "https://example.invalid/comment-avatar.webp",
        "profile_url": "https://www.douyin.com/user/MS4wLjABAAAALynj49NNn56hWtVWVcPsfDfNnpMSC-LwECb-ChhQd4lRlQwduE3zeDvy4aj3YTyF",
        "verification_label": "",
        "verified": false
      }
    }
  ],
  "next_page_token": "",
  "comment_count": 18,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音评论回复

按 aweme_id 和一级评论 ID 读取公开回复列表，返回评论结构和下一页分页令牌。

POST /socialdatax/api/v1/douyin/video/comment/reply/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

aweme_id（必填）：抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。
comment_id（必填）：一级评论 ID。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。

请求示例

{
  "aweme_id": "7648208200076573925",
  "comment_id": "7648330123242324788",
  "page_token": ""
}

返回字段

items（必填）：当前页评论回复列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
comment_count（必填）：该一级评论下的回复总量；当前不可用时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "7648884998297568037",
      "aweme_id": "7648208200076573925",
      "content": "想问下这套预算多少？",
      "content_type": "text",
      "create_time": 1780894819,
      "like_count": 7,
      "reply_count": 0,
      "ip_location": "辽宁",
      "image_urls": [],
      "sticker": null,
      "is_hot": false,
      "is_folded": false,
      "author": {
        "user_id": "93369089720",
        "sec_user_id": "MS4wLjABAAAA95j6csjbjOqr1GOaVkelq3VBIn1R76TPruLZe-UvXqk",
        "douyin_id": "364778165",
        "name": "岩岩爱睡觉",
        "avatar_url": "https://example.invalid/comment-avatar.webp",
        "profile_url": "https://www.douyin.com/user/MS4wLjABAAAA95j6csjbjOqr1GOaVkelq3VBIn1R76TPruLZe-UvXqk",
        "verification_label": "",
        "verified": false
      }
    }
  ],
  "next_page_token": "",
  "comment_count": 10,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音用户资料

按 sec_user_id 或主页链接读取创作者公开资料、认证信息、公开互动规模和直播状态摘要；MCP 另提供按抖音号 douyin_id 查询资料的入口。

POST /socialdatax/api/v1/douyin/user/info

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

sec_user_id：抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口
profile_url：抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。

请求示例

{
  "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A"
}

返回字段

user_id（必填）：用户 user_id；当前不可用时为空字符串
sec_user_id（必填）：用户 sec_user_id；当前不可用时为空字符串
name（必填）：用户昵称
avatar_url（必填）：用户头像链接；当前不可用时为 null
profile_url（必填）：用户主页链接；当前不可用时为 null
bio（必填）：用户简介；当前不可用时为空字符串
verification_label（必填）：用户认证文案；当前不可用时为空字符串
verified（必填）：用户是否为认证账号
follower_count（必填）：平台展示的粉丝数；当前不可用时为 null
following_count（必填）：关注数；当前不可用时为 null
received_like_count（必填）：用户内容累计收到的点赞数；当前不可用时为 null
douyin_id（必填）：用户主页展示的抖音号；当前不可用时为空字符串
douyin_follower_count：抖音单端粉丝数；当前不可用时为 null
cross_platform_follower_count：关联平台合计粉丝数；当前不可用时为 null
ip_location（必填）：IP 属地；当前不可用时为空字符串
gender（必填）：性别：male 表示男，female 表示女，unknown 表示未知
posted_content_count（必填）：用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null
live_info（必填）：用户直播状态摘要；用户当前未直播时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "1234567890",
  "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
  "douyin_id": "socialdatax-demo",
  "name": "社媒研究员",
  "avatar_url": "https://example.invalid/avatar.webp",
  "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
  "bio": "记录内容趋势和创作者案例。",
  "verification_label": "",
  "verified": false,
  "follower_count": 12000,
  "following_count": 80,
  "received_like_count": 300000,
  "ip_location": "上海",
  "gender": "unknown",
  "posted_content_count": 128,
  "live_info": null,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音用户作品列表

按 sec_user_id 或主页链接读取创作者已发布作品摘要列表，支持分页令牌。

POST /socialdatax/api/v1/douyin/user/video/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

sec_user_id：抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口
profile_url：抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。

请求示例

{
  "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
  "page_token": ""
}

返回字段

items（必填）：当前页作品列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "aweme_id": "7648208200076573925",
      "content_type": "video",
      "description": "我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告",
      "publish_time": 1780737239,
      "cover_image_url": "https://example.invalid/cover.webp",
      "images": [],
      "video": {
        "play_url": "https://example.invalid/douyin-video.mp4",
        "duration_ms": 289334,
        "width": 1080,
        "height": 1920,
        "media_type": "video"
      },
      "share_url": "https://www.douyin.com/video/7648208200076573925",
      "topic_tags": [
        {
          "name": "露营",
          "id": "1580532647418893"
        },
        {
          "name": "露营装备",
          "id": "1629063161894920"
        },
        {
          "name": "露营入坑",
          "id": "1725909323877464"
        },
        {
          "name": "户外露营",
          "id": "1601409194763277"
        },
        {
          "name": "露营报告",
          "id": "1706866801920072"
        }
      ],
      "author": {
        "user_id": "1234567890",
        "sec_user_id": "MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
        "douyin_id": "socialdatax-demo",
        "name": "社媒研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A",
        "bio": "记录内容趋势和创作者案例。",
        "verification_label": "",
        "verified": false,
        "follower_count": 12000,
        "following_count": 80,
        "received_like_count": 300000
      },
      "like_count": 51740,
      "comment_count": 6089,
      "collect_count": 5483,
      "share_count": 75290,
      "is_pinned": false
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取抖音用户短剧列表

按 sec_user_id 或主页链接读取创作者短剧列表，支持分页令牌。

POST /socialdatax/api/v1/douyin/user/series/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

sec_user_id：抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口
profile_url：抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。
page_token：分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。

请求示例

{
  "sec_user_id": "MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4",
  "page_token": ""
}

返回字段

items（必填）：当前页短剧列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "series_id": "7586639947990468642",
      "title": "短剧 · 断悬案，平匪患，叫我八岁小青天",
      "description": "李图前世是经验丰富的老刑侦，破过无数大案，一不小心，居然穿越到了古代，成为了一个年仅八岁的九品芝麻官。",
      "cover_image_url": "https://example.invalid/series-cover.webp",
      "share_url": "https://www.iesdouyin.com/share/playlet/detail/7586639947990468642/",
      "create_time": 1766402262,
      "update_time": 1775268426,
      "play_count": 1000,
      "collect_count": 20,
      "total_episode_count": 78,
      "updated_episode_count": 53,
      "author": {
        "user_id": "1234567890",
        "sec_user_id": "MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4",
        "douyin_id": "socialdatax-demo",
        "name": "龙帅短剧",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.douyin.com/user/MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4",
        "bio": "上门退婚被当乞丐羞辱，转身让豪门跪着把婚书粘好！",
        "verification_label": "",
        "verified": false,
        "follower_count": 12000,
        "following_count": 80,
        "received_like_count": 300000
      }
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

鉴权与在线测试

业务 API 使用 API Key 鉴权。公开文档无需登录；在线测试可手动输入 API Key，登录后也可选择账户已有 Key。手动输入的 Key 仅在当前页面使用，curl 示例始终引用 SOCIALDATAX_API_KEY 环境变量。

机器可读入口

开发工具和 AI 可以通过以下公共入口读取最新文档，接口数据由后端统一生成。

抖音 API 文档

读取抖音主热榜

请求参数

请求示例

返回字段

响应示例（仅说明结构）

获取抖音搜索建议

请求参数

请求示例

返回字段

响应示例（仅说明结构）

搜索抖音作品

请求参数

请求示例

返回字段

响应示例（仅说明结构）

搜索抖音用户

请求参数

请求示例

返回字段

响应示例（仅说明结构）

搜索抖音商品

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音商品详情

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音作品详情

请求参数

请求示例

返回字段

响应示例（仅说明结构）

生成抖音作品分享链接

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音作品一级评论

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音评论回复

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音用户资料

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音用户作品列表

请求参数

请求示例

返回字段

响应示例（仅说明结构）

读取抖音用户短剧列表

请求参数

请求示例

返回字段

响应示例（仅说明结构）

鉴权与在线测试

机器可读入口

公共 API Catalog

OpenAPI JSON

Docs MCP

Docs MCP Server Card