Tiktok 接口

Tiktok 接口

wpchell 303 2024-12-20

接口说明

  • 请确保所有请求均携带有效的token参数(各平台唯一)。

  • 接口统一返回JSON格式数据,重点关注message字段:值为"请求成功"表示成功;其他值请根据其提示排查错误。

  • 当响应中cost=true时,表示请求已生效并计费,即使遇到错误(如资源失效404),也请勿重复尝试。

  • 对于Tiktok接口,由于其响应时间较长,强烈建议设置超时(timeout)不少于30秒,以避免因超时误判导致重复请求扣费。​

测试token

token: 请联系管理员开通 q:1098441010 vx:pchell11

余额查询

请求示例
http://43.134.116.51:10002/tiktok/get_user_balance/?token=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

响应
{
    "cost": false,
    "data": {
        "count": 9999.0
    },
    "message": "请求成功"
}
其他说明

用户信息

请求示例
http://43.134.116.51:10002/tiktok/user_info/?token=&entity=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

entity

用户名/secUid/主页url

-

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

如果在国内服务器建议使用用户名secUid 获取用户信息,主页url由于带tiktok.com的域名在国内访问可能会被运营商直接拦截。如果一定要使用url获取用户信息,可以改用post请求,请求curl示例如下:

curl --location 'http://43.134.116.51:10002/tiktok/user_info/?token=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'entity=***'

用户作品列表

请求示例
http://43.134.116.51:10002/tiktok/user_video/?token=&sec_uid&=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

sec_uid

用户名

用户信息接口返回

cursor

翻页参数

取前一页返回值(cursor)

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

评论

请求示例
http://43.134.116.51:10002/tiktok/comment/?token=&aweme_id=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

aweme_id

用户名

用户作品接口返回(id)

cursor

翻页参数

取前一页返回(cursor)

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

按照tiktok页面展示结果排序

回复

请求示例
http://43.134.116.51:10002/tiktok/reply/?token=&aweme_id=&comment_id=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

aweme_id

用户名

用户作品接口返回(id)

comment_id

评论id

评论接口返回(cid)

cursor

翻页参数

取前一页返回(cursor)

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

按照tiktok页面展示结果排序

作品搜索

请求示例
http://43.134.116.51:10002/tiktok/search/?token=&keyword=&search_id=&search_type=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

search_id

搜索id

从前一页返回(extra.logid),翻页必须要传

sort_type

排序方式

0:相关性 1:点赞次数 3:发布日期

0

cursor

翻页参数

取前一页返回(cursor)

空,默认返回第一页

search_type

搜索类型

general:综合 user:用户 item:视频

general

region

国家

国家列表见文档末尾

us

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

搜索类型不同返回的响应有差异,在解析清洗时需要处理

目前tiktok搜索结果想获取更多的最新发布视频需要传入 search_type=item,搜索视频

另外region不同返回结果会有差异, 经过我们大量测试region选择美国可以覆盖大部分贴文数据

作品详情

请求示例
http://43.134.116.51:10002/tiktok/video_detail/?token=&url=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

url

作品链接

-

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

如果是使用国内服务器调用API接口建议使用post请求,作品url由于带tiktok.com的域名在国内访问可能会被运营商直接拦截,curl请求示例如下:

curl --location 'http://43.134.116.51:10002/tiktok/video_detail/?token=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'url=***'

话题详情

请求示例
http://43.134.116.51:10002/tiktok/tag_detail/?token=&tag_name=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

tag_name

话题名称

不能带#号

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

话题作品列表

请求示例
http://43.134.116.51:10002/tiktok/tag_video/?token=&tag_id=&cursor=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

tag_id

话题id

从话题详情中获取

cursor

翻页参数

前一页返回(cursor)

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # tiktok数据
     },
     "message": "请求成功"
}
其他说明

按照tiktok页面展示结果排序

附录:国家列表

