获取抖音账号作品列表 (广域库)

广域库T+1最低 ¥0.02/次起即将上线需配置 API Key

抖音按账号获取内容列表

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/dy/data/listWorkByAccount

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

  1. 前往控制台页面，进入 API 密钥管理模块。
  2. 若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
  3. 在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/dy/data/listWorkByAccount

请求头

名称类型必填说明示例
REDFOX_API_KEYstring是平台鉴权令牌，每次请求必填ak_xxxxxx
Content-Typestring是请求体数据类型application/json

请求参数

参数类型必填说明示例
userIdString否账号主键id / uid（userId / uniqueName / shortId 三选一必填）3822358551859599
uniqueNameString否账号平台展示id（三选一必填）luoyonghao
shortIdString否账号平台展示id-short（三选一必填）
pageNumInteger否页码（从1开始，默认1）1
pageSizeInteger否每页大小（默认10，最大50）10
startDateString否开始时间2026-07-01
endDateString否结束时间2026-07-20

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段类型说明示例
listArray数据列表
authorAvatarUrlString作者头像
authorFansCountString作者粉丝数
authorNameString作者昵称
authorSecUidString作者sec_uid
authorShortIdString作者抖音short_id
authorUidString作者id
authorUniqueIdString作者抖音unique_id
collectCountInteger收藏数
commentCountInteger评论数
contentString作品正文/描述
coverUrlString作品封面链接
durationInteger作品时长-毫秒
imageUrlListArray图片列表-图文作品
likeCountInteger点赞数
opusUrlString作品链接
publishTimeString作品发布时间
shareCountInteger分享数
tagListArray话题列表
tagIdString话题id
tagNameString话题名称
videoIdString作品id
videoTypeString作品类型 ：0=普通视频, 68=图集, 63=直播录屏等
pageNumInteger当前页码
pageSizeInteger每页大小
totalInteger总记录数

请求示例

请求参数：
{
  "userId": "3822358551859599",
  "uniqueName": "luoyonghao",
  "pageNum": 1,
  "pageSize": 10
}

响应示例

