TikTok获取用户主页作品数据

最低 ¥0.03/次起即将上线需配置 API Key

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

POSThttps://redfox.hk/story/api/tiktok/ability/userAwemeList

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/tiktok/ability/userAwemeList

请求头

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

请求参数

参数类型必填说明示例
secUserIdString是用户ID（sec_user_id）MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM

返回值与结构

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

响应字段

字段类型说明示例
areaString地区US
authorDataObject作者数据
avatarImageString作者头像https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14635&refresh_token=069fb70b&x-expires=1784959200&x-signature=fxtB9ysU7oC4Fq1icidgTppmvEc%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my
enterpriseVerifyString企业认证信息verified account
fansCountInteger粉丝数94941479
followCountInteger关注数0
likedTotalInteger获赞总数462022992
secUserIdString作者secUidMS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM
userAreaString作者地区US
userHandleString作者唯一ID（handle）tiktok
userIdString作者UID107955
userNameString作者昵称TikTok
userSignatureString作者签名One TikTok can make a big impact
verifyInfoString认证信息
workCountInteger作品数1557
contentString作品描述@Josh Groban on authentically sharing the process, catch more on In The Mix with Jack Coyne, presented by @T-Mobile
mediaTypeString内容类型（video/photo等）video
musicDataObject音乐数据
musicAlbumString专辑
musicAuthorString音乐作者TikTok
musicCoverImageString音乐封面https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14635&refresh_token=069fb70b&x-expires=1784959200&x-signature=fxtB9ysU7oC4Fq1icidgTppmvEc%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my
musicDurationInteger音乐时长（秒）47
musicIdString音乐ID7665823386462849822
musicPlayAddressString音乐播放地址https://v16-ies-music.tiktokcdn.com/af1569d22cf8a126b26e5fdb571b7e84/6a6c470e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oUAxvS4fJqEYDVEJB7DEJnFnAd9YAC6IRKeAIU/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=h7HmoMU2sffSd.wS427KhML4XinedLr8lpkfx4kFEoBvwvjThW&mime_type=audio_mpeg&rc=M3JwZ3c5cm46PDMzaTU8NEBpM3JwZ3c5cm46PDMzaTU8NEByNnMxMmRrZ2VhLS1kMTJzYSNyNnMxMmRrZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00050000&shp=d05b14bd&shcp=-
musicTitleString音乐标题原声 - TikTok
originalSoundFlagBoolean是否原创声音true
publishTimeInteger发布时间戳（秒）1784838608
shareLinkString分享链接https://www.tiktok.com/@tiktok/video/7665823355194363167?_r=1&u_code=0&preview_pb=0&sharer_language=zh-Hans&_d=eg2323i296h2m2&share_item_id=7665823355194363167&source=h5_m
statsDataObject统计数据
commentTotalInteger评论数274
downloadTotalInteger下载数1
favoriteCountInteger收藏数322
forwardTotalInteger转发数0
likeCountInteger点赞数5687
repostTotalInteger转载数0
shareTotalInteger分享数20
viewCountInteger播放数889358
whatsappShareTotalIntegerWhatsApp分享数0
videoDataObject视频数据
coverImageString封面图https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o4ETfZcnAAAlANcsAILeE8oGfepq85eIgiSDEQ~tplv-tiktokx-cropcenter-q:300:400:q72.webp?dr=16276&refresh_token=b909cb3c&x-expires=1784959200&x-signature=H9YVfb52hCs92o%2FOlS9VgrndRhE%3D&t=5872c671&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=cover
definitionString清晰度720p
downloadAddressString下载地址（带水印）https://v16me.tiktokcdn.com/680fafc5ded6e09ebbccdcc9b9ce39b7/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/osKIuMUIEeQGHCl8AvqePeI6LIAjbgxjDc96GQ/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=576&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=OmQ5aGlmOjg4OWY8aTllM0BpMztlZXI5cjg6PDMzaTczNEA0XjMxMDAzNjExM2M0MTZiYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000
downloadNoMarkAddressString无水印下载地址https://v16me.tiktokcdn.com/3c0e5e79d7ef4e57ebdf2422c19c603f/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/oElEvQAxeAQc5MTfgGjUe8Cc8IIqLIs96PHILj/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=659&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=NDM4OTU1aGk0NjU5OGVlOEBpMztlZXI5cjg6PDMzaTczNEA1LTZhLV8yX2ExX2JfMi0yYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000
dynamicCoverImageString动态封面图https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o4ETfZcnAAAlANcsAILeE8oGfepq85eIgiSDEQ~tplv-tiktokx-origin.webp?dr=16282&refresh_token=2f9b900f&x-expires=1784959200&x-signature=X8%2FKkUOzS0toSF6cOESqv71AUjE%3D&t=5872c671&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover
originCoverImageString原始封面图https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oU6Qd9QeIGexlq9EicLjAMQIjAjNCPveIkCU5P~tplv-tiktokx-360p.webp?dr=16286&refresh_token=8541d291&x-expires=1784959200&x-signature=X7c2hwQQeIH%2F%2BptFp9IXFBH%2FFUA%3D&t=5872c671&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=feed_cover
playAddressString播放地址https://v16me.tiktokcdn.com/3c0e5e79d7ef4e57ebdf2422c19c603f/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/oElEvQAxeAQc5MTfgGjUe8Cc8IIqLIs96PHILj/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=659&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=NDM4OTU1aGk0NjU5OGVlOEBpMztlZXI5cjg6PDMzaTczNEA1LTZhLV8yX2ExX2JfMi0yYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000
playDurationInteger视频时长（毫秒）47798
videoHeightInteger视频高度1920
videoWidthInteger视频宽度1080
watermarkFlagBoolean是否有水印true
workIdString作品ID7665823355194363167
workTypeInteger作品类型0

