NAV Navbar
python
  • Introduction
  • Authentication
  • Basic
  • Shop
  • Item
  • Industry
  • Brand
  • Word
  • Search
  • UserConfig
  • MMI
  • Errors
  • Introduction

    软件开发者和网店技术人员可以通过魔镜开放的API获取数据,并集成到自己的软件系统中。您可以基于魔镜的数据开发更加强大的或者定制化的功能。

    Authentication

    您只需要在API管理后台生成一个APIKEY,然后就可以开始调用魔镜API了。[去生成APIKEY]

    调用Http请求时,将API Key加到MOOJING-APIKEY的header里面,即可正常调用接口。

    示例代码:

    #coding=utf-8
    
    import requests
    import urllib
    import json
    
    API_KEY = '2BC875731EAB37CF5A7B0CDF7875AAAA'
    
    def get_data(url, params={}):
        url = '%s?%s' % (url, urllib.urlencode(params))
        r = requests.get(url, headers={'MOOJING-APIKEY': API_KEY})
        return json.loads(r.text)
    
    def put_data(url, params):
        r = requests.put(url, data=urllib.urlencode(params), headers={'MOOJING-APIKEY': API_KEY})
        return json.loads(r.text)
    
    def delete_data(url, params):
        r = requests.delete(url, data=urllib.urlencode(params), headers={'MOOJING-APIKEY': API_KEY})
        return json.loads(r.text)
    
    if __name__ == '__main__':
        shop_name = u'韩都衣舍旗舰店'
        url = 'http://console.moojing.com/api/shops/%s' % shop_name
        params = {}
        print get_data(url, params)
    
        shop_name = u'茵曼旗舰店'
        url = 'http://console.moojing.com/api/shops/%s/monitor' % shop_name
        url = 'http://console.moojing.com/api/items/%s/monitor' % '19941155928'
        print put_data(url, {})
        print delete_data(url, {})
    
    

    Basic

    Request Time

    请求时间 没有传start_time和end_time的时候。取当前ts的前time天的数据

    {  
      "time": 1  //int, 取值范围1, 3, 7,30,表示获取多少天的数据,服务器返回有数据的时间段
      "start_time": "2017-05-27" //string, 年月日,格式yyyy-mm-dd
      "end_time": "2017-08-27",//string, 年月日,格式yyyy-mm-dd
    }
    

    PageInfo

    请求分页参数

    {
        "page": 1, //int 页数
        "page_size": 10, //int 每页条数
        "order_by": "sold" // string
        "desc": true // boolean true降序, false升序
    }
    

    ShopInfo

    店铺基本信息

    {
        "shop_id": 58501945, //int 店铺ID     
        "shop_logo": "", //string 店铺图片    
        "shop_title": "韩都衣舍旗舰店", //string 店铺名称    
        "shop_ww": "韩都衣舍旗舰店", //string 店铺旺旺
        "marked": true, //Boolean 是否关注
        "remain_days": 21, //int 监控店铺为不可修改状态的剩余天数,0 表示可修改, null表示未监控
        "shop_level": 0// int 可选范围参考店铺级别
    }
    

    ItemInfo

    宝贝基本信息

    {
        "item_id": 44024535843, //int 宝贝ID
        "shop_ww":   "韩都衣舍旗舰店", //string 店铺旺旺
        "item_title": "韩都衣舍韩版2015夏装新款女装条纹拼接小脚连体裤MR4453汩", //string 宝贝标题
        "item_image": "http://g-search3.alicdn.com/img/bao/uploaded/i4/i2/TB1my3oHpXXXXazXXXXXXXXXXXX_!!0-item_pic.jpg_440x440Q90.jpg_.webp", //string 宝贝图片
        "price": 158.00, //float 宝贝最低价格
        "pro_price": 158.00 - 188.00, //string 宝贝价格范围
        "reserve_price": 1008.00, //float 原价格
        "monitor": true, //Boolean 是否监控
        "category_id": 162201, //int 类目ID
        "category_name": "女装", //string 所在类目名称
        "marked": true, //Boolean 是否关注
    }
    

    Shop

    ShopInfo

    店铺基本信息

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺

    返回json格式的字符串,如下所示:

    {
      status: "ok",
      result: {
        shop_level: 99,
        shop_logo: "http://img.taobaocdn.com/shop-logo/63/a7/TB1cOF2JXXXXXbfaXXXSutbFXXX.jpg",
        uid: 263817957,
        rate_uid: "UvCxGOmHuOF8u",
        shop_title: "韩都衣舍旗舰店",
        marked: false,
        ts: "2017-08-08",
        shop_id: 58501945,
        remain_days: null,
        shop_ww: "韩都衣舍旗舰店"
      }
    }
    

    ShopSummary

    店铺流量概况

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/summary

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺

    返回json格式的字符串,如下所示:

    {
      status: "ok",
      result: {
             "simba": { //直通车
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,        //int 曝光度
                    "item_count": 12, //int 曝光宝贝数
                    "word_count": 12  //int 曝光关键词数
                },
             "organic":{ //自然搜索
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "item_count": 12,
                    "word_count": 12,
                    "doufu_count": 12 //int 豆腐块宝贝数
                },
              "tmall":{ //天猫直通车
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "item_count": 12, //int 曝光宝贝数
                    "word_count": 12  //int 曝光关键词数
                },
               "mobile":{ //手机搜索
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "item_count": 12, //int 曝光宝贝数
                    "word_count": 12  //int 曝光关键词数
                },
               "ju":{ //聚划算
                    "ts": "2017-08-15", //更新时间
                    "item_count": 134, //int 曝光宝贝数量
                    "booth_count": 12 //int 展位数
               },
               "zuan":{ //钻石展位
                    "ts": "2017-08-15", //更新时间
                    "page_count": 12, //int 页面数
                    "creative_count": 12 //int 创意数
               }
               "outside":{ //站外推广
                    "ts": "2017-08-15", //更新时间
                    "zhe800": 1, //int zhe800宝贝数
                    "vipzhe800": 1, //金折
                    "mizhe": 1,  //米zhe
                    "juanpi": 1, //卷皮
                    "fanli": 1   //返利
               },
               "alimama":{ //淘宝客
                    "ts": "2017-08-15",
                    "total_count": 100, //推广宝贝数
                    "tk_total_fee": 1000, //月佣金
                    "tk_total_sold": 100 //月推广量
               }
      }
    }
    

    ShopDoufuPv

    店铺豆腐块流量信息

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/top3_pv

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
          data: [{ //按大盘pv排序
            "word": "", //  string  关键词
            "items": [{
                ItemInfo,
                "rank": 1, // int 收录到得豆腐块位置
                "sold": 134, // int 月销量
              }, ...],
        }, ...]},
    }
    

    ShopItemsRank

    店铺宝贝排行

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/rank

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(只支持1,7,30)
    page int N 1 页数
    page_size int N 20 每页记录条数
    order_by string N sold 排序字段(sold, surge, price, avg_price, sales)
    desc string N true 是否降序排序
    q string N '' 宝贝标题关键词,空字符串表示所有宝贝

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
          TS, //更新时间
          data: [{ //按销量或飙升幅度排序
            ItemInfo
            "percent": 15.60, // float 比例, 按销量排序时top9的宝贝返回此字段
            "sold": 432, // int 销量
            "sales": 3437.60, // float 销售额
            "avg_price": 32.50, // float 平均价格
            "market": [], //array 营销 ["top3", "simba", "ju", "zuan", "outside"]
            "surge": 15.00, // float 飙升幅度,按幅度排序时返回此字段
        }, ...]},
    }
    
    

    ShopSaleTrend

    店铺销售趋势

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "data": { //所选时间范围的总和
              "sales": 123.50, //float 销售额
              "sold": 1, //int 销量
            },
            "sales": [[1433919413, 123.50], [1433929413, 247.00],...], //[时间戳,销售额]列表
            "sold": [[1433919413, 1], [1433929413, 2],...], //[时间戳,销量]列表
            "sc": [[1433919413, 100], [1433929413, 200],...], //[时间戳,30天销量]列表
            "stock": [[1433919413, 11333], [1433929413, 32221],...], //[时间戳,库存]列表
            "market":{
                // 营销推广数据: 豆腐块,直通车,聚划算,钻展,站外 
                1433919413: [],  //["top3", "simba", "ju", "zuan", "outside"],空代表未推广
    
            }
        },
    }
    

    ShopOrganic

    店铺自然搜索曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/organic

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    
    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "items_count": 134 //int 选定时间内曝光宝贝数量
            "words_count": 15, //int 选定时间内曝光关键词数量
            "org_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 自然搜索曝光趋势 [时间戳,曝光指数]列表
        },
    }
    
    

    ShopSimba

    店铺直通车曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/simba

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15",
            "items_count": 134 //int 曝光宝贝数量
            "words_count": 15, //int 曝光关键词数量
            "simba_index": 14, // int 曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 直通车曝光趋势, [时间戳,曝光度]列表
        },
    }
    

    ShopOrganicItems

    店铺自然搜索曝光宝贝

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/organic

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N sold 排序字段(sold, words_count, pv_index, sales, price)
    desc string N true 是否降序排序
    q string N 连衣裙 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                ItemInfo,  
                "words_count": 13, // int 曝光关键词数量
                "pv_index": 1, // int 曝光指数
                "sold": 83, // int 月销量
                "sales": 123, //int 月销售额
            }, ...]},
    }
    
    

    ShopSimbaItems

    店铺直通车曝光宝贝

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/simba

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N sold 排序字段(sold, words_count, pv_index, sales, price)
    desc string N true 是否降序排序
    q string N 连衣裙 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "words_count": 13, // int 曝光关键词数量
                "pv_index": 1, // int 曝光指数
                "sold": 83, // int 月销量
                "sales": 123, //int 月销售额
            }, ...]},
    }
    

    ShopOrganicWords

    店铺自然搜索曝光关键词

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/organic

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N items_count 排序字段
    desc string N true 是否降序排序
    q string N 连衣裙 过滤关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          'ts': '2017-08-15', //更新时间
          'count': 1133, //关键词总数量
          data: [{
                "word": "" // string 关键词  
                "items_count": 1, //int 关键词能看到的本店宝贝数量
            }, ...]},
    }
    

    ShopSimbaWords

    店铺直通车曝光关键词

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/simba

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N items_count 排序字段
    desc string N true 是否降序排序
    q string N 连衣裙 过滤关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          'ts': '2017-08-15', //更新时间
          'count': 1122, //关键词总数量
          data: [{
                "word": "" // string 关键词
                "items_count": 1, //int 关键词能看到的本店宝贝数量
            }, ...]},
    }
    

    ShopDoufuWords

    店铺豆腐块曝光关键词

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/top3_pv

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
          'ts': '2017-08-15', //更新时间
          data: [{
            "word": "", //  string  关键词
            "items": [{ 
                ItemInfo,
                "rank": 1, // int 收录到得豆腐块位置
                "sold": 134, // int 月销量
              }, ...],
        }, ...]},
    }
    

    ShopRankItems

    店铺宝贝排行(有人监控才能看)

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/rank

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近n天的数据(支持1,7,30)
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N sold 排序字段(sold, surge, avg_price, sales, price)
    desc string N true 是否降序排序
    q string N 连衣裙 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "avg_price": 13, // 成交均价
                "surge": 13.8, // 周销量升降幅度
                "sold": 83, // int 选定时间的销量
                "sales": 123, //int 选定时间的销售额
            }, ...]},
    }
    

    ShopMobile

    店铺手机搜索曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/mobile

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "items_count": 134 //int 选定时间内曝光宝贝数量
            "words_count": 15, //int 选定时间内曝光关键词数量
            "org_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 手机搜索曝光趋势 [时间戳,曝光指数]列表
        },
    }
    

    ShopMobileItems

    店铺手机搜索曝光宝贝

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/mobile

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N sold 排序字段(sold, words_count, pv_index, sales, price)
    desc string N true 是否降序排序
    q string N 连衣裙 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "words_count": 13, // int 曝光关键词数量
                "pv_index": 1, // int 曝光指数
                "sold": 83, // int 月销量
                "sales": 123, //int 月销售额
            }, ...]},
    }
    

    ShopMobileWords

    店铺手机搜索曝光关键词

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/mobile

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N items_count 排序字段
    desc string N true 是否降序排序
    q string N 连衣裙 过滤关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          'ts': '2017-08-15', //更新时间
          'count': 1133, //关键词总数量
          data: [{
                "word": "" // string 关键词
                "items_count": 1, //int 关键词能看到的本店宝贝数量
            }, ...]},
    }
    

    ShopTmall

    店铺天猫直通车曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/tmall

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "items_count": 134 //int 选定时间内曝光宝贝数量
            "words_count": 15, //int 选定时间内曝光关键词数量
            "org_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 天猫直通车曝光趋势 [时间戳,曝光指数]列表
        },
    }
    

    ShopTmallItems

    店铺天猫直通车曝光宝贝

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/tmall

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N sold 排序字段(sold, words_count, pv_index, sales, price)
    desc string N true 是否降序排序
    q string N 连衣裙 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "words_count": 13, // int 曝光关键词数量
                "pv_index": 1, // int 曝光指数
                "sold": 83, // int 月销量
                "sales": 123, //int 月销售额
            }, ...]},
    }
    

    ShopTmallWords

    店铺天猫直通车曝光关键词

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/words/tmall

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N items_count 排序字段
    desc string N true 是否降序排序
    q string N 连衣裙 过滤关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          'ts': '2017-08-15', //更新时间
          'count': 1133, //关键词总数量
          data: [{
                "word": "" // string 关键词
                "items_count": 1, //int 关键词能看到的本店宝贝数量
            }, ...]},
    }
    

    ShopZuan

    店铺钻展曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/zuan

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "creative_count": 5 //int 选定时间内店铺内创意数量
            "pages": 2, //int 选定时间内钻展创意跳转页面
            "pv": 14, // int 选定时间内钻展曝光指数
            "trend": {
                "all": [[1433919413, 1], [1433929413, 2],...] // 钻展通投曝光趋势 [时间戳,曝光指数]列表
                "special": [[1433919413, 1], [1433929413, 2],...] // 钻展定向曝光趋势 [时间戳,曝光指数]列表
        },
    }
    

    ShopZuanAds

    店铺钻展创意广告数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/ads/zuan

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            'count': 1133, //关键词总数量
          data: [{
                "creative_pic": "" // string 创意图片
                "dest_url": 1, //string 目标地址
                "expos": 1221, //int 展现指数
                "pic_size": "300x250", //string 图片尺寸
                "positions": "淘宝首页2屏右侧大图", //投放位置
                "scope": "定向", //投放策略
                "type": "首页", //投放类型
                "days": 5,// int 投放天数
            }, ...],
    
        },
    }
    

    ShopZuanCreativeTrend

    店铺钻展创意趋势

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/creative/zuan/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    creative string Y http://img.alicdn.com/simba/img/TB1R60MSFXXXXajXXXXSutbFXXX.jpg 创意

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "all": [[1433919413, 1], [1433929413, 2],...] // 钻展通投曝光趋势 [时间戳,曝光指数]列表
            "special": [[1433919413, 1], [1433929413, 2],...] // 钻展定向曝光趋势 [时间戳,曝光指数]列表
        },
    }
    

    ShopJu

    店铺聚划算曝光数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/ju

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    
    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "items_count": 5 //int 选定时间内店铺内聚划算宝贝数量
            "show_count": 2, //int 选定时间内聚划算展位数量
            "sold": 14, // int 选定时间内聚划算销量
            "sales": 3222, // int 选定时间内聚划算销售额
            "sales_trend": {
                "sold": [[1433919413, 1], [1433929413, 2],...] // 聚划算销量趋势 [时间戳,销量]列表
                "sales": [[1433919413, 1], [1433929413, 2],...] // 聚划算销售额趋势 [时间戳,销售额]列表
        },
    }
    
    

    ShopJuItems

    店铺聚划算宝贝列表

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/items/ju

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    page int N 1 页数
    page_size int N 10 每页记录数
    q string N 宝贝标题关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "booth_count": 1, // int 展位数量
                "ju_price": "332", // string 聚划算价格
                "ju_time": "2017-08-16 10:00:00:2017-08-18 08:59:59", // string 聚划算时间
                "ju_title": "韩都衣舍韩版女新款牛仔裤", //string 聚划算标题
                "sold_hour": 2, //int 聚划算上一个小时的销量
                "sales_hour": 324, //int 聚划算上一个小时的销售额
                "sold_day": 10, //int 聚划算今天销量
                "sales_day": 44223, //int 聚划算今天销售额
                "sold": 4324, //int 聚划算上销量
                "sales": 32432, //int 聚划算上销售额
            }, ...]},
    }
    

    ShopAlimama

    店铺淘宝客数据

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/alimama/summary

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    
    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "tk_total_fee": 134 //float 月佣金
            "tk_total_sold": 15, //int 月推广量
            "total_count": 14, // int 推广商品数
            "tk_avg_fee": 8, //平均佣金
            "trend": {
                "tk_total_fee": [[1433919413, 1], [1433929413, 2],...] // 月佣金趋势 [时间戳,佣金]列表
                "tk_total_sold": [[1433919413, 1], [1433929413, 2],...] // 月推广量趋势
        },
    }
    
    

    ShopAlimamaItems

    店铺淘客宝贝列表

    HTTP Request

    GET http://console.moojing.com/api/shops/<string:shopww>/alimama/items

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww String Y 韩都衣舍旗舰店 店铺旺旺
    page int N 1 页数
    page_size int N 10 每页记录数
    order_by string N tk_total_num 排序字段(tk_avg_fee, tk_commfee, tk_total_num, tk_rate, price, tk_total_fee, tk_avg_rate, event_rate, reserve_price)
    desc string N true 升序或者降序

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 223, //宝贝总数量
          data: [{
                ItemInfo,
                "tk_commfee": 13, // float通投佣金
                "tk_avg_fee": 1, // float平均佣金
                "tk_total_fee": 83, //float月佣金
                "tk_total_num": 123, //int月推广量
                "tk_avg_rate": 8.41, //平均佣金比例
                "tk_rate": 5.5, //通投佣金比例
                "event_rate": 25.5, //鹊桥佣金比例
            }, ...]},
    }
    

    Item

    ItemInfo

    宝贝基本信息

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID

    返回json格式的字符串,如下所示:

    {
      status: "ok",
      result: ItemInfo
    }
    

    ItemSummary

    宝贝流量概要信息

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/summary

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID

    返回json格式的字符串,如下所示:

    {
      status: "ok",
      result: {
             "simba": { //直通车
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,        //int 曝光度
                    "word_count": 12  //int 曝光关键词数
                },
             "organic":{ //自然搜索
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "word_count": 12,
                    "doufu_count": 12 //int 豆腐块宝贝数
                },
              "tmall":{ //天猫直通车
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "word_count": 12  //int 曝光关键词数
                },
               "mobile":{ //手机搜索
                    "ts": "2017-08-15", //更新时间
                    "pv": 12,         //int 曝光度
                    "word_count": 12  //int 曝光关键词数
                },
               "ju":{ //聚划算
                    "ts": "2017-08-15", //更新时间
                    "booth_count": 12 //int 展位数
               },
               "zuan":{ //钻石展位
                    "ts": "2017-08-15", //更新时间
                    "creative_count": 12 //int 创意数
               }
               "outside":{ //站外推广
                    "ts": "2017-08-15", //更新时间
                    "zhe800": 1, //int zhe800宝贝数
                    "vipzhe800": 1, //金折
                    "mizhe": 1,  //米zhe
                    "juanpi": 1, //卷皮
                    "fanli": 1   //返利
               },
               "alimama":{ //淘宝客
                    "ts": "2017-08-15",
                    "tk_total_fee": 1000, //月佣金
                    "tk_total_sold": 100 //月推广量
               }
      }
    }
    
    

    ItemTrade

    宝贝销售数据概要信息

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/trade

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID

    返回json格式的字符串,如下所示:

    
    {
        "status": "",//["ok", "error"]
        "result": {
            "sold": 4072, //int 最近30天销量
            "sales": 93656, //int 月销售额
        },
    }
    
    

    ItemOrganic

    宝贝自然搜索趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/organic/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "words_count": 15, //int 选定时间内曝光关键词数量
            "item_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 自然搜索曝光趋势 [时间戳,曝光指数]列表
            }
            "pie": [["xx", 22.11], ...] //前10个关键词曝光指数比例,可以做饼图, [关键词, 比例]列表
        },
    }
    

    ItemOrganicWords

    宝贝自然搜索关键词

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/organic

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    order_by string N pv 排序字段(pv,rank,is_doufu)
    desc string N true 是否降序
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                "is_doufu": true,  //是否是豆腐块
                "loc": "第一页,第二名", // string 出现位置
                "pv": 1, // int 曝光指数
                "rank": 2, // int 排名
                "word": "测试", //string 关键词
            }, ...]},
    }
    

    ItemOrganicWordTrend

    宝贝关键词自然搜索趋势

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/<string:word>/organic/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    word String Y 连衣裙 关键词名称

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "word": "连衣裙" //string 关键词
            "trend": {
                "pv": [[1433919413, 1], [1433929413, 2],...] // 自然搜索曝光趋势 [时间戳,曝光指数]列表
                "rank": [[1433919413, 5], ...] //自然搜索排名趋势[时间戳,排名]列表
        },
    }
    
    

    ItemSimba

    宝贝直通车趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/simba/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "words_count": 15, //int 选定时间内曝光关键词数量
            "item_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 直通车曝光趋势 [时间戳,曝光指数]列表
            }
            "pie": [["xx", 22.11], ...] //前10个关键词曝光指数比例,可以做饼图, [关键词, 比例]列表
        },
    }
    

    ItemSimbaWords

    宝贝直通车关键词

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/simba

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    order_by string N pv 排序字段(pv,rank)
    desc string N true 是否降序
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                "loc": "第一页,第二名", // string 出现位置
                "pv": 1, // int 曝光指数
                "rank": 2, // int 排名
                "word": "测试", //string 关键词
            }, ...]},
    }
    

    ItemSimbaWordTrend

    宝贝关键词直通车趋势

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/<string:word>/simba/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    word String Y 连衣裙 关键词名称

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "word": "连衣裙" //string 关键词
            "trend": {
                "pv": [[1433919413, 1], [1433929413, 2],...] // 直通车曝光趋势 [时间戳,曝光指数]列表
                "rank": [[1433919413, 5], ...] //直通车排名趋势[时间戳,排名]列表
        },
    }
    

    ItemTmall

    宝贝天猫直通车趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/tmall/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "words_count": 15, //int 选定时间内曝光关键词数量
            "item_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 天猫直通车曝光趋势 [时间戳,曝光指数]列表
            }
            "pie": [["xx", 22.11], ...] //前10个关键词曝光指数比例,可以做饼图, [关键词, 比例]列表
        },
    }
    

    ItemTmallWords

    宝贝天猫直通车关键词

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/tmall

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    order_by string N pv 排序字段(pv,rank)
    desc string N true 是否降序
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                "loc": "第一页,第二名", // string 出现位置
                "pv": 1, // int 曝光指数
                "rank": 2, // int 排名
                "word": "测试", //string 关键词
            }, ...]},
    }
    

    ItemTmallWordTrend

    宝贝关键词天猫直通车趋势

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/<string:word>/tmall/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    word String Y 连衣裙 关键词名称

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "word": "连衣裙" //string 关键词
            "trend": {
                "pv": [[1433919413, 1], [1433929413, 2],...] // 天猫直通车曝光趋势 [时间戳,曝光指数]列表
                "rank": [[1433919413, 5], ...] //天猫直通车排名趋势[时间戳,排名]列表
        },
    }
    

    ItemMobile

    宝贝手机搜索趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/mobile/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "words_count": 15, //int 选定时间内曝光关键词数量
            "item_index": 14, // int 选定时间内曝光指数
            "trend": {
                "single": [[1433919413, 1], [1433929413, 2],...] // 手机搜索曝光趋势 [时间戳,曝光指数]列表
            }
            "pie": [["xx", 22.11], ...] //前10个关键词曝光指数比例,可以做饼图, [关键词, 比例]列表
        },
    }
    

    ItemMobileWords

    宝贝手机搜索关键词

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/mobile

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间
    order_by string N pv 排序字段(pv,rank)
    desc string N true 是否降序
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                "loc": "第一页,第二名", // string 出现位置
                "pv": 1, // int 曝光指数
                "rank": 2, // int 排名
                "word": "测试", //string 关键词
            }, ...]},
    }
    

    ItemMobileWordTrend

    宝贝关键词手机搜索趋势

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/words/<string:word>/simba/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    word String Y 连衣裙 关键词名称

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "word": "连衣裙" //string 关键词
            "trend": {
                "pv": [[1433919413, 1], [1433929413, 2],...] // 手机搜索曝光趋势 [时间戳,曝光指数]列表
                "rank": [[1433919413, 5], ...] //手机搜索排名趋势[时间戳,排名]列表
        },
    }
    

    ItemTaoke

    宝贝淘客推广趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/alimama

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    start_time string N 2017-08-08 起始时间
    end_time string N 2017-08-10 结束时间

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            ItemInfo
            "tk_commfee": 7.59, //float 通投佣金
            "tk_avg_fee": 9.27, // float 平均佣金
            "tk_total_fee": 1890.79, // float 月佣金
            "tk_total_num": 204, // int 月推广量
            "tk_avg_rate": 6.27, // float 平均佣金比率
            "event_rate": 20.5, // float 鹊桥佣金
            "trend": {
                "tk_total_fee": [[1433919413, 1], [1433929413, 2],...] // 月佣金趋势 [时间戳,月佣金]列表
                "tk_total_sold": [[1433919413, 1], [1433929413, 2],...] // 月推广量趋势 [时间戳,月推广量]列表
            }
        },
    }
    

    ItemJu

    宝贝聚划算基本信息

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/ju

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            ItemInfo
            "ju_price": "332", // string 聚划算价格
            "ju_time": "2017-08-16 10:00:00:2017-08-18 08:59:59", // string 聚划算时间
            "ju_title": "韩都衣舍韩版女新款牛仔裤", //string 聚划算标题
            "sold_hour": 2, //int 聚划算上一个小时的销量
            "sales_hour": 324, //int 聚划算上一个小时的销售额
            "sold_day": 10, //int 聚划算今天销量
            "sales_day": 44223, //int 聚划算今天销售额
            "sold": 4324, //int 聚划算上销量
            "sales": 32432, //int 聚划算上销售额
        },
    }
    

    ItemJuTrend

    宝贝聚划算趋势数据

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/ju/trend

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)

    返回json格式的字符串,如下所示:

    {
        "status": "",//["ok", "error"]
        "result": {
            "ts": "2017-08-15", //更新时间
            "price": [[1433919413, 1], [1433929413, 2],...] // 价格趋势 [时间戳,价格]列表
            "sales": [[1433919413, 1], [1433929413, 2],...] // 销售额趋势 [时间戳,销售额]列表
            "sold": [[1433919413, 1], [1433929413, 2],...] // 销量趋势 [时间戳,销售额]列表
        },
    }
    

    ItemZuan

    宝贝钻展

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/ads/zuan

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    time int N 1 最近time天的数据(支持1,7,30)
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
                "creative_pic": "" // string 创意图片
                "expos": 1221, //int 展现指数
                "pic_size": "300x250", //string 图片尺寸
                "positions": "淘宝首页2屏右侧大图", //投放位置
                "scope": "定向", //投放策略
                "type": "首页", //投放类型
                "days": 5,// int 投放天数
            }, ...]},
    }
    

    ItemSuggestWords

    宝贝魔镜荐词

    HTTP Request

    GET http://console.moojing.com/api/items/<string:itemid>/suggest_words

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid String Y 545248779947 宝贝ID
    order_by string N pertinence 排序字段(pertinence,rank)
    desc string N true 是否降序
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //宝贝总数量
          data: [{
    
            }, ...]},
    }
    

    Industry

    行业信息

    CategoryList

    类目列表

    HTTP Request

    GET http://console.moojing.com/api/cats_tree

    参数名称 类型 是否必须 事例值 描述
    last_time String N 2016-05-23 10:00:00 最后更新时间,输入最后更新时间,如果和服务器端最后更新时间一致。服务器端将返回status=cache,不返回类目相关信息

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "cache", "error"],cache表示数据没变化,类似HTTP 304
        "result": {
            "bigCategory": ["16", "50008164", ],//一级类目id列表
            "childrenList": {
                "16": { //此类目详细信息
                    "name": xxx, //类目名称
                    "is_parent": true, //是否是父类目
                    "level": 1, //类目层级
                    "parent_id": "0", //父类目ID
                    "category_id": "16", //类目ID
                    "chd": ["xxx", ], //子类目列表,所有的子类目在childrenList这个dict里面都能找到
                }, 
            }
            "last_time": "2016-05-23 10:00:00", //最后更新时间
            "maxDepth": 4, //最大层级
        }
    }
    
    

    IndustryData

    行业数据

    HTTP Request

    GET http://console.moojing.com/api/cats/<string:catid>

    请求参数

    参数名称 类型 是否必须 事例值 描述
    catid String Y 50008906 类目ID
    attr string Y top_brand 行业数据类型(top_brand-热销品牌, top_category-热销子类目, top_shop-热销店铺, top_item-热销宝贝)
    market string Y all 平台类型(all-全网,taobao-淘宝, tmall-天猫)
    page int N 1 页数
    page_size int N 10 每页记录数
    month string N 2017-07 月份(从2016-04开始)

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //
          data: [{
                "rank": 1 // int 排名
                "sale_index": 1221, //int 销售指数
                "brand_id": "332322", //string 品牌ID(attr=top_brand)
                "brand_title": "伊利", //string 品牌名称(attr=top_brand)
                "category_id": "2111", //string 子类目ID(attr=top_category)
                "category_name": "连衣裙", //string 子类目名称(attr=top_category)
                "shop_id": 5231223,// int 店铺ID(attr=top_shop)
                "shop_level": 15,// int 店铺等级(attr=top_shop)
                "shop_logo": "http://img.taobaocdn.com/shop-logo/8b/61/T1lXHcFjXcXXb1upjX.jpg",// string 店铺logo(attr=top_shop)
                "shop_title": "",// string 店铺名称(attr=top_shop)
                "shop_type": "cshop"// string 店铺类型(attr=top_shop)
                "shop_ww": "",// string 店铺旺旺(attr=top_shop)
                "item_id": "554731905157", //string 宝贝ID(attr=top_item)
                "item_image": "//img.alicdn.com/bao/uploaded/i1/2747985175/TB2MmxgAbBmpuFjSZFAXXaQ0pXa_!!2747985175.jpg", //string 宝贝图片(attr=top_item)
                "item_title": "新中式 东方古典神韵 丝麻提花前襟盘花扣两色上衣 S07010特", //string 宝贝标题(attr=top_item)
                "price": 568, //float,宝贝价格 (attr=top_item)
            }, ...]},
    }
    

    Brand

    品牌信息

    BrandList

    类目列表

    HTTP Request

    GET http://console.moojing.com/api/cats/<string:catid>/brands

    请求参数

    参数名称 类型 是否必须 事例值 描述
    catid String Y 50008906 类目ID
    market string Y all 平台类型(all-全网,taobao-淘宝, tmall-天猫)

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": [{
            "brand_id": "332322", //string 品牌ID
            "brand_title": "伊利", //string 品牌名称
        }, ]
    }
    

    BrandData

    品牌

    HTTP Request

    GET http://console.moojing.com/api/cats/<string:catid>/brands/<string:brandid>

    请求参数

    参数名称 类型 是否必须 事例值 描述
    catid String Y 50008906 类目ID
    brandid String Y 3547097 品牌ID
    attr string Y top_brand 行业数据类型(top_shop-热销店铺, top_item-热销宝贝)
    market string Y all 平台类型(all-全网,taobao-淘宝, tmall-天猫)
    page int N 1 页数
    page_size int N 10 每页记录数
    month string N 2017-07 月份(从2016-04开始)

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //
          data: [{
                "rank": 1 // int 排名
                "sale_index": 1221, //int 销售指数            
                "shop_id": 5231223,// int 店铺ID(attr=top_shop)
                "shop_level": 15,// int 店铺等级(attr=top_shop)
                "shop_logo": "http://img.taobaocdn.com/shop-logo/8b/61/T1lXHcFjXcXXb1upjX.jpg",// string 店铺logo(attr=top_shop)
                "shop_title": "",// string 店铺名称(attr=top_shop)
                "shop_type": "cshop"// string 店铺类型(attr=top_shop)
                "shop_ww": "",// string 店铺旺旺(attr=top_shop)
                "item_id": "554731905157", //string 宝贝ID(attr=top_item)
                "item_image": "//img.alicdn.com/bao/uploaded/i1/2747985175/TB2MmxgAbBmpuFjSZFAXXaQ0pXa_!!2747985175.jpg", //string 宝贝图片(attr=top_item)
                "item_title": "新中式 东方古典神韵 丝麻提花前襟盘花扣两色上衣 S07010特", //string 宝贝标题(attr=top_item)
                "price": 568, //float,宝贝价格 (attr=top_item)
          }, ...]},
    }
    

    Word

    WordMonitor

    关键词监控

    HTTP Request

    GET http://console.moojing.com/api/words/monitor

    请求参数

    参数名称 类型 是否必须 事例值 描述
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 1,
          data: [{
                "word": xxxx, //关键词            
                "t": "2017-08-16",// string 监控时间
          }, ...]},
    }
    

    WordMonitorMan

    添加或者删除关键词监控

    HTTP Request

    PUT http://console.moojing.com/api/words/<string:word>/monitor

    DELETE http://console.moojing.com/api/words/<string:word>/monitor

    PUT添加关键词,DELETE删除关键词

    请求参数

    参数名称 类型 是否必须 事例值 描述
    word string Y 扳手 要监控或者删除的关键词

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": ""
    }
    

    WordCrawler

    爬取关键词的原始数据

    HTTP Request

    GET http://console.moojing.com/api/words/search/<string:word>/<string:plat>

    PUT添加关键词,DELETE删除关键词

    请求参数

    参数名称 类型 是否必须 事例值 描述
    word string Y 扳手 查询的关键词
    plat string Y organic 原始数据平台(organic-自然搜索,samba-直通车,mobile-手机搜索)
    page int N 1 页数
    page_size int N 20 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          data: [{
                "item_id": "543874491045", //宝贝ID            
                "item_image": "xxxx",//宝贝图片链接,mobile没有
                "item_title": "HLA/海澜之家印花短袖t恤2017夏季热卖白色圆领t恤短袖男",//宝贝标题
                "rank": 1, //排名
                "shop_ww": "", //店铺旺旺
          }, ...]},
    }
    

    Search

    ShopCats

    店铺类目列表

    HTTP Request

    GET http://console.moojing.com/api/shopcats

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          data: [{
                "cid": 1221, //int 类目ID            
                "name": "xxxx",// string 类目名称
          }, ...]},
    }
    

    ShopSearch

    店铺搜索

    HTTP Request

    GET http://console.moojing.com/api/shops/search

    请求参数

    参数名称 类型 是否必须 事例值 描述
    q string Y 茵曼 店铺名称或者旺旺包含的词
    order_by string Y sales 排序字段
    desc string N true 是否降序排序(默认降序)
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //
          data: [{  
                ShopInfo
                "tk_total_fee": 42423,//淘客月佣金
                "tk_total_sold": 233,// 淘客月推广量
          }, ...]},
    }
    

    ItemSearch

    宝贝搜索

    HTTP Request

    GET http://console.moojing.com/api/items/search

    请求参数

    参数名称 类型 是否必须 事例值 描述
    q string Y 茵曼 店铺名称或者旺旺包含的词
    order_by string Y sales 排序字段
    desc string N true 是否降序排序(默认降序)
    page int N 1 页数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
          "ts": "2017-08-15", //更新时间
          "count": 221, //
          data: [{  
                ItemInfo
                "sold": 15,// 月销量
          }, ...]},
    }
    

    UserConfig

    用户配置信息

    ShopMonitor

    店铺监控

    HTTP Request

    PUT http://console.moojing.com/api/shops/<string:shopww>/monitor

    DELETE http://console.moojing.com/api/shops/<string:shopww>/monitor

    PUT添加店铺监控,DELETE删除店铺监控

    请求参数

    参数名称 类型 是否必须 事例值 描述
    shopww string Y 韩都衣舍旗舰店 店铺旺旺

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {"msg": xxx}
    }
    

    ItemMonitor

    宝贝监控

    HTTP Request

    PUT http://console.moojing.com/api/items/<string:itemid>/monitor

    DELETE http://console.moojing.com/api/items/<string:itemid>/monitor

    PUT添加店铺监控,DELETE删除店铺监控

    请求参数

    参数名称 类型 是否必须 事例值 描述
    itemid string Y 531759407275 宝贝ID

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {"msg": xxx}
    }
    

    MMI

    市场情报

    SiteSummary

    原生类目概要数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/summary

    获取市场情报原生类目概要数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "avg_price": 32.1035, //宝贝均价
            "iscatparent": true, //是否有子类目
            "market_share": 100, //在上一级类目中的市场份额
            "names":{
                "bid": null, //品牌名称, 输入brandid=all时为null
                "cid": null, //类目名称, 输入catid=0时为null
                "cid_path": null, //类目全路径名称,输入catid=0时为null
                "plat": "淘宝+天猫", //平台名称
            },
            "sales": 366018297848.1001, //销售额
            "sold": 11401194165, //销量
        }
    }
    

    UniSummary

    统一类目概要数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/summary

    获取市场情报统一类目概要数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-所有平台,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "avg_price": 32.1035, //宝贝均价
            "iscatparent": true, //是否有子类目
            "market_share": 100, //在上一级类目中的市场份额
            "names":{
                "bid": null, //品牌名称, 输入brandid=all时为null
                "cid": null, //类目名称, 输入catid=0时为null
                "cid_path": null, //类目全路径名称,输入catid=0时为null
                "plat": "淘宝+天猫", //平台名称
            },
            "sales": 366018297848.1001, //销售额
            "sold": 11401194165, //销量
        }
    }
    

    SiteTrend

    原生类目趋势数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/trend

    获取市场情报原生类目趋势数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    type string Y month 趋势类型(month-按月趋势,quarter-按季度趋势,year-按年趋势)

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "sale": [[1356969600000, 122313],...], //销售额趋势 [时间戳,销售额]列表
            "sold": [[1356969600000, 12230],...], //销量趋势 [时间戳,销量]列表
        }
    }
    

    UniTrend

    统一类目趋势数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/trend

    获取市场情报统一类目趋势数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-所有平台,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    type string Y month 趋势类型(month-按月, quarter-按季度, year-按年)

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "sale": [[1356969600000, 122313],...], //销售额趋势 [时间戳,销售额]列表
            "sold": [[1356969600000, 12230],...], //销量趋势 [时间戳,销量]列表
        }
    }
    

    SiteSubNode

    原生类目子节点数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/list

    获取市场情报原生类目子节点数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    type string Y cat 子节点类型(cat-类目, brand-品牌)
    page int N 1 页码数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//子节点数据
                "avg_price": 32.1035, //宝贝均价
                "category_id": 16, //类目id(输入type=cat时返回)
                "category_name": "女装", //类目名称(输入type=cat时返回)
                "brand_id": xxx, //品牌id(输入type=brand时返回)
                "brand_name": xxx, //品牌名称(输入type=brand时返回)
                "item_num": 1211, //宝贝数
                "shop_num": 112, //店铺数
                "market_share": 0.1287, //在上一级类目中的市场份额
                "sale": 366018297848.1001, //销售额
                "sold": 11401194165, //销量
            }, ...]
        }
    }
    

    UniSubNode

    统一类目子节点数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/list

    获取市场情报统一类目子节点数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-所有平台,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    type string Y cat 子节点类型(plat-平台, cat-类目, brand-品牌)
    page int N 1 页码数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//子节点数据
                "avg_price": 32.1035, //宝贝均价
                "plat_id": "tmall", //平台ID(输入type=plat时返回)
                "platname": "天猫", //平台名称(输入type=plat时返回)
                "category_id": 16, //类目id(输入type=cat时返回)
                "category_name": "女装", //类目名称(输入type=cat时返回)
                "brand_id": xxx, //品牌id(输入type=brand时返回)
                "brand_name": xxx, //品牌名称(输入type=brand时返回)
                "item_num": 1211, //宝贝数
                "shop_num": 112, //店铺数
                "market_share": 0.1287, //在上一级类目中的市场份额
                "sale": 366018297848.1001, //销售额
                "sold": 11401194165, //销量
            }, ...]
        }
    }
    

    SiteHotShops

    原生类目热销店铺数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/hot_shops

    获取市场情报原生类目热销店铺数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    page int N 1 页码数
    page_size int N 10 每页记录数

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//店铺数据
                "uid": 232334, //店铺ID
                "shop_name": "美的旗舰店", //店铺名称
                "platform": "tmall", //平台id
                "sale": 2311333, //销售额
                "sold": 11232, //销量
            }, ...]
        }
    }
    

    UniHotShops

    统一类目热销店铺数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/hot_shops

    获取市场情报统一类目热销店铺数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-所有平台,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    page int N 1 页码数
    page_size int N 10 每页记录数

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//店铺数据
                "uid": 232334, //店铺ID
                "shop_name": "美的旗舰店", //店铺名称
                "platform": "tmall", //平台id
                "sale": 2311333, //销售额
                "sold": 11232, //销量
            }, ...]
        }
    }
    

    SiteHotItems

    原生类目热销宝贝数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/hot_items

    获取市场情报原生类目热销宝贝数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    page int N 1 页码数
    page_size int N 10 每页记录数

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//宝贝数据
                "item_id": 232334, //宝贝ID
                "pic": "//img.alicdn.com/bao/uploaded/i1/TB1CpZhSpXXXXbmapXXXXXXXXXX_!!0-item_pic.jpg", //宝贝图片
                "title": "xxxx", //宝贝标题
                "shop_name": "sass", //店铺名称
                "uid": "232", //店铺ID
                "price": 2211, //宝贝价格
                "platform": "tmall", //平台id
                "sale": 2311333, //销售额
                "sold": 11232, //销量
            }, ...]
        }
    }
    

    UniHotItems

    统一类目热销宝贝数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/hot_items

    获取市场情报统一类目热销宝贝数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-所有平台,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    start string Y 2017-07 月份
    page int N 1 页码数
    page_size int N 10 每页记录数

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//宝贝数据
                "item_id": 232334, //宝贝ID
                "pic": "//img.alicdn.com/bao/uploaded/i1/TB1CpZhSpXXXXbmapXXXXXXXXXX_!!0-item_pic.jpg", //宝贝图片
                "title": "xxxx", //宝贝标题
                "shop_name": "sass", //店铺名称
                "uid": "232", //店铺ID
                "price": 2211, //宝贝价格
                "platform": "tmall", //平台id
                "sale": 2311333, //销售额
                "sold": 11232, //销量
            }, ...]
        }
    }
    

    SiteCompare

    原生类目销量销售额对比

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/compare

    获取市场情报原生类目两个时间段销量,销售额对比情况

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    compare_range string Y ["2015-10,2015-12","2016-01,2016-03"] 对比的时间参数,json格式的字符串,示例值表示比较2015年10月到12月 和 2016年1月到3月这两个时间段的销售数据

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "2015-10,2015-12": {//输入的时间段数据
                "sale": 3223322, //这个时间段的销售额
                "sold": 55332, //这个时间段的销量
            },
            "2016-01,2016-03": {//输入时间段的数据
                "sale": 3223322, //这个时间段的销售额
                "sold": 55332, //这个时间段的销量
            }
        }
    }
    

    UniCompare

    统一类目销量销售额对比

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/compare

    获取市场情报统一类目两个时间段销量,销售额对比情况

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y all 平台ID(包括all-淘宝+天猫,cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    compare_range string Y ["2015-10,2015-12","2016-01,2016-03"] 对比的时间参数,json格式的字符串,示例值表示比较2015年10月到12月 和 2016年1月到3月这两个时间段的销售数据

    仅当catid != '0' 或者 brandid != 'all'的时候有数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "2015-10,2015-12": {//输入的时间段数据
                "sale": 3223322, //这个时间段的销售额
                "sold": 55332, //这个时间段的销量
            },
            "2016-01,2016-03": {//输入时间段的数据
                "sale": 3223322, //这个时间段的销售额
                "sold": 55332, //这个时间段的销量
            }
        }
    }
    

    SiteCommentTrend

    原生类目评论趋势数据

    HTTP Request

    GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/comment_trend

    获取市场情报原生类目评论趋势数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y tmall 平台ID(tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    type string Y month 趋势类型(month-按月趋势,quarter-按季度趋势,year-按年趋势)

    注意: 淘宝和淘宝+天猫平台没有此数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "bad": [[1356969600000, 1.1],...], //差评率趋势 [时间戳,差评率]列表
            "good": [[1356969600000, 96.6],...], //好评率趋势 [时间戳,好评率]列表
            "neutral": [[1356969600000, 2.3],...], //中评率趋势 [时间戳,中评率]列表,天猫平台没有此数据
            "count": [[1356969600000, 1222456],...], //评论数趋势 [时间戳,评论数]列表,天猫平台没有此数据
        }
    }
    

    UniCommentTrend

    统一类目评论趋势数据

    HTTP Request

    GET https://market.moojing.com/api/standard/platform/<string:plat>/cats/<string:catid>/brands/<string:brandid>/comment_trend

    获取市场情报统一类目评论趋势数据

    请求参数

    参数名称 类型 是否必须 事例值 描述
    plat string Y tmall 平台ID(tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
    catid string Y 16 类目ID(0表示所有类目)
    brandid string Y 29973 品牌ID(all表示所有品牌)
    type string Y month 趋势类型(month-按月, quarter-按季度, year-按年)

    注意: 淘宝和淘宝+天猫平台没有此数据

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "bad": [[1356969600000, 1.1],...], //差评率趋势 [时间戳,差评率]列表
            "good": [[1356969600000, 96.6],...], //好评率趋势 [时间戳,好评率]列表
            "neutral": [[1356969600000, 2.3],...], //中评率趋势 [时间戳,中评率]列表,天猫平台没有此数据
            "count": [[1356969600000, 1222456],...], //评论数趋势 [时间戳,评论数]列表,天猫平台没有此数据
        }
    }
    

    SearchCatBrand

    品牌行业搜索

    HTTP Request

    GET https://market.moojing.com/api/search/<string:q>

    搜索保护此关键词的品牌和行业

    请求参数

    参数名称 类型 是否必须 事例值 描述
    q string Y 宝洁 品牌或者行业包含的关键词
    page int N 1 页码数
    page_size int N 10 每页记录数

    返回json格式的字符串,如下所示:

    {
        "status": "", //["ok", "error"]
        "result": {
            "count": 122, //总的数据量
            "data": [{//宝贝数据
                "brand_id": null, //品牌ID(返回品牌数据非空)
                "brand_name": null, //品牌名称(返回品牌数据非空)
                "category_id": null, //宝贝标题(返回行业数据非空)
                "category_name": null, //店铺名称(返回行业数据非空)
                "standard": true, //是否是统一类目或者品牌
            }, ...]
        }
    }
    

    Errors

    魔镜API错误代码:

    如果调用api出错了,返回值将是如下所示的json格式的字符串

    {
        "status": "error",
        "error_code": 400,
        "error_msg": "Invalid Request"
    }
    
    错误码 描述
    400 Bad Request -- 请求的参数错误.
    -401 尚未登录.
    -403 没有相应的权限.
    -411 账户没钱了,不能调用
    -412 非法APIKEY
    -413 当天API到限额了,不能再调用了
    -405 api方法错误
    429 访问太快了,被限速
    500 服务器错误,稍候再试.