{
  "毛里塔尼亚": "mr",
  "苏里南": "sr",
  "马里": "ml",
  "海地共和国": "ht",
  "几内亚比绍": "gw",
  "加蓬": "ga",
  "马其顿": "mk",
  "白俄罗斯": "by",
  "波多黎各": "pr",
  "克罗地亚": "hr",
  "匈牙利": "hu",
  "印度": "in",
  "危地马拉": "gt",
  "奥地利": "at",
  "柬埔寨": "kh",
  "文莱": "bn",
  "马达加斯加": "mg",
  "韩国": "kr",
  "加拿大": "ca",
  "加纳": "gh",
  "摩洛哥": "ma",
  "摩尔多瓦": "md",
  "泽西岛": "je",
  "巴拿马": "pa",
  "波黑": "ba",
  "缅甸": "mm",
  "伊朗": "ir",
  "圭亚那": "gy",
  "马耳他": "mt",
  "阿联酋": "ae",
  "西班牙": "es",
  "尼日利亚": "ng",
  "莱索托": "ls",
  "安提瓜和巴布达": "ag",
  "巴基斯坦": "pk",
  "孟加拉国": "bd",
  "圣基茨和尼维斯": "kn",
  "马拉维": "mw",
  "委内瑞拉": "ve",
  "中国香港": "hk",
  "佛得角共和国": "cv",
  "洪都拉斯": "hn",
  "土库曼斯坦": "tm",
  "美国": "us",
  "捷克共和国": "cz",
  "利比亚": "ly",
  "英国": "gb",
  "哈萨克斯坦": "kz",
  "意大利": "it",
  "巴林": "bh",
  "塞内加尔": "sn",
  "芬兰": "fi",
  "哥伦比亚": "co",
  "荷属圣马丁": "sx",
  "百慕大": "bm",
  "斐济群岛": "fj",
  "库拉索": "cw",
  "圣多美和普林西比": "st",
  "博茨瓦纳": "bw",
  "法国": "fr",
  "巴巴多斯": "bb",
  "多哥": "tg",
  "科特迪瓦": "ci",
  "格林纳达": "gd",
  "尼日尔共和国": "ne",
  "贝宁": "bj",
  "新西兰": "nz",
  "塞尔维亚": "rs",
  "多米尼加": "do",
  "智利": "cl",
  "黎巴嫩": "lb",
  "荷兰": "nl",
  "留尼汪": "re",
  "阿鲁巴": "aw",
  "乌干达": "ug",
  "萨尔瓦多": "sv",
  "阿根廷": "ar",
  "约旦": "jo",
  "保加利亚": "bg",
  "巴布亚新几内亚": "pg",
  "日本": "jp",
  "卢旺达": "rw",
  "巴拉圭": "py",
  "蒙古国": "mn",
  "厄瓜多尔": "ec",
  "乌兹别克斯坦": "uz",
  "罗马尼亚": "ro",
  "古巴": "cu",
  "关岛": "gu",
  "科索沃": "xk",
  "叙利亚": "sy",
  "索马里": "so",
  "赞比亚共和国": "zm",
  "坦桑尼亚": "tz",
  "尼加拉瓜": "ni",
  "塞舌尔共和国": "sc",
  "马来西亚": "my",
  "法属圭亚那": "gf",
  "纳米比亚": "na",
  "中国": "cn",
  "津巴布韦": "zw",
  "老挝": "la",
  "埃塞俄比亚": "et",
  "安哥拉": "ao",
  "乌克兰": "ua",
  "阿曼": "om",
  "尼泊尔": "np",
  "墨西哥": "mx",
  "莫桑比克": "mz",
  "多米尼加共和国": "dm",
  "也门": "ye",
  "直布罗陀": "gi",
  "哥斯达黎加": "cr",
  "喀麦隆": "cm",
  "菲律宾": "ph",
  "亚美尼亚": "am",
  "泰国": "th",
  "瑞士": "ch",
  "巴西": "br",
  "苏丹": "sd",
  "爱尔兰": "ie",
  "玻利维亚": "bo",
  "巴哈马": "bs",
  "TC": "tc",
  "英属维尔京群岛": "vg",
  "秘鲁": "pe",
  "沙特阿拉伯": "sa",
  "丹麦": "dk",
  "突尼斯": "tn",
  "爱沙尼亚": "ee",
  "牙买加": "jm",
  "圣卢西亚": "lc",
  "葡萄牙": "pt",
  "卡塔尔": "qa",
  "格鲁吉亚": "ge",
  "巴勒斯坦": "ps",
  "斯洛伐克": "sk",
  "塞浦路斯": "cy",
  "刚果(布)": "cg",
  "阿塞拜疆": "az",
  "阿尔巴尼亚": "al",
  "中国台湾": "tw",
  "冈比亚": "gm",
  "马提尼克": "mq",
  "新喀里多尼亚": "nc",
  "科威特": "kw",
  "塔吉克斯坦": "tj",
  "以色列": "il",
  "刚果金": "cd",
  "吉尔吉斯斯坦": "kg",
  "挪威": "no",
  "毛里求斯": "mu",
  "土耳其": "tr",
  "俄罗斯": "ru",
  "乌拉圭": "uy",
  "希腊": "gr",
  "中国澳门": "mo",
  "马约特": "yt",
  "马恩岛": "im",
  "比利时": "be",
  "南非": "za",
  "根西岛": "gg",
  "特立尼达和多巴哥": "tt",
  "不丹": "bt",
  "阿富汗": "af",
  "拉脱维亚": "lv",
  "卢森堡": "lu",
  "几内亚": "gn",
  "赤道几内亚": "gq",
  "斯洛文尼亚": "si",
  "利比里亚": "lr",
  "新加坡": "sg",
  "伊拉克": "iq",
  "肯尼亚": "ke",
  "冰岛": "is",
  "塞拉利昂": "sl",
  "布基纳法索": "bf",
  "瓜德罗普": "gp",
  "开曼群岛": "ky",
  "越南": "vn",
  "阿尔及利亚": "dz",
  "德国": "de",
  "美属维尔京群岛": "vi",
  "安道尔公国": "ad",
  "印度尼西亚": "id",
  "澳大利亚": "au",
  "法属圣马丁": "mf",
  "圣文森特岛": "vc",
  "波兰": "pl",
  "黑山": "me",
  "埃及": "eg",
  "伯利兹": "bz",
  "斯里兰卡": "lk",
  "立陶宛": "lt",
  "瑞典": "se",
  "科摩罗": "km",
  "马尔代夫": "mv",
  "吉布提国家": "dj",
  "东帝汶": "tl",
  "南苏丹": "ss",
  "斯威士兰": "sz",
  "所罗门群岛": "sb",
  "列支敦士登": "li"
}