[关闭]
@Sayming 2020-06-29T06:27:09.000000Z 字数 12204 阅读 693

TaobaoTools接口

接口 淘宝工具

一、卡首屏手机端

参数：

参数名 必填 类型 长度限制 备注
taobaoProductId 是 String 255字符 淘宝商品Id
keywords 是 String 255字符 搜索的关键字
productTitle 是 String 255字符 淘口令分享标题
logoUrl 否 String 淘口令分享图片地址

返回：

  1. //Success
  2. {
  3.   "body": {
  4.     "tpwd": "￥TestAADPOKFzTest￥",//淘口令
  5.     "url": "https://s.m.taobao.com/h5?nid=123123sss,547678921204,556691333387,553405637192,39087455559,37206963560,525338338283,554104289068,7696145548,10804727310,546343115103,547678921204,555205580584,551974573902,536754572499,38840821749,535913284432,520070588666,45671922863,556424414608,558344937319,17665294375,524568071712,549229155030,561549550526,529443202573,541699431037,35621253868,528106660879,39028254172,548098649617,553428573105,552875632641,531831594688,531670220670,524196079999,13552159673&q=aaa"//卡首屏链接
  6.   },
  7.   "code": "200",//200-成功，其他错误
  8.   "msg": "成功。"//消息
  9. }
  10. //Error
  11. {
  12.     "code": "-200",
  13.     "msg": "口令提示内容不能为空。"
  14. }

二、卡同行淘口令

参数：

参数名 必填 类型 长度限制 备注
taobaoProductId 是 String 255字符 淘宝商品Id
keywords 是 String 255字符 搜索的关键字
competitorProductId1 是 String 255字符 同行淘宝商品Id1
competitorProductId2 是 String 255字符 同行淘宝商品Id2
competitorProductId3 是 String 255字符 同行淘宝商品Id3
productTitle 是 String 淘口令分享标题
logoUrl 否 String 淘口令分享图片地址

返回：

  1. //Success
  2. {
  3.   "body": {
  4.     "tpwd": "￥TestAADPOKFzTest￥",//淘口令
  5.     "url": "https://s.m.taobao.com/h5?nid=123123sss,547678921204,556691333387,553405637192,39087455559,37206963560,525338338283,554104289068,7696145548,10804727310,546343115103,547678921204,555205580584,551974573902,536754572499,38840821749,535913284432,520070588666,45671922863,556424414608,558344937319,17665294375,524568071712,549229155030,561549550526,529443202573,541699431037,35621253868,528106660879,39028254172,548098649617,553428573105,552875632641,531831594688,531670220670,524196079999,13552159673&q=aaa"//卡首屏链接
  6.   },
  7.   "code": "200",//200-成功，其他错误
  8.   "msg": "成功。"//消息
  9. }
  10. //Error
  11. {
  12.     "code": "-200",//错误
  13.     "msg": "同行链接地址1不能为空。"//错误信息
  14. }

三、任意链接淘口令

参数：

参数名 必填 类型 长度限制 备注
url 是 String 待转链接
title 是 String 淘口令分享标题
logoUrl 否 String 淘口令分享图片地址

返回：

  1. //Success
  2. {
  3.     "body": {
  4.         "tpwd": "￥TestAADPOKFzTest￥",//生成的淘口令
  5.         "url": "123"//原url
  6.     },
  7.     "code": "200",
  8.     "msg": "成功。"
  9. }
  10. //Error
  11. {
  12.     "code": "-200",//错误代码
  13.     "msg": "淘口令分享标题不能为空。"//错误信息
  14. }

四、淘词补单多个关键词

参数：

参数名 必填 类型 长度限制 备注
productUrl 是 String 2048个字符 淘宝商品链接
remark 否 String 备注
manyOrderDetails[0].keywords 是 String 255个字符 关键词1
manyOrderDetails[0].limitClickQuantity 是 String 点击量1上限
……
manyOrderDetails[n].keywords 是 String 255个字符 n从0开始，关键词1
manyOrderDetails[n].limitClickQuantity 是 String n从0开始，点击量1上限

