item_get_video-获取抖音视频详情
douyin.item_get_video
公共参数
请求地址: https://api-gw-4.cn/douyin/item_get_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版本 |
请求参数
请求参数:item_id=7092264344980868359
参数说明:item_id:视频id,
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 0 | 视频详情数据 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/douyin/item_get_video/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&item_id=7092264344980868359"
响应示例
{ "item": { "num_iid": "7092264344980868359", "detail_url": "https://www.iesdouyin.com/share/video/7092264344980868359/?region=&mid=7090863251021515533&u_code=0&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title", "title": "修以美好,与君相遇#就算无人欣赏也要独自芬芳", "type": "video", "nick": "花草日记 🪴 麦麦", "signature": "🐌不谈悲喜、只闻花香\n\n🐌手机随拍、装点生活", "uid": "5698411035", "short_id": "969898359", "video": { "url": "https://aweme.snssdk.com/aweme/v1/playwm/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0", "url_raw": "https://aweme.snssdk.com/aweme/v1/play/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0", "pic_url": "https://p6-sign.douyinpic.com/tos-cn-p-0015/871cb3034d9b4073bd2aa8960bff93fd~c5_300x400.jpeg?x-expires=1657267200&x-signature=B51pWtm1i1Mljef8gNaulIXDdgk%3D&from=4257465056_large&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sc=cover&l=202206241654240102080650503702D0F0" }, "music": { "title": "@若然若创作的原声一若然若", "nick": "若然若", "url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7090863247943109407.mp3", "pic_url": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_1e7c8177679e3c9b4743da4968714762.jpeg?from=116350172" }, "item_imgs": [] }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:60 max:10100 all[110=60+19+31];expires:2030-12-31", "execution_time": "0.237", "server_time": "Beijing/2022-06-24 16:54:24", "client_ip": "106.6.39.153", "call_args": [], "api_type": "douyin", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "3.04MB", "request_id": "1.62b57bc005cc9", "last_id": "1038207645" }
异常示例
{ "error": "item-not-found", "reason": "没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "douyin", "request_id": "1ee0ffc041242"}
相关资料
错误码解释
状态代码(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 | 未知错误 | 否 |
API 工具
当您调用一个根据ID获取商品详情的API时,通常返回值会包含一系列有关特定商品的详细信息。这些信息可能包括但不限于:
- 商品ID(Product ID):商品的唯一标识符。
- 商品名称(Product Name):商品的名称。
- 商品描述(Description):对商品的详细描述。
- 价格(Price):商品的售价。
- 库存数量(Stock Quantity):商品的库存量。
- 商品图片URL(Image URL):商品图片的网络地址。
- 类别/分类(Category):商品所属的类别或分类。
- 标签/属性(Tags/Attributes):与商品相关的标签或属性,如颜色、尺寸等。
- SKU(Stock Keeping Unit):商品的库存单位,用于具体识别商品的型号、配置等。
- 品牌(Brand):商品的品牌名称。
- 上架状态(Listing Status):商品的上架/下架状态。
- 评分/评价(Rating/Reviews):商品的用户评分和评价。
- 销售统计(Sales Statistics):商品的销售数量、浏览次数等统计数据。
- 创建时间(Creation Date):商品信息被添加到系统的日期。
- 更新时间(Last Updated):商品信息最后更新的时间。
一个典型的API响应可能会是这样的JSON格式:
json复制代码运行
{ "product_id": "12345", "name": "Example Product", "description": "This is an example product description.", "price": 99.99, "stock_quantity": 50, "image_url": "https://example.com/product-image.jpg", "category": "Electronics", "tags": ["electronics", "home"], "sku": "EXAMPLE123", "brand": "Example Brand", "listing_status": "active", "rating": 4.5, "reviews": [ { "user_id": "1", "comment": "Great product!", "rating": 5 }, // ... more reviews ... ], "sales_statistics": { "units_sold": 1000, "views": 5000 }, "creation_date": "2023-01-01T00:00:00Z", "last_updated": "2023-04-15T12:00:00Z" }
总之,具体的返回值会根据不同API的设计和需求有所不同。一些API可能还会包括额外的元数据或者链接到关联资源的信息。务必查阅相关API的文档以了解确切的返回值内容和格式。
|