请求示例

请求参数：
{
  "secUserId": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
}

响应示例

{
  "code": 2000,
  "data": [
    {
      "area": "US",
      "authorData": {
        "avatarImage": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14635&refresh_token=069fb70b&x-expires=1784959200&x-signature=fxtB9ysU7oC4Fq1icidgTppmvEc%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my",
        "enterpriseVerify": "verified account",
        "fansCount": 94941479,
        "followCount": 0,
        "likedTotal": 462022992,
        "secUserId": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
        "userArea": "US",
        "userHandle": "tiktok",
        "userId": "107955",
        "userName": "TikTok",
        "userSignature": "One TikTok can make a big impact",
        "verifyInfo": "",
        "workCount": 1557
      },
      "content": "@Josh Groban on authentically sharing the process, catch more on In The Mix with Jack Coyne, presented by @T-Mobile ",
      "mediaType": "video",
      "musicData": {
        "musicAlbum": "",
        "musicAuthor": "TikTok",
        "musicCoverImage": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14635&refresh_token=069fb70b&x-expires=1784959200&x-signature=fxtB9ysU7oC4Fq1icidgTppmvEc%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my",
        "musicDuration": 47,
        "musicId": "7665823386462849822",
        "musicPlayAddress": "https://v16-ies-music.tiktokcdn.com/af1569d22cf8a126b26e5fdb571b7e84/6a6c470e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oUAxvS4fJqEYDVEJB7DEJnFnAd9YAC6IRKeAIU/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=h7HmoMU2sffSd.wS427KhML4XinedLr8lpkfx4kFEoBvwvjThW&mime_type=audio_mpeg&rc=M3JwZ3c5cm46PDMzaTU8NEBpM3JwZ3c5cm46PDMzaTU8NEByNnMxMmRrZ2VhLS1kMTJzYSNyNnMxMmRrZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00050000&shp=d05b14bd&shcp=-",
        "musicTitle": "原声 - TikTok",
        "originalSoundFlag": true
      },
      "publishTime": 1784838608,
      "shareLink": "https://www.tiktok.com/@tiktok/video/7665823355194363167?_r=1&u_code=0&preview_pb=0&sharer_language=zh-Hans&_d=eg2323i296h2m2&share_item_id=7665823355194363167&source=h5_m",
      "statsData": {
        "commentTotal": 274,
        "downloadTotal": 1,
        "favoriteCount": 322,
        "forwardTotal": 0,
        "likeCount": 5687,
        "repostTotal": 0,
        "shareTotal": 20,
        "viewCount": 889358,
        "whatsappShareTotal": 0
      },
      "videoData": {
        "coverImage": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o4ETfZcnAAAlANcsAILeE8oGfepq85eIgiSDEQ~tplv-tiktokx-cropcenter-q:300:400:q72.webp?dr=16276&refresh_token=b909cb3c&x-expires=1784959200&x-signature=H9YVfb52hCs92o%2FOlS9VgrndRhE%3D&t=5872c671&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=cover",
        "definition": "720p",
        "downloadAddress": "https://v16me.tiktokcdn.com/680fafc5ded6e09ebbccdcc9b9ce39b7/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/osKIuMUIEeQGHCl8AvqePeI6LIAjbgxjDc96GQ/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=576&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=OmQ5aGlmOjg4OWY8aTllM0BpMztlZXI5cjg6PDMzaTczNEA0XjMxMDAzNjExM2M0MTZiYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000",
        "downloadNoMarkAddress": "https://v16me.tiktokcdn.com/3c0e5e79d7ef4e57ebdf2422c19c603f/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/oElEvQAxeAQc5MTfgGjUe8Cc8IIqLIs96PHILj/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=659&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=NDM4OTU1aGk0NjU5OGVlOEBpMztlZXI5cjg6PDMzaTczNEA1LTZhLV8yX2ExX2JfMi0yYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000",
        "dynamicCoverImage": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o4ETfZcnAAAlANcsAILeE8oGfepq85eIgiSDEQ~tplv-tiktokx-origin.webp?dr=16282&refresh_token=2f9b900f&x-expires=1784959200&x-signature=X8%2FKkUOzS0toSF6cOESqv71AUjE%3D&t=5872c671&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover",
        "originCoverImage": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oU6Qd9QeIGexlq9EicLjAMQIjAjNCPveIkCU5P~tplv-tiktokx-360p.webp?dr=16286&refresh_token=8541d291&x-expires=1784959200&x-signature=X7c2hwQQeIH%2F%2BptFp9IXFBH%2FFUA%3D&t=5872c671&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=my&biz_tag=tt_video&s=PUBLISH&sc=feed_cover",
        "playAddress": "https://v16me.tiktokcdn.com/3c0e5e79d7ef4e57ebdf2422c19c603f/6a6455cf/video/tos/alisg/tos-alisg-ve-37c799-sg/oElEvQAxeAQc5MTfgGjUe8Cc8IIqLIs96PHILj/?a=1340&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=659&ft=yzHih9DfxxOusQOFDnL76GFpA-JuGbySc_xwF_EKZH2Q2Nz7T&mime_type=video_mp4&rc=NDM4OTU1aGk0NjU5OGVlOEBpMztlZXI5cjg6PDMzaTczNEA1LTZhLV8yX2ExX2JfMi0yYSM0cW5zMmRzZ2VhLS1kMTJzcw%3D%3D&vvpl=1&l=20260724142016B1D81FEC0A4BFF6CA6D4&btag=e00088000",
        "playDuration": 47798,
        "videoHeight": 1920,
        "videoWidth": 1080,
        "watermarkFlag": true
      },
      "workId": "7665823355194363167",
      "workType": 0
    }
  ],
  "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操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。