返回：

  1. //Success
  2. {
  3.     "body": {
  4.         "manyOrderBillId": 20//淘词补单Id
  5.     },
  6.     "code": "200",
  7.     "msg": "成功。"
  8. }
  9. //Error
  10. {
  11.     "code": "-200",
  12.     "msg": "淘词补单明细关键词不能为空。"
  13. }

五、淘词补单多个连接

参数：

参数名 必填 类型 长度限制 备注
remark 否 String 备注
manyOrderDetails[0].productUrl 是 String 2048个字符 淘宝宝贝链接
manyOrderDetails[0].limitClickQuantity 是 String 点击量1上限
……
manyOrderDetails[n].productUrl 是 String 2048个字符 n从0开始，淘宝宝贝链接
manyOrderDetails[n].limitClickQuantity 是 String n从0开始，点击量1上限

返回：

  1. //Success
  2. {
  3.     "body": {
  4.         "manyOrderBillId": 24//淘词补单Id
  5.     },
  6.     "code": "200",
  7.     "msg": "成功。"
  8. }
  9. //Error
  10. {
  11.     "code": "-200",//错误代码
  12.     "msg": "淘词补单商品链接不能为空。"//错误信息
  13. }

六、获取淘词补单信息

参数：

参数名 必填 类型 长度限制 备注
orderId 是 Integer 淘词补单Id

返回：
- json数据

  1. {
  2.   "body": {
  3.     "manyOrderBill": {
  4.       "createDate": 1516607078000,//创建时间
  5.       "id": 18,
  6.       "manyOrderDetails": [
  7.         {
  8.           "clickCount": 3,//累计点击量
  9.           "clickQuantity": 3,//已点击量
  10.           "headId": 18,//淘词补单Id
  11.           "id": 40,
  12.           "keywords": "洗发水",//关键词
  13.           "limitClickQuantity": 5,//限制点击量
  14.           "productUrl": "https://chaoshi.detail.tmall.com/item.htm?spm=a230r.1.14.16.14a04bbfrkWfmy&id=559316982824&ns=1&abbucket=15"//补单明细 商品Url
  15.         }
  16.       ],
  17.       "memberId": 0,//会员
  18.       "productUrl": "https://chaoshi.detail.tmall.com/item.htm?spm=a230r.1.14.16.14a04bbfrkWfmy&id=559316982824&ns=1&abbucket=15",//淘词补单商品Url
  19.       "remark": "",//淘词补单备注
  20.       "userId": 0
  21.     }
  22.   },
  23.   "code": "200",
  24.   "msg": "成功。"
  25. }

七、获取淘词补单列表

参数：

参数名 必填 类型 长度限制 备注
page 是 Integer 页数

返回：
- json数据

  1. {
  2.   "body": {
  3.     "manyOrderAndDetailsList": [
  4.       {
  5.         "createDate": 1516607078000,//创建时间
  6.         "id": 18,
  7.         "manyOrderDetails": [
  8.           {
  9.             "clickCount": 3,//累计点击量
  10.             "clickQuantity": 3,//已点击量
  11.             "headId": 18,//淘词补单Id
  12.             "id": 40,
  13.             "keywords": "洗发水",//关键词
  14.             "limitClickQuantity": 5,//限制点击量
  15.             "productUrl": "https://chaoshi.detail.tmall.com/item.htm?spm=a230r.1.14.16.14a04bbfrkWfmy&id=559316982824&ns=1&abbucket=15"//补单明细 商品Url
  16.           }
  17.         ],
  18.         "memberId": 0,//会员
  19.         "productUrl": "https://chaoshi.detail.tmall.com/item.htm?spm=a230r.1.14.16.14a04bbfrkWfmy&id=559316982824&ns=1&abbucket=15",//淘词补单商品Url
  20.         "shortLink": "http://xxxxxx.com",//短链接
  21.         "remark": "",//淘词补单备注
  22.         "userId": 0
  23.       }
  24.     ],
  25.     "manyOrderBillCount": 1,//总共条数
  26.     "manyOrderBillSumPage": 1//总共页数
  27.   },
  28.   "code": "200",//成功
  29.   "msg": "成功。"//消息
  30. }