{
  "code": 2000,
  "data": {
    "list": [
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 89,
        "commentCount": 85,
        "content": "无论有没有文化，都推荐小奇和张骏的播客：《有没有文化现象》。 \n@张骏 @脱口秀小奇",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/0905ee9f8ef0469583bdd3f24a692199~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=%2BwrL8p4daOsNux6uN95TWw%2FLQro%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 39253,
        "imageUrlList": [],
        "likeCount": 1199,
        "opusUrl": "https://www.iesdouyin.com/share/video/7663047997038644499",
        "publishTime": "2026-07-16 17:00:07",
        "shareCount": 59,
        "tagList": [],
        "videoId": "7663047997038644499",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 6984,
        "commentCount": 613,
        "content": "【正片】罗永浩的X字路口！一年一度装x大会 #罗永浩的精选 #视频播客扶持计划  @抖音精选官方账号",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/8a1618ad1e0842959afc8125e7c884e0~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=lIOZPWiFs5NFgOme9CzZeJ%2BTmmE%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 10983574,
        "imageUrlList": [],
        "likeCount": 16474,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662616607201496330",
        "publishTime": "2026-07-15 17:22:43",
        "shareCount": 3329,
        "tagList": [
          {
            "tagId": "7578774248387250222",
            "tagName": "视频播客扶持计划"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7662616607201496330",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 79,
        "commentCount": 116,
        "content": "小奇想象中张骏的生活：装气满满的一天。7月15日，记得来看这期《罗永浩的X字路口》。 \n#抖音精选  #罗永浩的精选  @抖音精选官方账号  #脱口秀",
        "coverUrl": "https://p9-pc-sign.douyinpic.com/tos-cn-i-dy/c142ad4a2fcd47f69ea48225d0ce39ba~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=C3Jy3uob%2BUkCSWenr%2FoNu54WTvI%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 20459,
        "imageUrlList": [],
        "likeCount": 1082,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662361634068778286",
        "publishTime": "2026-07-15 11:00:00",
        "shareCount": 51,
        "tagList": [
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          },
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "1570355740748801",
            "tagName": "脱口秀"
          }
        ],
        "videoId": "7662361634068778286",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 380,
        "commentCount": 152,
        "content": "脱口秀圈公认最装的人，居然是他......7月15日，记得来看这期《罗永浩的X字路口》。 \n#抖音精选  #罗永浩的精选  @抖音精选官方账号  #脱口秀",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/8566b9e9af734d4e8327ab164b47028e~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=3dwBZs7AxKjwSVUxdKnTvbV9CT4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 17003,
        "imageUrlList": [],
        "likeCount": 3267,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662361126260215092",
        "publishTime": "2026-07-15 10:00:00",
        "shareCount": 147,
        "tagList": [
          {
            "tagId": "1570355740748801",
            "tagName": "脱口秀"
          },
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7662361126260215092",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 257,
        "commentCount": 77,
        "content": "一年一度装逼大赛：谁是最能装的人？7月15日，记得来看这期《罗永浩的X字路口》。 \n#抖音精选  #罗永浩的精选  @抖音精选官方账号  #脱口秀",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/4d4b7b08e2c94cbe87b7bd01ed0bc990~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=i8erZ2mxkCJZOYk6ElnRBsg3kMw%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 19414,
        "imageUrlList": [],
        "likeCount": 1878,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662306734085508402",
        "publishTime": "2026-07-14 18:00:07",
        "shareCount": 544,
        "tagList": [
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          },
          {
            "tagId": "1570355740748801",
            "tagName": "脱口秀"
          }
        ],
        "videoId": "7662306734085508402",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 116,
        "commentCount": 43,
        "content": "高级装x犯小奇：披着中专外衣的张骏。7月15日，记得来看这期《罗永浩的X字路口》。 \n#抖音精选  #罗永浩的精选  @抖音精选官方账号  #脱口秀",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/ad059e0824c54efa918dc892132632ce~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=1BDSIJvCPt2CE4UPDZLOV4T70OM%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 37483,
        "imageUrlList": [],
        "likeCount": 1067,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662274941349399834",
        "publishTime": "2026-07-14 15:00:12",
        "shareCount": 94,
        "tagList": [
          {
            "tagId": "1570355740748801",
            "tagName": "脱口秀"
          },
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7662274941349399834",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 36,
        "commentCount": 43,
        "content": "是什么，把小奇逼得当场发这么毒的毒誓？7月15日，记得来看这期《罗永浩的X字路口》。\n#抖音精选  #罗永浩的精选  @抖音精选官方账号  #脱口秀",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/64ad51260ab5457f8709c6a7556a980d~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2100024000&x-signature=3voXJSsy2Fw0q4ipcQuZFcM0%2B6Q%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=2026072204413329A20C441D9E4877E092",
        "duration": 32086,
        "imageUrlList": [],
        "likeCount": 579,
        "opusUrl": "https://www.iesdouyin.com/share/video/7662229347914370323",
        "publishTime": "2026-07-14 12:03:18",
        "shareCount": 11,
        "tagList": [
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          },
          {
            "tagId": "1570355740748801",
            "tagName": "脱口秀"
          }
        ],
        "videoId": "7662229347914370323",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 2190,
        "commentCount": 570,
        "content": "【正片】罗永浩的X字路口！如果可以，你会删除伴侣出轨的记忆吗 #抖音精选  #罗永浩的精选  @抖音精选官方账号",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/99880eb2bb574928be1f25eae8b029d3~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2099682000&x-signature=I4NHGWxYTztlX0W9F1SA%2FT4h%2Bg0%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=20260718050339C6057956A5DC98097622",
        "duration": 7929409,
        "imageUrlList": [],
        "likeCount": 5495,
        "opusUrl": "https://www.iesdouyin.com/share/video/7660775531671014708",
        "publishTime": "2026-07-10 14:55:32",
        "shareCount": 863,
        "tagList": [
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7660775531671014708",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:188:188.jpeg?from=2956013662",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 152,
        "commentCount": 151,
        "content": "老罗抽自己嘴巴竟然是这个原因......7月10日，别忘了收看这期《罗永浩的X字路口》。\n#抖音精选  #罗永浩的精选  @抖音精选官方账号",
        "coverUrl": "https://p9-pc-sign.douyinpic.com/image-cut-tos-priv/c248afd31abfcfcebe26aabf9fc2662f~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2099678400&x-signature=AaZtCXUzPDl2%2BdZc6UHp9VNXjlk%3D&from=327834062&s=PackSourceEnum_WEBPC_RELATED_AWEME&se=false&sc=cover&biz_tag=pcweb_cover&l=202607180457582CD2052FD43D51563B2C",
        "duration": 24043,
        "imageUrlList": [],
        "likeCount": 2277,
        "opusUrl": "https://www.iesdouyin.com/share/video/7660186261373734180",
        "publishTime": "2026-07-09 14:00:00",
        "shareCount": 211,
        "tagList": [
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7660186261373734180",
        "videoType": "0"
      },
      {
        "authorAvatarUrl": "https://p3-pc.douyinpic.com/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5~tplv-dy-shrink:96:96.jpeg?from=327834062",
        "authorName": "罗永浩的十字路口",
        "authorSecUid": "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0",
        "authorShortId": "0",
        "authorUid": "3822358551859599",
        "authorUniqueId": "luoyonghao",
        "collectCount": 3220,
        "commentCount": 4338,
        "content": "伴侣出轨了，但你俩都不想分手......7月10日，记得来看这期《罗永浩的X字路口》。 \n#抖音精选  #罗永浩的精选  @抖音精选官方账号",
        "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/d902a0a0948a4e329595255a302a855d~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2099592000&x-signature=%2B8fj%2FoULaO3JQv8RRao5IxvxTWM%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202607170423198B968DFDF6245F3F13B1",
        "duration": 26966,
        "imageUrlList": [],
        "likeCount": 20124,
        "opusUrl": "https://www.iesdouyin.com/share/video/7660185834255043876",
        "publishTime": "2026-07-09 10:00:00",
        "shareCount": 10203,
        "tagList": [
          {
            "tagId": "1568943621383170",
            "tagName": "抖音精选"
          },
          {
            "tagId": "7538657181571237924",
            "tagName": "罗永浩的精选"
          }
        ],
        "videoId": "7660185834255043876",
        "videoType": "0"
      }
    ],
    "pageNum": 1,
    "pageSize": 10,
    "total": 183
  },
  "msg": "成功"
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码说明排查建议
400请求参数错误检查请求体、Query 参数是否与文档一致，必填项是否齐全。
401鉴权失败确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
403无权限访问当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
500系统内部错误服务端异常，请稍后重试；持续出现请联系技术支持。
503服务暂不可用服务维护或短暂过载，请间隔一段时间后重试。
1001缺少必要参数对照「请求参数」表，补全必填字段。
1002参数格式不正确检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
1003参数类型错误确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
3103密钥不存在密钥可能已删除或填写错误，请前往控制台核对并重新复制。
3105API Key 已禁用在控制台启用该密钥，或创建新密钥后替换请求头中的值。
3201积分不足账户余额不足以支付本次调用，请前往控制台充值后再试。
3202积分账户不存在账号积分账户异常，请登录控制台确认账户状态。
4004操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。