前往注册开通
onebound.douyin.item_search_video
公共参数
名称 | 类型 | 必须 | 描述 |
key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数：q=菜谱&page=1&sort=
参数说明：q:关键词,
page:页数
sort:排序:sort=new 最新发布 sort=credit 最多点赞 sort=bid 综合排序\
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
items | items[] | 0 | 按关键字搜索视频 | |
page | Int | 0 | 1 | 页码 |
real_total_results | Int | 0 | 1900 | 视频数量 |
total_results | Int | 0 | 1900 | 视频数量 |
page_size | Int | 0 | 20 | 接口返回数量 |
pagecount | Int | 0 | 120 | 总页数 |
item | item[] | 0 | 视频详情数据 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/douyin/item_search_video/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=菜谱&page=1&sort="响应示例
{
"page": "2",
"real_total_results": 100,
"total_results": 100,
"page_size": 10,
"pagecount": 10,
"item": [
{
"title": "青椒五花肉土豆片，试下我的这个做法，变大厨#为江西美食打call #为城市美食打call #77抖音嗨吃节",
"num_iid": "6720797448752663819",
"nick": "皮皮（教做菜）",
"signature": "如何查询订单物流呢：方法是，打开抖音，点击我，点击右上角三杠，点我的订单，查找物流即可[微笑] 有任何售后问题请联系对应的客服输入人工💁💁♂️ 宝妈自用厨具和食材在橱窗👆👆👆",
"city": "360400",
"uid": "93189025747",
"detail_url": "https://www.iesdouyin.com/share/video/6720797448752663819/?region=CN&mid=6720832362042657547&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "猪肉那么贵，不如用鸡蛋代替，这样做的鱼香鸡蛋比肉还好吃 #美食 #家常菜",
"num_iid": "6804735432291552525",
"nick": "家常美食-白糖",
"signature": "家常美食，每天分享！ 感谢关注我的每一位朋友🙏🙏",
"city": "131000",
"uid": "78955618549",
"detail_url": "https://www.iesdouyin.com/share/video/6804735432291552525/?region=CN&mid=6804730383398701831&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "如何零失败在家做出厨师级别的蛋包饭！#跟着抖音学做菜 #厨师吃饭和你吃饭的区别",
"num_iid": "7086011452871462174",
"nick": "阿男的食谱",
"signature": "阿男哥努力点！ 商务V：AnanACookbook",
"city": "330200",
"uid": "108592079249",
"detail_url": "https://www.iesdouyin.com/share/video/7086011452871462174/?region=CN&mid=7032289262364396301&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "你要是学会了这个爆炒青椒鸡，以后就是你的拿手菜，做法真的很简单#家常菜",
"num_iid": "7023287094181154082",
"nick": "皮皮（教做菜）",
"signature": "如何查询订单物流呢：方法是，打开抖音，点击我，点击右上角三杠，点我的订单，查找物流即可[微笑] 有任何售后问题请联系对应的客服输入人工💁💁♂️ 宝妈自用厨具和食材在橱窗👆👆👆",
"city": "430100",
"uid": "93189025747",
"detail_url": "https://www.iesdouyin.com/share/video/7023287094181154082/?region=CN&mid=7023287179128474382&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "杏鲍菇像我这样做，简单下饭全家人抢着吃！#杏鲍菇做法 #鱼香杏鲍菇",
"num_iid": "7033656036061973767",
"nick": "爱做菜",
"signature": "👆同款自用厨具和食材都在橱窗",
"city": "350500",
"uid": "101626266989",
"detail_url": "https://www.iesdouyin.com/share/video/7033656036061973767/?region=CN&mid=7033656068571974437&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "我送你个黄焖鸡的菜谱，保证你从年头吃到年尾！ #贫穷料理 #在家做个拿手菜",
"num_iid": "6794253027449572622",
"nick": "安秋金",
"signature": "酷爱人间烟火和美食的山西小伙小安 愿你的笑容永远灿烂，记得按时吃饭❤️ 围脖🧣：安秋金 粉丝👗：PQLL888 🤝：qjsmjb 【中华名厨】拜访顶尖名厨，弘扬华夏美食，在家也可以做出“名厨味”。 【贫穷料理】家常小灶，也可做出诱人珍馐，有限的条件，也可绽放无限美味。 【天赐美味】探寻天地间诞生的“美味”，是烟火下的碰撞，也是大自然的赏赐。",
"city": "350200",
"uid": "86352854043",
"detail_url": "https://www.iesdouyin.com/share/video/6794253027449572622/?region=CN&mid=6794223194355043086&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "晚上不知道吃什么？试试这个超简单又下饭的家常菜#美食 #家常菜 #抖音美食创作人 @抖音小助手",
"num_iid": "6976541281384205604",
"nick": "素素小厨娘",
"signature": "爱生活 爱美食 用心烹饪🍳为爱分享❤️ 同款厨具和食材在橱窗哟👇 💌：x804669085",
"city": "440200",
"uid": "382237371544059",
"detail_url": "https://www.iesdouyin.com/share/video/6976541281384205604/?region=CN&mid=6876310394965608462&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
},
{
"title": "不知道吃什么的时候，一定要试试这个，真的太下饭了#下饭菜 #家常菜",
"num_iid": "6994718643774885123",
"nick": "家常美食-白糖",
"signature": "家常美食，每天分享！ 感谢关注我的每一位朋友🙏🙏",
"city": "131000",
"uid": "78955618549",
"detail_url": "https://www.iesdouyin.com/share/video/6994718643774885123/?region=CN&mid=6977340591998797826&u_code=0&did=MS4wLjABAAAAX6SKLXd2Lhcq6lJs-ZZht-4CQnWa4T6RXKP64yizXmWan85yYUKipuIuEZe2WGq2&iid=MS4wLjABAAAA4bKcTfevXRsOtcSzYpaDjUh6OqMXnLsEcwkNwvSMl_Qv6i-TX58sQcdEqZpCdWoD&with_sec_did=1&titleType=title"
}
],
"_ddf": "app",
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today: max:10000",
"execution_time": "2.563",
"server_time": "Beijing/2022-05-19 11:22:45",
"client_ip": "127.0.0.1",
"call_args": [],
"api_type": "douyin",
"translate_language": "zh-CN",
"translate_engine": "baidu_api",
"server_memory": "3.42MB",
"last_id": false
}异常示例相关资料错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功，但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