八、淘词补单分享链接

参数：

参数名 必填 类型 长度限制 备注
orderId 是 Integer 淘词补单Id

返回：
微信浏览器打开的：/user/showBrowserOpen.jsp
指定的淘词补单全部点击完成：/user/manyOrderBillShareDone.jsp
成功：跳转到卡首屏链接。

九、卡首屏单列表

参数：

参数名 必填 类型 长度限制 备注
page 否 Int 获取第几页，默认为1
startDate 是 Date 开始日期,yyyy-MM-dd
endDate 是 Date 结束日期,yyyy-MM-dd

返回：
- json数据

  1. {
  2.   "body": {
  3.     "stuckFirstScreenBillCount": 1,//总共条数
  4.     "stuckFirstScreenBillSumPage": 1,//总共页数
  5.     "stuckFirstScreenBills": [
  6.       {
  7.         "competitor": true,//是否卡同行
  8.         "createDate": 1517414116000,//创建日期
  9.         "id": 4,
  10.         "keywords": "棉柔巾",//关键词
  11.         "memberId": 0,
  12.         "productId": "557615243465,531545716222,533798359585,539337335508",//商品Id
  13.         "status": "OVER",//状态
  14.         "taobaoWord": {//淘口令信息
  15.           "createDate": 1517414115000,//创建日期
  16.           "failureDate": 1520006116000,//失效时间止
  17.           "id": 6,
  18.           "memberId": 0,
  19.           "status": "OVER",
  20.           "text": "阿萨德",//分享标题内容
  21.           "tpwd": "￥TestAADPOKFzTest￥",//淘口令
  22.           "url": "https://s.m.taobao.com/h5?nid=557615243465,531545716222,533798359585,539337335508,563175838677,560214083385,561527413875,545644174121,538832022583,20170473600,18539671588,563240646618,563185026287,530795409762,527299603669,550409752902,533798359585,531545716222,547358363418,558273321505,41912089118,542791457114,524224491939,563175838677,44636789202,541160628098,528690173109,528105689823,522687021579,563251595572,527992063578,540815243317,534365566427,549120989696,539337335508,544305082046,558874716534,537376804946,555008264039,533985072995&q=%E6%A3%89%E6%9F%94%E5%B7%BE"//待转淘口令前的url
  23.         },
  24.         "taobaoWordId": 6
  25.       }
  26.     ]
  27.   },
  28.   "code": "200",
  29.   "msg": "成功。"
  30. }

十、卡首屏单获取单个

参数：

参数名 必填 类型 长度限制 备注
id 是 Long 卡首屏单Id

返回：
- json数据

  1. {
  2.   "body": {
  3.     "stuckFirstScreenBill": {
  4.       "competitor": false,//是否卡同行
  5.       "createDate": 1517465926000,//创建日期
  6.       "id": 8,
  7.       "keywords": "aaa",//关键词
  8.       "memberId": 0,
  9.       "productId": "123123sss",//商品Id
  10.       "status": "OVER",//状态
  11.       "taobaoWord": {//淘口令信息
  12.         "createDate": 1517465926000,//创建日期
  13.         "failureDate": 1520057926000,//失效时间止
  14.         "id": 10,
  15.         "memberId": 0,
  16.         "status": "OVER",
  17.         "text": "123123ad",//分享标题内容
  18.         "tpwd": "￥TestAADPOKFzTest￥",//淘口令
  19.         "url": "https://s.m.taobao.com/h5?nid=123123sss,547678921204,556691333387,553405637192,39087455559,37206963560,525338338283,554104289068,7696145548,10804727310,546343115103,547678921204,555205580584,551974573902,536754572499,38840821749,535913284432,520070588666,45671922863,556424414608,558344937319,17665294375,524568071712,549229155030,561549550526,529443202573,541699431037,35621253868,528106660879,39028254172,548098649617,553428573105,552875632641,531831594688,531670220670,524196079999,13552159673&q=aaa"//待转淘口令前的url
  20.       },
  21.       "taobaoWordId": 10
  22.     }
  23.   },
  24.   "code": "200",
  25.   "msg": "成功。"
  26. }

