/product/detail抖音商品详情数据基础API接口

本抖音商品详情数据基础API接口主要解决:查询抖店商品详情信息(包含商品标题、商品id、库存、sku价格、促销信息、图片等参数),支持使用抖店商品id进行查询。同样适用商品信息展示、店铺搬家、数据分析、代购商城、ERP选品、无货源铺货、品牌监控、广告投放优化等应用场景。

可定制个性化私有化接口api。====================有需要可以联系。

1.请求参数示例

参数名称参数类型是否必须示例值参数描述
methodStringyesproduct.detail调用的API接口名称
product_idStringyes3622967290489916703商品ID,抖店系统生成,店铺下唯一;长度一般19位
access_tokenStringyesedae7c30-8386-443b-88a1-031111596fdd用于调用 API 的 access_token

2、请求示例
这里仅提供curl请求示例

60..148.:8090/dy/product.detail?product_id=<“你的商品id”>&token=<“你的接口token”>

3、响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": "36229672***",
    "product_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=36229672***",
    "title": "日本进口饮料可果美果蔬汁野菜生活100葡萄蔬菜番茄果汁饮料200ml",
    "category_id": 29170,
    "category_path": [
      {
        "id": 20017,
        "name": "咖啡/麦片/冲饮"
      },
      {
        "id": 20309,
        "name": "饮料"
      },
      {
        "id": 22842,
        "name": "果蔬汁"
      },
      {
        "id": 29170,
        "name": "纯果蔬汁/纯果汁"
      }
    ],
    "main_imgs": [
      "https://p3-item.ecombdimg.com/img/ecom-shop-material/***QnMc_m_0a435ba689d0db0d0495e323baf063b5_sx_388018_www800-800~tplv-5mmsx3fupr-resize_q:1080:1080:q90.png",
      "https://p3-item.ecombdimg.com/img/ecom-shop-material/***QnMc_m_0d1d00c3998c9b0a20713d145654dc37_sx_678296_www800-800~tplv-5mmsx3fupr-resize_q:1080:1080:q90.png",
      "https://p3-item.ecombdimg.com/img/ecom-shop-material/***QnMc_m_03bf65ace353667c00392214500268c4_sx_427457_www800-800~tplv-5mmsx3fupr-resize_q:1080:1080:q90.png",
      "https://p3-item.ecombdimg.com/img/ecom-shop-material/***QnMc_m_b8b6504f9500d803dfdc9be12c2acaff_sx_392132_www800-800~tplv-5mmsx3fupr-resize_q:1080:1080:q90.png",
      "https://p26-item.ecombdimg.com/img/ecom-shop-material/***QnMc_m_f5a2dfb984ba16f58883d8155f2702b9_sx_418772_www800-800~tplv-5mmsx3fupr-resize_q:1080:1080:q90.png"
    ],
    "video_url": "",
    "currency": "CNY",
    "brand": null,
    "price_info": {
      "price": "12.8",
      "origin_price": "",
      "price_min": "12.8",
      "price_max": "210.0",
      "discount_price_min": "",
      "discount_price_max": "",
      "price_tag": null
    },
    "product_props": [],
    "delivery_info": {
      "area_from": [
        "广东",
        "广州市"
      ],
      "postage": 0
    },
    "shop_info": {
      "shop_id": ***288,
      "shop_name": "***供应链",
      "shop_code": "***QnMc",
      "shop_logo": "https://p26-item.ecombdimg.com/***",
      "shop_rate": {
        "score": "4.6",
        "goods_score": "5",
        "service_score": "4.2",
        "logisic_score": "4.8"
      },
      "is_flagship": false,
      "all_items_count": 161,
      "followers": 4049,
      "good_rate_percentage": "91.84530055463948"
    },
    "comment_count": 1,
    "sales_count": null,
    "visitor_count": 111,
    "rating_info": {
      "good_rate_percentage": "100",
      "rating_bad": 0,
      "rating_normal": 0,
      "rating_good": 1
    },
    "skus": [
      {
        "skuid": "1769026992217115",
        "skuname": "口味:番茄汁200ml;规格:【24盒】",
        "sale_price": "210.0",
        "stock": 10
      },
      {
        "skuid": "1769026992217099",
        "skuname": "口味:番茄汁200ml;规格:【12盒】",
        "sale_price": "110.0",
        "stock": 21
      },
      {
        "skuid": "1769026992215156",
        "skuname": "口味:芒果果蔬汁200ml;规格:【6盒】",
        "sale_price": "58.0",
        "stock": 16
      },
      {
        "skuid": "1769026992215140",
        "skuname": "口味:芒果果蔬汁200ml;规格:【1盒】",
        "sale_price": "12.8",
        "stock": 98
      },
      {
        "skuid": "1769026992217131",
        "skuname": "口味:野菜一日200ml;规格:【1盒】",
        "sale_price": "12.8",
        "stock": 331
      },
      {
        "skuid": "1769026992217147",
        "skuname": "口味:野菜一日200ml;规格:【6盒】",
        "sale_price": "58.0",
        "stock": 55
      },
      {
        "skuid": "1769026992215124",
        "skuname": "口味:复合果蔬汁200ml;规格:【24盒】",
        "sale_price": "210.0",
        "stock": 5
      },
      {
        "skuid": "1769026992218155",
        "skuname": "口味:胡萝卜汁200ml;规格:【1盒】",
        "sale_price": "12.8",
        "stock": 127
      },
      {
        "skuid": "1769026992215108",
        "skuname": "口味:复合果蔬汁200ml;规格:【12盒】",
        "sale_price": "110.0",
        "stock": 11
      },
      {
        "skuid": "1769026992218171",
        "skuname": "口味:胡萝卜汁200ml;规格:【6盒】",
        "sale_price": "58.0",
        "stock": 21
      },
      {
        "skuid": "1769026992213028",
        "skuname": "口味:葡萄果蔬汁200ml;规格:【1盒】",
        "sale_price": "12.8",
        "stock": 0
      },
      {
        "skuid": "1769026992213044",
        "skuname": "口味:葡萄果蔬汁200ml;规格:【6盒】",
        "sale_price": "58.0",
        "stock": 0
      },
      {
        "skuid": "1769026992216180",
        "skuname": "口味:番茄汁200ml;规格:【6盒】",
        "sale_price": "58.0",
        "stock": 42
      },
      {
        "skuid": "1769026992216164",
        "skuname": "口味:番茄汁200ml;规格:【1盒】",
        "sale_price": "12.8",
        "stock": 253
      },
      {
        "skuid": "1769026992216148",
        "skuname": "口味:芒果果蔬汁200ml;规格:【24盒】",
        "sale_price": "210.0",
        "stock": 4
      },
      {
        "skuid": "1769026992218123",
        "skuname": "口味:野菜一日200ml;规格:【12盒】",
        "sale_price": "110.0",
        "stock": 27
      },
      {
        "skuid": "1769026992216132",
        "skuname": "口味:芒果果蔬汁200ml;规格:【12盒】",
        "sale_price": "110.0",
        "stock": 8
      },
    ],
    "promos": [],
  }
}
<think>好的,我现在需要帮助用户了解如何使用商城的API进行开发,特别是文档、开发者接口和调用示例。首先,我得回想一下之前提供的引用内容,看看有没有相关的信息。 根据引用[1],详情API接口可以获取视频和商品的信息,比如标题、价格、销量等。这可能和商城API有关联,因为商城API可能也涉及商品详情数据。引用[2]提到了使用Java开发API的步骤,包括创建开发者账号、获取权限等,这可能适用于商城API的开发流程。引用[3]则详细说明了如何处理API响应,比如解析JSON数据,处理错误,以及数据安全等注意事项,这些对调用商城API同样重要。 接下来,我需要整理出调用商城API的基本步骤。首先,用户需要注册成为开放平台的开发者,并创建应用来获取API密钥,比如app_key和app_secret。然后,在文档中找到具体的接口地址和参数,比如商品详情接口可能需要商品ID等参数。调用时需要进行身份验证,可能需要使用OAuth 2.0或者签名机制,比如在请求头中添加Access Token,或者对参数进行签名。 关于调用示例,用户可能需要一个具体的代码示例。假设用户使用Python,可以展示一个使用requests库发送GET请求的例子,包括构造请求URL、添加必要的参数和头部信息,处理响应和错误。同时,需要提醒用户注意数据解析,比如处理返回的JSON数据,提取所需字段,以及处理可能的错误码,比如网络问题、权限不足等。 另外,用户可能关心如何获取API文档。应该指导他们访问开放平台的官方网站,登录后进入文档中心查找相关接口的详细说明。同时,注意事项部分需要强调API密钥的保密性,遵守平台的使用规范,避免滥用接口,以及处理数据时的合规性要求。 可能还需要考虑用户在实际开发中遇到的问题,比如接口调用频率限制、数据缓存策略、测试环境的搭建等。但根据当前提供的信息,主要围绕注册、认证、调用示例和注意事项展开即可。需要确保回答结构清晰,步骤明确,并提供实际的代码示例,让用户能够快速上手。</think>### 商城 API 开发指南 #### 1. **获取开发者权限** - **注册开放平台账号** 访问[开放平台](https://open.douyin.com/),注册开发者账号并完成企业认证(个人开发者可能受接口权限限制)[^2]。 - **创建应用** 在控制台创建应用,获取`app_key`和`app_secret`,用于身份验证和接口调用[^1][^3]。 #### 2. **查阅 API 文档** - 登录开放平台后,进入**文档中心** → **电商服务** → **商品相关接口**,找到目标接口(如商品详情、搜索、订单查询等)。 - 文档包含接口地址、请求参数、返回字段、错误码说明等。例如: - **商品详情接口**:`GET /api/product/detail` - **请求参数**:`product_id`(商品ID)、`access_token` - **返回字段**:商品名称、价格、库存、销量、描述等。 #### 3. **调用接口示例(Python)** ```python import requests import hashlib import time # 配置参数 app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET" product_id = "123456" # 目标商品ID # 1. 获取Access Token(示例) def get_access_token(): url = "https://open.douyin.com/oauth/access_token/" params = { "client_key": app_key, "client_secret": app_secret, "grant_type": "client_credential" } response = requests.get(url, params=params) return response.json().get("access_token") # 2. 调用商品详情接口 access_token = get_access_token() url = "https://open.douyin.com/api/product/detail" params = { "product_id": product_id, "access_token": access_token } try: response = requests.get(url, params=params) if response.status_code == 200: data = response.json() if data["error_code"] == 0: product_info = data["data"] print("商品名称:", product_info["title"]) print("价格:", product_info["price"]) else: print("接口返回错误:", data["error_msg"]) else: print("请求失败,状态码:", response.status_code) except Exception as e: print("网络异常:", str(e)) ``` #### 4. **关键注意事项** - **身份验证**:多数接口需传递`access_token`,需定期刷新(有效期通常为2小时)。 - **数据解析**:响应数据为JSON格式,需提取`data`字段中的业务数据[^3]。 - **错误处理**:需处理`error_code`(如`40001`表示参数错误)和网络超时[^3]。 - **频率限制**:接口通常有QPS限制(如每秒10次),需设计重试机制。 #### 5. **常见接口类型** | 接口类型 | 功能描述 | 典型应用场景 | |-----------------|------------------------------|----------------------| | 商品搜索 | 根据关键词筛选商品 | 商城搜索功能 | | 商品详情 | 获取商品完整信息 | 商品详情页展示 | | 订单查询 | 查询用户订单状态 | 订单管理系统 | | 库存同步 | 实时更新商品库存 | 库存监控与预警 | ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值