十一、分析店铺

参数：

参数名 必填 类型 长度限制 备注
shopUrl 是 String 店铺链接

返回：
- json数据

  1. {
  2.   "body": {
  3.     "billId": 120 //订单Id
  4.   },
  5.   "code": "200",
  6.   "msg": "成功。"
  7. }

十二、分析店铺列表

参数：

参数名 必填 类型 长度限制 备注
page 是 Int 第几页

返回：
- json数据

  1. {
  2.     "body": {
  3.         "billAndDetailsList": [{
  4.             "analyzeStoreDetails": [],//订单明细
  5.             "catchUrl": "http://localhost:8084/TaobaoTools/user/analyzeStore.do",//爬取源URL
  6.             "createDate": 1520679115000,//创建时间
  7.             "happenDate": 1520679115000,//发生时间
  8.             "id": 1,//订单Id
  9.             "memberId": 0,//会员Id
  10.             "name": "店铺名称",
  11.             "status": "处理中"//状态-处理中，失败，完成
  12.         }, {
  13.             "analyzeStoreDetails": [{
  14.                 "analyzeStoreBillId": 2,//订单Id
  15.                 "createDate": 1520679575000,//创建时间
  16.                 "id": 1,//订单明细Id
  17.                 "memberId": 0,//会员Id
  18.                 "productName": "商品名称",//商品名称
  19.                 "productPrice": 30.31,//价格
  20.                 "productSaleQuantity": 121,//销量
  21.                 "productTaobaoId": "淘宝商品Id1",//淘宝商品Id
  22.                 "sourceData": "{\"id\":\"淘宝商品Id1\",\"name\":\"商品名称\",\"price\":30.31,\"saleQuantity\":121}",//源数据
  23.                 "storeName": "店铺名称",//店铺名称
  24.                 "userId": 0
  25.             }, {
  26.                 "analyzeStoreBillId": 2,
  27.                 "createDate": 1520679576000,
  28.                 "id": 2,
  29.                 "memberId": 0,
  30.                 "productName": "商品名称",
  31.                 "productPrice": 30.32,
  32.                 "productSaleQuantity": 122,
  33.                 "productTaobaoId": "淘宝商品Id2",
  34.                 "sourceData": "{\"id\":\"淘宝商品Id2\",\"name\":\"商品名称\",\"price\":30.32,\"saleQuantity\":122}",
  35.                 "storeName": "店铺名称",
  36.                 "userId": 0
  37.             }, {
  38.                 "analyzeStoreBillId": 2,
  39.                 "createDate": 1520679576000,
  40.                 "id": 3,
  41.                 "memberId": 0,
  42.                 "productName": "商品名称",
  43.                 "productPrice": 30.33,
  44.                 "productSaleQuantity": 123,
  45.                 "productTaobaoId": "淘宝商品Id3",
  46.                 "sourceData": "{\"id\":\"淘宝商品Id3\",\"name\":\"商品名称\",\"price\":30.33,\"saleQuantity\":123}",
  47.                 "storeName": "店铺名称",
  48.                 "userId": 0
  49.             }],
  50.             "catchRemark": "备注",
  51.             "catchUrl": "http://localhost:8084/TaobaoTools/user/analyzeStore.do",
  52.             "createDate": 1520679174000,
  53.             "doneDate": 1520679576000,
  54.             "happenDate": 1520679174000,
  55.             "id": 2,
  56.             "memberId": 0,
  57.             "name": "店铺名称",
  58.             "shopId": 67694825,
  59.             "status": "完成"//状态-处理中，失败，完成
  60.         }],
  61.         "billCount": 2,
  62.         "billSumPage": 1
  63.     },
  64.     "code": "200",
  65.     "msg": "成功。"
  66. }

十三、分析店铺详情

参数：

参数名 必填 类型 长度限制 备注
orderId 是 Long 订单Id

返回：
- json数据

  1. {
  2.     "body": {
  3.             "analyzeStoreDetails": [{
  4.                 "analyzeStoreBillId": 2,//订单Id
  5.                 "createDate": 1520679575000,//创建时间
  6.                 "id": 1,//订单明细Id
  7.                 "memberId": 0,//会员Id
  8.                 "productName": "商品名称",//商品名称
  9.                 "productPrice": 30.31,//价格
  10.                 "productSaleQuantity": 121,//销量
  11.                 "productTaobaoId": "淘宝商品Id1",//淘宝商品Id
  12.                 "sourceData": "{\"id\":\"淘宝商品Id1\",\"name\":\"商品名称\",\"price\":30.31,\"saleQuantity\":121}",//源数据
  13.                 "storeName": "店铺名称",//店铺名称
  14.                 "userId": 0
  15.             }, {
  16.                 "analyzeStoreBillId": 2,
  17.                 "createDate": 1520679576000,
  18.                 "id": 2,
  19.                 "memberId": 0,
  20.                 "productName": "商品名称",
  21.                 "productPrice": 30.32,
  22.                 "productSaleQuantity": 122,
  23.                 "productTaobaoId": "淘宝商品Id2",
  24.                 "sourceData": "{\"id\":\"淘宝商品Id2\",\"name\":\"商品名称\",\"price\":30.32,\"saleQuantity\":122}",
  25.                 "storeName": "店铺名称",
  26.                 "userId": 0
  27.             }, {
  28.                 "analyzeStoreBillId": 2,
  29.                 "createDate": 1520679576000,
  30.                 "id": 3,
  31.                 "memberId": 0,
  32.                 "productName": "商品名称",
  33.                 "productPrice": 30.33,
  34.                 "productSaleQuantity": 123,
  35.                 "productTaobaoId": "淘宝商品Id3",
  36.                 "sourceData": "{\"id\":\"淘宝商品Id3\",\"name\":\"商品名称\",\"price\":30.33,\"saleQuantity\":123}",
  37.                 "storeName": "店铺名称",
  38.                 "userId": 0
  39.             }],
  40.             "catchRemark": "备注",
  41.             "catchUrl": "http://localhost:8084/TaobaoTools/user/analyzeStore.do",//爬取URL
  42.             "createDate": 1520679174000,//创建时间
  43.             "doneDate": 1520679576000,//完成时间
  44.             "happenDate": 1520679174000,//发生时间
  45.             "id": 2,//订单Id
  46.             "memberId": 0,//会员Id
  47.             "name": "店铺名称",//店铺名称
  48.             "shopId": 67694825,//店铺Id
  49.             "status": "完成"//状态-处理中，失败，完成
  50.         },
  51.     "code": "200",
  52.     "msg": "成功"
  53. }

十四、接收爬虫服务结果

参数：

参数名 必填 类型 长度限制 备注
resultJSON 是 String 结果JSON

接收数据：
- json数据

  1. {
  2.     "code": "200",
  3.     "msg": "success",
  4.     "body": {
  5.         "billId": 2,
  6.         "shopName": "店铺名称",
  7.         "shopId": 67694825,
  8.         "remark": "备注",
  9.         "products": [{
  10.                 "name": "商品名称",
  11.                 "price": 30.31,
  12.                 "saleQuantity": 121,
  13.                 "id": "淘宝商品Id1"
  14.             },
  15.             {
  16.                 "name": "商品名称",
  17.                 "price": 30.32,
  18.                 "saleQuantity": 122,
  19.                 "id": "淘宝商品Id2"
  20.             },
  21.             {
  22.                 "name": "商品名称",
  23.                 "price": 30.33,
  24.                 "saleQuantity": 123,
  25.                 "id": "淘宝商品Id3"
  26.             }
  27.         ]
  28.     }
  29. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注