NAV Navbar
python

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, {})

MMI

市场情报

接口通用参数

参数名称 类型 是否必须 事例值 描述
currency string N 'CNY', 'JPY', 'GBP', 'EUR', 'USD' 用于改变返回数据的货币单位，如果没有传或者不在这五个中（传入的值需为大写），选用用户配置的默认汇率

CategoryTree

各平台类目信息

HTTP Request

GET https://market.moojing.com/api/cats_tree

获取各个平台类目的信息

请求参数

参数名称 类型 是否必须 事例值 描述
last_time string N 2016-05-23 10:00:00 类目最后的更新时间，用于判断是否更新类目数据
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, amazon-亚马逊中国, dd-当当, gome-国美, jd-京东, jm-聚美优品, sn-苏宁, yhd-一号店, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营)
lang string N zh 返回结果的语言（仅支持zh和en）
rcid string N 16 类目id，传入此id后仅返回此id相关的类目信息,以及全部一级类目信息

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

{
    "status": "", //["ok", "error"]
    "result": {
        "bigCategory":["16","30"], // 一级类目id列表
        "maxDepth":4, // 类目树最深层级
        "childrenList":{
            "11":{
                "has_brand": 0, //类目下是否有品牌
                "category_name_en": "Computer hardware / monitor / computer peripheral", // 类目英文名称
                "name": "电脑硬件/显示器/电脑周边",  // 类目中文名称
                "is_parent": true, // 是否是父类目
                "level": 1, //类目层级
                "parent_id": "0",  // 父类目id
                "num": 10,  // 内部字段，对于用户无意义
                "has_model": 0, // 内部字段，对于用户无意义
                "chd": ["110203", "110206", "110202", "110201", "110207", "50003321", "110210", "50012307", "50013151",…], // 子类目id
                "category_id": "11" // 类目id
            }
    }
}

LatestMonth

各平台数据最新时间

HTTP Request

GET https://market.moojing.com/api/latesttime

获取市场情报各平台数据最新时间

请求参数

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

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

{
    "status": "", //["ok", "error"]
    "result": {
        "start": "2016-04", // 最早数据日期
        "end": "2019-10"  // 最新数据日期
    }
}

UserMonitor

用户订阅信息

HTTP Request

GET https://market.moojing.com/api/marked

获取市场情报用户订阅或关注的类目、品牌、地域等信息

请求参数

参数名称 类型 是否必须 事例值 描述
isdashboard string Y true 选择获取订阅或关注信息（true为订阅信息，false为关注信息）
lang string N zh 返回结果的语言（仅支持zh和en）

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

{
    "status": "", //["ok", "error"]
    "result": {
        "data":[
            {
                "platform": "wykl", // 平台id
                "brand_name": "Merries 花王妙而舒", // 品牌名称
                "standard": false, // 是否是统一类目（目前该字段已无效）
                "brand_id": "988", // 品牌id
                "platname": "网易考拉", // 平台名称
                "ts_range": [["2018-01", "2018-02"]], // 订阅的时间段
                "category_id": "0", // 类目id
                "type": "brand", // 订阅类型（有category，brand，region等）
                "category_name": "全部", // 类目名称
            }
        ],
        "pagetype":"table"  // 内部字段，对于用户无意义
    }
}

JdVersion

京东相关平台数据模型版本

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/version

获取京东相关平台数据模型版本信息

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y jd 平台ID(仅支持jd相关平台，包括jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营，jd_hk-京东全球购)

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

{
    "status": "", //["ok", "error"]
    "result": ["sold_v2_c", "sold", "sold_rate", "sold_rate_new_c", "sold_v4", "sold_v2", "sold_v2_c2", "sold_v2_c3"]
}

SearchTotalBrand

搜索品牌数据

HTTP Request

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

获取市场情报品牌的搜索数据

请求参数

参数名称 类型 是否必须 事例值 描述
word string Y huawei/002032/aapl 搜索关键词/股票代码

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

{
    "status": "", //["ok", "error"]
    "result": [
        {  // 搜索股票代码结果
            "count": 29,  // 搜索总数
            "company_name_en": "Apple",  // 品牌名称
            "data": [
                {
                    "data": [
                        {
                            "_score": -1,
                            "bid": "10216670", // 平台下品牌id
                            "plat": "taobao", // 所属平台
                            "name": "苹果/APPLE"
                        }
                    ],
                    "name": "苹果/apple"
                }, ...
            ],
            "company_name": "Apple"
        },
        {  // 搜索品牌名称结果
            "count": 25, // 搜索总数
            "data":[
                {
                    "name": "华为(huawei)", // 品牌名称
                    "sale": 4003980768.2734485, // 品牌总销售额
                    "data":[
                        {
                        "data": [
                            {
                                "_score": 11.077647, // 与搜索内容匹配得分
                                "bid": "10066113", // 平台下品牌id
                                "plat": "jd", // 所属平台
                                "name": "华为(huawei)"
                            }
                        ],
                        "name": "华为(huawei)"
                    },…
                    ]

                }
            ]
        }
    ]
}

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 月份
lang string Y zh,en 语言

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

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

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-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
YoY string N true 是否返回同环比数据，只要传此参数，默认返回同环比数据
type string Y month 趋势类型(month-按月趋势，quarter-按季度趋势，year-按年趋势)

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

// 注意：不同平台可能会缺少某些字段
{
    "status": "", //["ok", "error"]
    "result": {
        "sale": [[1356969600000, 122313],...], //销售额趋势 [时间戳，销售额]列表
        "qoq": [[1356969600000, 0.03957261574990107],...], //销售额环比列表（目前只有淘宝天猫平台有此字段）
        "yoy": [[1356969600000, 0.03957261574990107],...], //销售额同比列表（目前只有淘宝天猫平台有此字段）
        "sold": [[1356969600000, 12230],...], //销量趋势 [时间戳，销量]列表
        "sold_qoq": [[1356969600000, 0.03957261574990107],...], //销量环比列表（目前只有淘宝天猫平台有此字段）
        "sold_yoy": [[1356969600000, -0.13957261574990107],...], //销量同比列表（目前只有淘宝天猫平台有此字段）
        "avg_price": [[1356969600000, 50.24],...], //均价列表
        "avg_price_qoq": [[1356969600000, -0.03957261574990107],...], //均价环比列表（目前只有淘宝天猫平台有此字段）
        "avg_price_yoy": [[1356969600000, -0.03957261574990107],...], //均价同比列表（目前只有淘宝天猫平台有此字段）
        "item_num": [[1356969600000, 81689069],...], //宝贝数
        "item_num_qoq": [[1356969600000, -0.03957261574990107],...], //宝贝数环比列表（目前只有淘宝天猫平台有此字段）
        "item_num_yoy": [[1356969600000, -0.03957261574990107],...], //宝贝数同比列表（目前只有淘宝天猫平台有此字段）
        "shop_num": [[1356969600000, 81689069],...], //店铺数
        "shop_num_qoq": [[1356969600000, -0.03957261574990107],...], //店铺数环比列表（目前只有淘宝天猫平台有此字段）
        "shop_num_yoy": [[1356969600000, -0.03957261574990107],...], //店铺数同比列表（目前只有淘宝天猫平台有此字段）
        "market_share": [[1356969600000, 0.13957261574990107],...], // 市场份额

    }
}

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-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
start string Y 2017-07 月份
type string Y cat 子节点类型(cat-类目, brand-品牌,provice-省份)
page int N 1 页码数
page_size int N 10 每页记录数

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

// type=cat时
{
    "status": "", //["ok", "error"]
    "result": {
        "count": 122, //总的数据量
        "data": [{//子节点数据
            "avg_price": 32.1035, //宝贝均价
            "avg_price_qoq": 0.7206946454413893, //宝贝均价环比（仅淘宝天猫有此字段）
            "avg_price_yoy": 0.25554382259767683, //宝贝均价同比（仅淘宝天猫有此字段）
            "category_id": 16, //类目id
            "category_name": "女装", //类目名称
            "category_name_en": "Ladies / Ladies", //类目英文名称            
            "item_num": 1211, //宝贝数
            "item_num_qoq": -0.04050355774493705, //宝贝数环比（仅淘宝天猫有此字段）
            "item_num_yoy": 0.11572065035005497,//宝贝数同比（仅淘宝天猫有此字段）
            "shop_num": 30487, //店铺数
            "shop_num_qoq": -0.04050355774493705, //店铺数环比（仅淘宝天猫有此字段）
            "shop_num_yoy": 0.11572065035005497,//店铺数同比（仅淘宝天猫有此字段）
            "market_share": 0.1287, //在上一级类目中的市场份额
            "market_share_qoq": -0.04050355774493705, //市场份额环比（仅淘宝天猫有此字段）
            "market_share_yoy": 0.11572065035005497,//市场份额同比（仅淘宝天猫有此字段）
            "sale": 366018297848.1001, //销售额
            "sold": 11401194165, //销量
            "qoq": -0.04050355774493705, //销售额环比（仅淘宝天猫京东有此字段）
            "yoy": 0.11572065035005497,//销售额同比（仅淘宝天猫京东有此字段）
        }, ...]
    }
}

// type=brand时，部分字段同上
{
    "status": "", //["ok", "error"]
    "result": {
        "count": 200, //总的数据量
        "data": [{//子节点数据
            "brand_name": "苹果/APPLE", // 品牌名称
            "brand_id": "10216670", // 品牌id
            "shop_num_qoq": -0.047904191616800006, // 店铺数环比
            "shop_num_qoq_val": 167.00000000000588, // 店铺数环比值
            "shop_num_yoy": 0.282258064516, // 店铺数同比
            "avg_price_qoq_val": 1238.1000000002437, // 宝贝均价环比值
            "item_num_yoy_val": 0, // 宝贝数同比值
            "sold_yoy": 0.6817407318790002, // 销量同比
            "item_num_qoq_val": 1628.9999999999734, // 宝贝数环比值
            "sold_qoq": 0.03055305630529997, // 销量环比
            "item_num_qoq": 0.059545733578900056, // 宝贝数环比
            "sale_yoy": 0.50155444694, // 销售额同比
            "market_share": 0.0088,
            "sold": 927776, // 销量
            "sale_yoy_val": 0, // 销售额同比值
            "sale_qoq_val": 1114624926.0001647, // 销售额环比值
            "shop_num": 159.0, // 店铺数
            "sale_qoq": 0.7041180774739998, // 销售额环比
            "qoq": 0.7041180774739998,
            "shop_num_yoy_val": 0, // 店铺数同比值
            "item_num": 1726.0, // 宝贝数
            "item_num_yoy": 0, // 宝贝数同比
            "avg_price_qoq": 0.6535982553909999, // 宝贝均价环比
            "yoy": 0.50155444694,
            "sold_yoy_val": 0, // 销量同比值
            "avg_price": 2047.32, // 宝贝均价
            "sale": 1899452486.0, // 销售额
            "category_id": "0", // 当前类目id
            "sold_qoq_val": 900270.0000000268, // 销量环比值
            "avg_price_ps": 2091.13, // ps数据模型版本宝贝均价
            "avg_price_ps_qoq": 0.6889831192960001, // ps数据模型版本宝贝均价环比
            "avg_price_ps_qoq_val": 1238.0999999997764, // ps数据模型版本宝贝均价环比值
            "avg_price_ps_yoy": 0, // ps数据模型版本宝贝均价同比
            "avg_price_ps_yoy_val": 0, // ps数据模型版本宝贝均价同比值
            "sale_ps": 1970446680.0, // ps数据模型版本销售额
            "sale_ps_qoq": 0.7678114261009997, // ps数据模型版本销售额环比
            "sale_ps_qoq_val": 1114624926.0001237, // ps数据模型版本销售额环比值
            "sale_ps_yoy": 0.5576767498100001, // ps数据模型版本销售额同比
            "sale_ps_yoy_val": 0, // ps数据模型版本销售额同比值
            "sold_ps": 942290.0, // ps数据模型版本销量
            "sold_ps_qoq": 0.04667488642300003, // ps数据模型版本销量环比
            "sold_ps_qoq_val": 900269.9999999673, // ps数据模型版本销量环比值
            "sold_ps_yoy": 0, // ps数据模型版本销量同比
            "sold_ps_yoy_val": 0, // ps数据模型版本销量同比值
            "avg_price_ds3": 2029.48, // ds3数据模型版本宝贝均价
            "avg_price_ds3_qoq": 0.6573542502019999, // ds3数据模型版本宝贝均价环比
            "avg_price_ds3_qoq_val": 1224.5300000000875, // ds3数据模型版本宝贝均价环比值
            "avg_price_ds3_yoy": 0, // ds3数据模型版本宝贝均价同比
            "avg_price_ds3_yoy_val": 0, // ds3数据模型版本宝贝均价同比值
            "sale_ds3": 1912360284.0, // ds3数据模型版本销售额
            "sale_ds3_qoq": 0.7347164373339999, // ds3数据模型版本销售额环比
            "sale_ds3_qoq_val": 1102405121.0000708, // ds3数据模型版本销售额环比值
            "sale_ds3_yoy": 0, // ds3数据模型版本销售额同比
            "sale_ds3_yoy_val": 0, // ds3数据模型版本销售额同比值
            "sold_ds3": 942290.0, // ds3数据模型版本销量
            "sold_ds3_qoq": 0.04667488642300003, // ds3数据模型版本销量环比
            "sold_ds3_qoq_val": 900269.9999999673, // ds3数据模型版本销量环比值
            "sold_ds3_yoy": 0.7080496523319998, // ds3数据模型版本销量同比
            "sold_ds3_yoy_val": 0, // ds3数据模型版本销量同比值
            "avg_price_cp": 1967.17, // cp数据模型版本宝贝均价
            "avg_price_cp_qoq": 0.6999101294479999, // cp数据模型版本宝贝均价环比
            "avg_price_cp_qoq_val": 1157.2200000001092, // cp数据模型版本宝贝均价环比值
            "avg_price_cp_yoy": -0.11373967733400005, // cp数据模型版本宝贝均价同比
            "avg_price_cp_yoy_val": 0, // cp数据模型版本宝贝均价同比值
            "sale_cp": 1853643679.0, // cp数据模型版本销售额
            "sale_cp_qoq": 0.779250403093, // cp数据模型版本销售额环比
            "sale_cp_qoq_val": 1041811583.000165, // cp数据模型版本销售额环比值
            "sale_cp_yoy": 0.5137778224340003, // cp数据模型版本销售额同比
            "sale_cp_yoy_val": 0, // cp数据模型版本销售额同比值
            "sold_cp": 942290.0, // cp数据模型版本销量
            "sold_cp_qoq": 0.04667488642300003, // cp数据模型版本销量环比
            "sold_cp_qoq_val": 900269.9999999673, // cp数据模型版本销量环比值
            "sold_cp_yoy": 0 // cp数据模型版本销量同比
            "sold_cp_yoy_val": 0, // cp数据模型版本销量同比值
            "avg_price_ds3_ps_cp": 1906.82, // ds3_ps_cp数据模型版本宝贝均价
            "avg_price_ds3_ps_cp_qoq": 0.6619195370240002, // ds3_ps_cp数据模型版本宝贝均价环比
            "avg_price_ds3_ps_cp_qoq_val": 1147.360000000086, // ds3_ps_cp数据模型版本宝贝均价环比值
            "avg_price_ds3_ps_cp_yoy": 0, // ds3_ps_cp数据模型版本宝贝均价同比
            "avg_price_ds3_ps_cp_yoy_val": 0, // ds3_ps_cp数据模型版本宝贝均价同比值
            "sale_ds3_ps_cp": 1796780988.0, // ds3_ps_cp数据模型版本销售额
            "sale_ds3_ps_cp_qoq": 0.739488746553, // ds3_ps_cp数据模型版本销售额环比
            "sale_ds3_ps_cp_qoq_val": 1032936252.9999295, // ds3_ps_cp数据模型版本销售额环比值
            "sale_ds3_ps_cp_yoy": 0, // ds3_ps_cp数据模型版本销售额同比
            "sale_ds3_ps_cp_yoy_val": 0, // ds3_ps_cp数据模型版本销售额同比值
            "sold_ds3_ps_cp": 942290.0, // ds3_ps_cp数据模型版本销量
            "sold_ds3_ps_cp_qoq": 0.04667488642300003, // ds3_ps_cp数据模型版本销量环比
            "sold_ds3_ps_cp_qoq_val": 900269.9999999673, // ds3_ps_cp数据模型版本销量环比值
            "sold_ds3_ps_cp_yoy": 0.7080496523319998, // ds3_ps_cp数据模型版本销量同比
            "sold_ds3_ps_cp_yoy_val": 0, // ds3_ps_cp数据模型版本销量同比值
            "avg_price_ps_cp": 1967.17, // ps_cp数据模型版本宝贝均价
            "avg_price_ps_cp_qoq": 0.6999101294479999, // ps_cp数据模型版本宝贝均价环比
            "avg_price_ps_cp_qoq_val": 1157.2200000001092, // ps_cp数据模型版本宝贝均价环比值
            "avg_price_ps_cp_yoy": -0.11373967733400005, // ps_cp数据模型版本宝贝均价同比
            "avg_price_ps_cp_yoy_val": 0, // ps_cp数据模型版本宝贝均价同比值
            "sale_ps_cp": 1853643679.0, // ps_cp数据模型版本销售额
            "sale_ps_cp_qoq": 0.779250403093, // ps_cp数据模型版本销售额环比
            "sale_ps_cp_qoq_val": 1041811583.000165, // ps_cp数据模型版本销售额环比值
            "sale_ps_cp_yoy": 0, // ps_cp数据模型版本销售额同比
            "sale_ps_cp_yoy_val": 0, // ps_cp数据模型版本销售额同比值
            "sold_ps_cp": 942290.0, // ps_cp数据模型版本销量
            "sold_ps_cp_qoq": 0.04667488642300003, // ps_cp数据模型版本销量环比
            "sold_ps_cp_qoq_val": 900269.9999999673, // ps_cp数据模型版本销量环比值
            "sold_ps_cp_yoy": 0.7080496523319998, // ps_cp数据模型版本销量同比
            "sold_ps_cp_yoy_val": 0, // ps_cp数据模型版本销量同比值
            "avg_price_ds3_ps": 2029.48, // ds3_ps数据模型版本宝贝均价
            "avg_price_ds3_ps_qoq": 0.6573542502019999, // ds3_ps数据模型版本宝贝均价环比
            "avg_price_ds3_ps_qoq_val": 1224.5300000000875, // ds3_ps数据模型版本宝贝均价环比值
            "avg_price_ds3_ps_yoy": 0, // ds3_ps数据模型版本宝贝均价同比
            "avg_price_ds3_ps_yoy_val": 0, // ds3_ps数据模型版本宝贝均价同比值
            "sale_ds3_ps": 1912360284.0, // ds3_ps数据模型版本销售额
            "sale_ds3_ps_qoq": 0.7347164373339999, // ds3_ps数据模型版本销售额环比
            "sale_ds3_ps_qoq_val": 1102405121.0000708, // ds3_ps数据模型版本销售额环比值
            "sale_ds3_ps_yoy": 0.5106963444659999, // ds3_ps数据模型版本销售额同比
            "sale_ds3_ps_yoy_val": 0, // ds3_ps数据模型版本销售额同比值
            "sold_ds3_ps": 942290.0, // ds3_ps数据模型版本销量
            "sold_ds3_ps_qoq": 0.04667488642300003, // ds3_ps数据模型版本销量环比
            "sold_ds3_ps_qoq_val": 900269.9999999673, // ds3_ps数据模型版本销量环比值
            "sold_ds3_ps_yoy": 0.7080496523319998, // ds3_ps数据模型版本销量同比
            "sold_ds3_ps_yoy_val": 0, // ds3_ps数据模型版本销量同比值
            "avg_price_min": 1825.02, // min数据模型版本宝贝均价
            "avg_price_min_qoq": 0.6681321694619999, // min数据模型版本宝贝均价环比
            "avg_price_min_qoq_val": 1094.0500000000593, // min数据模型版本宝贝均价环比值
            "sale_min": 1719700836.0, // min数据模型版本销售额
            "sale_min_qoq": 0.745998402201, // min数据模型版本销售额环比
            "sale_min_qoq_val": 984938378.9997463, // min数据模型版本销售额环比值
            "sold_min": 942290.0, // min数据模型版本销量
            "sold_min_qoq": 0.04667488642300003, // min数据模型版本销量环比
            "sold_min_qoq_val": 900269.9999999673, // min数据模型版本销量环比值
            "avg_price_cp_tk": 1967.07, // cp_tk数据模型版本宝贝均价
            "avg_price_cp_tk_qoq": 0.7000000000000001, // cp_tk数据模型版本宝贝均价环比
            "avg_price_cp_tk_qoq_val": 1157.1, // cp_tk数据模型版本宝贝均价环比值
            "sale_cp_tk": 1853546549.0, // cp_tk数据模型版本销售额
            "sale_cp_tk_qoq": 0.7793487147080002, // cp_tk数据模型版本销售额环比
            "sale_cp_tk_qoq_val": 1041699434.0000274, // cp_tk数据模型版本销售额环比值
            "sold_cp_tk": 942290.0, // cp_tk数据模型版本销量
            "sold_cp_tk_qoq": 0.04667488642300003, // cp_tk数据模型版本销量环比
            "sold_cp_tk_qoq_val": 900269.9999999673, // cp_tk数据模型版本销量环比值
            "avg_price_ds3_cp": 1906.82, // ds3_cp数据模型版本宝贝均价
            "avg_price_ds3_cp_qoq": 0.6619195370240002, // ds3_cp数据模型版本宝贝均价环比
            "avg_price_ds3_cp_qoq_val": 1147.360000000086, // ds3_cp数据模型版本宝贝均价环比值
            "avg_price_ds3_cp_yoy": 0, // ds3_cp数据模型版本宝贝均价同比
            "avg_price_ds3_cp_yoy_val": 0, // ds3_cp数据模型版本宝贝均价同比值
            "sale_ds3_cp": 1796780988.0, // ds3_cp数据模型版本销售额
            "sale_ds3_cp_qoq": 0.739488746553, // ds3_cp数据模型版本销售额环比
            "sale_ds3_cp_qoq_val": 1032936252.9999295, // ds3_cp数据模型版本销售额环比值
            "sale_ds3_cp_yoy": 0.46276470692800015, // ds3_cp数据模型版本销售额同比
            "sale_ds3_cp_yoy_val": 0, // ds3_cp数据模型版本销售额同比值
            "sold_ds3_cp": 942290.0, // ds3_cp数据模型版本销量
            "sold_ds3_cp_qoq": 0.04667488642300003, // ds3_cp数据模型版本销量环比
            "sold_ds3_cp_qoq_val": 900269.9999999673, // ds3_cp数据模型版本销量环比值
            "sold_ds3_cp_yoy": 0, // ds3_cp数据模型版本销量同比
            "sold_ds3_cp_yoy_val": 0, // ds3_cp数据模型版本销量同比值
        }, ...]
    }
}

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-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
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": [{//店铺数据
            "comment": 1114497, //评论数
            "loc": "上海", // 店铺所在地
            "sale_index": 77318, // 内部字段，对于用户无意义
            "is_global": false, //内部字段，对于用户无意义
            "uid": "196993935", //店铺ID
            "qoq": 0.009946312486133247, //销售额环比
            "price": 0, //内部字段，对于用户无意义
            "sale": 153013569.82999998, //销售额
            "shop_name": "优衣库官方旗舰店", //店铺名称
            "ww": "优衣库官方旗舰店", // 店铺旺旺
            "shop_type": "tmall", // 内部字段，对于用户无意义
            "yoy": -0.20092915535338812, //销售额同比
            "item_num": 730, // 宝贝数
            "sold": 1302978, //销量
            "is_tmgj": false //内部字段，对于用户无意义
        }, ...]
    }
}

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-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
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": [{//宝贝数据
            "comment": "400", //宝贝评论数
            "price_ds3_ps_cp": "45.7082588598", //ds3_ps_cp据模型版本宝贝价格
            "old_pro_price": "129.8", // 内部字段，对于用户无意义
            "price_ps": "129.8", //ps据模型版本宝贝价格
            "brand_name": "ELF SACK/妖精的口袋", //宝贝所属品牌名称
            "item_id": "644238450371", //宝贝id
            "ftype1": "0", // 内部字段，对于用户无意义
            "ftype2": "0", // 内部字段，对于用户无意义
            "predict_ds3": "skus_nopredict", // 内部字段，对于用户无意义
            "price_ps_cp": "45.8", //ps_cp据模型版本宝贝价格
            "loc": "江苏 南京", //宝贝所属地
            "price_ds3_nofilter": "129.54", // 内部字段，对于用户无意义
            "title": "【21色IP联名】妖精的口袋情侣印花短袖t恤女2021夏纯棉宽松上衣", //商品名
            "sc_confirm": "676", // 确认收货数 
            "shop_name": "妖精的口袋旗舰店", //宝贝所属店铺名
            "min_price": "45.8", //极限价格
            "cat_path": [{ //宝贝类目路径
                "parent_id": "0", //父类目id
                "level": 1, //类目级别
                "category_id": "16", //类目id
                "category_name_en": "Ladies / Ladies", //类目英文名称
                "category_name": "女装/女士精品" //类目名称
            },...],
            "price_ds3_cp": "45.7082588598", //ds3_cp据模型版本宝贝价格
            "min_price_ds3": "45.71", //ds3据模型版本极限价格
            "sku_algo": "kde", // 内部字段，对于用户无意义
            "brand": "10518561", //宝贝所属品牌id
            "price_ds3_ps": "129.54", //ds3_ps据模型版本宝贝价格
            "price_nofilter": "129.8", // 内部字段，对于用户无意义
            "_nrby": false, // 内部字段，对于用户无意义
            "judge": "skus_judge", // 内部字段，对于用户无意义
            "is_global": false, // 内部字段，对于用户无意义
            "ds3_dens": "0", // 内部字段，对于用户无意义
            "is_tmgj": false, // 内部字段，对于用户无意义
            "reserve_price": "129.8", // 内部字段，对于用户无意义
            "uid": "362409818", //商品所属店铺id
            "predict": "skus_nopredict", // 内部字段，对于用户无意义
            "pic": "//g-search3.alicdn.com/img/bao/uploaded/i4/i1/362409818/O1CN01nSaoeL2MOhFh1s03r_!!0-item_pic.jpg",
            "sale": "28000066.6", //商品销售额
            "price_raw": "129.8",
            "sale_index": "25637", // 内部字段，对于用户无意义
            "price_cp_tk": "45.8", //cp_tk据模型版本宝贝价格
            "buy_count": null, // 内部字段，对于用户无意义
            "price_min": "45.8", //min据模型版本宝贝价格
            "_dens": "0", // 内部字段，对于用户无意义
            "sold": "215717", //商品销量
            "back_cid": "50000671", //宝贝所在的最深层类目
            "price": "129.8", //原价
            "ww": "妖精的口袋旗舰店", //商品所属店铺旺旺
            "ds3_nrby": false, // 内部字段，对于用户无意义
            "price_ds3": "129.54", //ds3据模型版本宝贝价格
            "pro_price_old": "129.8", // 内部字段，对于用户无意义
            "price_cp": "45.8", //cp据模型版本宝贝价格
            "shop_type": "tmall", // 内部字段，对于用户无意义
            "judge_ds3": "skus_judge", // 内部字段，对于用户无意义
            "has_detail": true, // 内部字段，对于用户无意义
        }, ...]
    }
}

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-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
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, //这个时间段的销量
        }
    }
}

RegionSiteSummary

原生类目地域下概要数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/summary

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

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营,jdhk-京东全球购 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
province string Y 浙江 省份
city string Y 杭州（没有城市传all） 城市
start string Y 2017-07 月份
lang string Y zh,en 语言

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

{
    "status": "", //["ok", "error"]
    "result": {
        "avg_price": 32.1035, //宝贝均价
        "brand_name": "AUX/奥克斯",//品牌名
        "iscatparent": true, //是否有子类目
        "market_share": 100, //在上一级类目中的市场份额
        "item_num": 1852,//宝贝数
        "shop_num": 159,//店铺数
        "marked": false,//是否被关注
        "names":{
            "province": "山东", // 所属省份
            "city": "烟台", // 所属城市
            "bid": null, //品牌名称, 输入brandid=all时为null
            "cid": null, //类目名称, 输入catid=0时为null
            "cid_path": null, //类目全路径名称，输入catid=0时为null
            "plat": "淘宝＋天猫", //平台名称
        },
        "sales": 366018297848.1001, //销售额
        "sold": 11401194165, //销量
    }
}

RegionSiteTrend

原生类目地域下趋势数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/trend

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

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营,jdhk-京东全球购 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
province string Y 浙江 省份
city string Y 杭州 城市
type string Y month 趋势类型(month-按月趋势，quarter-按季度趋势，year-按年趋势)

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

{
    "status": "", //["ok", "error"]
    "result": {
        "sale": [[1356969600000, 122313],...], //销售额趋势 [时间戳，销售额]列表
        "sold": [[1356969600000, 12230],...], //销量趋势 [时间戳，销量]列表
        "avg_price": [[1356969600000, 50.24],...], //均价列表
        "item_num": [[1356969600000, 81689069],...], //宝贝数        
        "shop_num": [[1356969600000, 81689069],...], //店铺数
        "market_share": [[1356969600000, 0.13957261574990107],...], // 市场份额
    }
}

RegionSiteSubNode

原生类目地域下子节点数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/list

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

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营,jdhk-京东全球购 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
province string Y 浙江 省份
city string Y 杭州 城市
start string Y 2017-07 月份
type string Y cat 子节点类型(cat-类目, brand-品牌,city-城市)
page int N 1 页码数
page_size int N 10 每页记录数

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

// type=cat时
{
    "status": "", //["ok", "error"]
    "result": {
        "count": 122, //总的数据量
        "data": [{//子节点数据
            "comment": 1537196, // 评论数
            "brand_id": "10063237", // 品牌id
            "city": "杭州", // 市
            "province": "浙江", // 省
            "market_share": 0.5481, // 市场份额
            "sold": 156543, // 销量
            "plat": "all", // 平台
            "avg_price": 40.22856256747346, // 宝贝均价
            "item_num": 830, // 宝贝数
            "category_name": "裤子", // 类目名称
            "sale": 6297499.869999998, // 销售额
            "shop_num": 56, // 店铺数
            "category_id": "1622" // 类目id
            "avg_price_ps": 40.23, // ps数据模型版本宝贝均价
            "sale_ps": 6297499.869999998, // ps数据模型版本销售额
            "sold_ps": 156543, // ps数据模型版本销量
            "avg_price_ps_cp": 40.23, // ps_cp数据模型版本宝贝均价
            "sale_ps_cp": 6297225.428269205, // ps_cp数据模型版本销售额
            "sold_ps_cp": 156543, // ps_cp数据模型版本销量
            "avg_price_ds3": 39.27, // ds3数据模型版本宝贝均价
            "sale_ds3": 6147410.349999999, // ds3数据模型版本销售额
            "sold_ds3": 156543, // ds3数据模型版本销量
            "avg_price_cp": 40.23, // cp数据模型版本宝贝均价
            "sale_cp": 6297225.428269205, // cp数据模型版本销售额
            "sold_cp": 156543, // cp数据模型版本销量
            "avg_price_ds3_ps_cp": 39.27, // ds3_ps_cp数据模型版本宝贝均价
            "sale_ds3_ps_cp": 6147135.476532932, // ds3_ps_cp数据模型版本销售额
            "sold_ds3_ps_cp": 156543, // ds3_ps_cp数据模型版本销量
            "avg_price_cp_tk": 40.16, // cp_tk数据模型版本宝贝均价
            "sale_cp_tk": 6286165.587926477, // cp_tk数据模型版本销售额
            "sold_cp_tk": 156543, // cp_tk数据模型版本销量
            "avg_price_ds3_ps": 39.27, // ds3_ps数据模型版本宝贝均价
            "sale_ds3_ps": 6147410.349999999, // ds3_ps数据模型版本销售额
            "sold_ds3_ps": 156543, // ds3_ps数据模型版本销量
            "avg_price_min": 36.02, // min数据模型版本宝贝均价
            "sale_min": 5639044.93, // min数据模型版本销售额
            "sold_min": 156543, // min数据模型版本销量
            "avg_price_ds3_cp": 39.27, // ds3_cp数据模型版本宝贝均价
            "sale_ds3_cp": 6147135.476532932, // ds3_cp数据模型版本销售额
            "sold_ds3_cp": 156543, // ds3_cp数据模型版本销量
        }, ...]
    }
}

// type=brand时，部分字段同上
{
    "status": "", //["ok", "error"]
    "result": {
        "count": 200, //总的数据量
        "data": [{//子节点数据
            "province": "浙江", //所在省份
            "market_share": "0.0097", // 市场份额
            "qoq": "-0.0325558235174", // 销售额环比
            "sold": "197311", // 销量
            "brand_name": "伊芙丽", // 品牌名称
            "plat": "all", // 平台
            "brand_id": "10194332", // 品牌id
            "avg_price": "317.298959207", // 宝贝均价
            "city": "杭州", //所在城市
            "last_month": "64713372.06", //上个月销售额
            "sale": "62606574.94", // 销售额
            "last_year": "73725929.59", //去年销售额
            "yoy": "-0.150820134949", // 销售额同比
            "category_id": "16", // 当前类目id
        }, ...]
    }
}


// type=city时，部分字段同上
{
    "status": "", //["ok", "error"]
    "result": {
        "count": 35, //总的数据量
        "data": [{//子节点数据
            "comment": "118270643", // 评论数
            "province": "浙江", // 省份
            "market_share": "0.6928", // 市场份额
            "sold": "49904349", // 销量
            "plat": "all", // 平台
            "brand_id": "all", // 品牌id
            "avg_price": "129.899787926", // 宝贝均价
            "city": "杭州", // 城市
            "sale": "6482564351.67", // 销售额
            "item_num": "1432658", // 宝贝数
            "shop_num": "43481", // 店铺数
            "category_id": "16", // 类目id
            "avg_price_ps": "129.96", // ps数据模型版本宝贝均价
            "sale_ps": "6487784696.32", // ps数据模型版本销售额
            "sold_ps": "49922201", // ps数据模型版本销量
            "avg_price_ds3_ps_cp": "148.52", // ds3_ps_cp数据模型版本宝贝均价
            "sale_ds3_ps_cp": "7414199686.63", // ds3_ps_cp数据模型版本销售额
            "sold_ds3_ps_cp": "49922201", // ds3_ps_cp数据模型版本销量
            "avg_price_cp": "129.04", // cp数据模型版本宝贝均价
            "sale_cp": "6442005262.9", // cp数据模型版本销售额
            "sold_cp": "49922201", // cp数据模型版本销量
            "avg_price_ds3": "149.44", // ds3数据模型版本宝贝均价
            "sale_ds3": "7460283229.91", // ds3数据模型版本销售额
            "sold_ds3": "49922201", // ds3数据模型版本销量
            "avg_price_ps_cp": "129.04", // ps_cp数据模型版本宝贝均价
            "sale_ps_cp": "6442005262.9", // ps_cp数据模型版本销售额
            "sold_ps_cp": "49922201", // ps_cp数据模型版本销量
            "avg_price_ds3_ps": "149.44", // ds3_ps数据模型版本宝贝均价
            "sale_ds3_ps": "7460283229.91", // ds3_ps数据模型版本销售额
            "sold_ds3_ps": "49922201", // ds3_ps数据模型版本销量
            "avg_price_min": "123.49", // min数据模型版本宝贝均价
            "sale_min": "6164858789.04", // min数据模型版本销售额
            "sold_min": "49922201", // min数据模型版本销量
            "avg_price_cp_tk": "128.77", // cp_tk数据模型版本宝贝均价
            "sale_cp_tk": "6428697624.85", // cp_tk数据模型版本销售额
            "sold_cp_tk": "49922201", // cp_tk数据模型版本销量
            "avg_price_ds3_cp": "148.52", // ds3_cp数据模型版本宝贝均价
            "sale_ds3_cp": "7414199686.63", // ds3_cp数据模型版本销售额
            "sold_ds3_cp": "49922201", // ds3_cp数据模型版本销量
        }, ...]
    }
}

RegionSiteHotShops

原生类目地域下热销店铺数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/hot_shops

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

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营,jdhk-京东全球购 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
province string Y 浙江 省份
city string Y 杭州 城市
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": [{//店铺数据
            "comment": "577220", //评论数
            "ww": "土屋_anna", //店铺旺旺
            "uid": "266969832", //店铺ID
            "shop_url": "https://store.taobao.com/shop/view_shop.htm?user_number_id=266969832", // 店铺url
            "platform": "all", //平台
            "item_num": "775", //宝贝数
            "price": "0", // 内部字段，对于用户无意义
            "sold": "321141", //销量
            "sale": "72466504.53", //销售额
            "shop_name": "ASM ANNA", //店铺名称
        }, ...]
    }
}

RegionSiteHotItems

原生类目地域下热销宝贝数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/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表示所有品牌)
province string Y 浙江 省份
city string Y 杭州 城市
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": [{//宝贝数据
            "comment": "0", //宝贝评论数
            "back_cid": "50007068", //宝贝所在的最深层类目
            "old_pro_price": "999.0", // 内部字段，对于用户无意义
            "price": "999.0", //原价
            "pic": "//img.alicdn.com/imgextra/i2/2208451024265/O1CN01PZ9Cs41hNPtxYhUcl_!!2-item_pic.png",
            "sale_index": "11958", // 内部字段，对于用户无意义
            "ww": "幸福のの小屋", //商品所属店铺旺旺
            "pro_price_old": "999.0", // 内部字段，对于用户无意义
            "shop_type": "cshop", // 内部字段，对于用户无意义
            "price_nofilter": "999.0", // 内部字段，对于用户无意义
            "sold": "8670", //商品销量
            "item_id": "645692153265", //宝贝id
            "price_raw": "999.0", // 内部字段，对于用户无意义
            "pro_price": "999.0", // 内部字段，对于用户无意义
            "uid": "2208451024265", //商品所属店铺id
            "loc": "浙江杭州", //宝贝所属地
            "is_global": false, // 内部字段，对于用户无意义
            "title": "【4周年宠粉节】 幸福的小屋 显瘦单款韩版小猫裤", //商品名
            "sale": "8661330.0", //商品销售额
            "shop_name": "小田全球精品一号店", //宝贝所属店铺名
            "is_tmgj": null, // 内部字段，对于用户无意义
            "min_price": "999.0", // 极限价格
            "reserve_price": "999.0", // 内部字段，对于用户无意义
            "brand": null, //宝贝所属品牌id
            "price_ps": "999.0", // ps数据模型版本宝贝价格
            "price_ds3_ps_cp": "999.0", // ds3_ps_cp数据模型版本宝贝价格
            "price_cp": "999.0", // cp数据模型版本宝贝价格
            "min_price_ds3": "999.0", // ds3数据模型版本宝贝价格
            "price_ds3": "999.0", // ds3数据模型版本宝贝价格
            "price_ds3_nofilter": "999.0", // ds3数据模型版本宝贝价格
            "price_ps_cp": "999.0", // ps_cp数据模型版本宝贝价格
            "price_ds3_ps": "999.0", // ds3_ps数据模型版本宝贝价格
            "price_min": "999.0", // min数据模型版本宝贝价格
            "price_cp_tk": "999.0", // cp_tk数据模型版本宝贝价格
            "price_ds3_cp": "999.0", // ds3_cp数据模型版本宝贝价格
        }, ...] 
    }
}

RegionSiteCompare

原生类目地域下销量销售额对比

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/province/<string:province>/city/<string:city>/cats/<string:cat_id>/brands/<string:brand_id>/compare

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

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营,jdhk-京东全球购 )
catid string Y 16 类目ID(0表示所有类目)
brandid string Y 29973 品牌ID(all表示所有品牌)
province string Y 浙江 省份
city string Y 杭州 城市
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(包括 dd-当当, gome-国美, jd-京东, sn-苏宁,wykl-网易考拉 )
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],...], //评论数趋势 [时间戳，评论数]列表，天猫平台没有此数据
    }
}

SearchBrandCat

搜索页品牌下类目数据

HTTP Request

GET https://market.moojing.com/api/brandcat/platform/<string:plat>/brand/<string:brandid>/cats

获取市场情报搜索页品牌下类目数据

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
brandid string Y 29973 品牌ID(all表示所有品牌)

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

{
    "status": "", //["ok", "error"]
    "result": [
        {
            "sale": 1852592.7383014075, // 销售额
            "name": "汽车用品/电子/清洗/改装", // 类目名称
            "cid": "26" // 类目id
        }
    ]
}

SitePriceRange

原生类目价格分布

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:cat_id>/brands/<string:brand_id>/price_range

获取市场情报原生类目下的价格分布

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y all 平台ID(包括all-淘宝+天猫，cshop-淘宝, tmall-天猫, dd-当当, gome-国美, jd-京东, sn-苏宁, chaoshi-天猫超市, nochaoshi-天猫非超市, jd_exclude_self-京东非自营, jd_only_self-京东自营,meituan-美团,global-淘宝全球购,tmallhk-天猫国际,pdd-拼多多,jdhk-京东全球购,wykl-网易考拉 )
catid string Y 16 类目ID(不能为0)
brandid string Y all 品牌ID(all表示所有品牌)
start string Y 2019-10 查看数据的月份
pricelist string Y 10,20,30 自定义价格区间点（不能与interval_size同时使用）
interval_size string Y 100 价格区间大小（不能与pricelist同时使用）
min_price string Y 100 最低成交价（不能与pricelist同时使用）
max_price string Y 100 最高成交价（不能与pricelist同时使用）
range_length string Y 5 价格段分段数（不能与pricelist同时使用）

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

{
    "status": "", //["ok", "error"]
    "result": {
        "price_range": [
            ["0~10", //价格区间
            1.09, // 商品数占比
            1351284, // 销量
            5541870.123746649 // 销售额
            ],
            ["10~20", 2.95, 1394322, 20390728.173036102],
        …]
    }
}

PlatTotalTrend

各平台总销售额趋势

HTTP Request

GET https://market.moojing.com/api/summary

获取市场情报各平台总销售额趋势

请求参数

参数名称 类型 是否必须 事例值 描述
type string Y month 趋势类型(month-按月趋势，quarter-按季度趋势，year-按年趋势)
start string Y 2017-07 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "tmall": [
            [
                1459440000000, // 时间戳
                101039136726 // 销售额
            ], 
            [1462032000000, 101868488017], [1464710400000, 126904668463],…
        ] // 平台
    }
}

SiteSpu

型号列表

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:cat_id>/brands/<string:brand_id>/spu

获取市场情报类目品牌下型号列表

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持tmall-天猫)
catid string Y 121390006 类目ID
brandid string Y 10031692 品牌ID
start string Y 2019-10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "count": 25, // 搜索总数
        "data":[
            {
                "spu_id": "1226059937", // 型号id
                "sold": 720047, // 销量
                "sale": 57531755.300000004, // 销售额
                "brand_id": "92684514", // 品牌id
                "shop_num": 1, // 店铺数
                "avg_price": 79.9, // 均价
                "item_num": 1, // 宝贝数
                "shortname": [], // 型号短标题
                "category_id": "121474010", // 类目id
                "spu_name": "小红针血橙面膜急救保湿收缩毛孔紧致舒缓滋润补水官方正品韩国" // 商品标题示例

            }
        ]
    }
}

Spu

型号数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/spu/<string:spu_id>

获取市场情报类目品牌下单个型号数据

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持tmall-天猫)
spuid string Y 1281231493 型号ID
start string Y 2019-10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "spu_id": "1281231493",
        "shortnames": [["UQ420697000", 1]], // 型号短标题
        "items": [
            {
                "back_cid": "50000671",
                "spu_id": "1281231493",
                "uid": "196993935",
                "title": "【设计师合作款】女装 半高领T恤(长袖) 420697 优衣库UNIQLO",
                "bid": "29527",
                "pic": "http://g.search2.alicdn.com/img/bao/uploaded/i4/i4/196993935/O1CN013Xl3tS1ewH59Bst01_!!0-item_pic.jpg_60x60.jpg",
                "sale": 4132253,
                "shop_name": "优衣库官方旗舰店",
                "ww": "优衣库官方旗舰店",
                "pname": "UQ420697000",
                "item_id": "598658188045",
                "pro_price": "79.0",
                "sold": 52307,
            }
        ], // 宝贝列表，具体参考SiteHotItems
        "sold": 52307, // 型号销量
        "sale": 4132253, // 型号销售额
        "brand_id": "29527", // 所属品牌id
        "shop_num": 1, // 型号下店铺数
        "avg_price": 79, // 型号均价
        "item_num": 1, // 型号下宝贝数
        "shops": [
            {
                "ww": "优衣库官方旗舰店",
                "sold": 52307,
                "shop_name": "优衣库官方旗舰店",
                "sale": 4132253,
                "uid": "196993935"
            }
        ],// 店铺列表，具体参考SiteHotShops
        "category_id": "50000671", // 型号所属类目id
        "spu_name": "【设计师合作款】女装 半高领T恤(长袖) 420697 优衣库UNIQLO", // 商品标题示例
        "shortname": ["UQ420697000", 1], // 型号短标题
        "names": {
            "bid": "优衣库/Uniqlo",
            "cid": [{"id": "16", "name": "女装/女士精品"}, {"id": "50000671", "name": "T恤"}],
            "spu_name": "【设计师合作款】女装 半高领T恤(长袖) 420697 优衣库UNIQLO",
            "cid_path": "女装/女士精品|T恤",
            "plat": "天猫",
        }, // 面包屑导航数据，包含当前型号所属类目和品牌信息
    }
}

AttrTable

型号分类

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:cat_id>/attrtable

获取市场情报类目类目下属性分类数据

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持all-淘宝+天猫，cshop-淘宝, tmall-天猫, chaoshi-天猫超市, nochaoshi-天猫非超市,global-淘宝全球购,tmallhk-天猫国际,jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营, jd_hk-京东全球购)
catid string Y 121390006 类目ID
start string Y 2019-10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "洗衣程序":[",混合洗,节能,羽绒洗,单脱水", ",单脱水 ,混合洗,羽绒服洗", ",混合洗,羽绒服洗 快洗 筒自洁", "快洗 标准洗", ",常用,浸泡洗,洗涤,脱水,漂洗 筒干燥",…] // 属性分类名称:属性列表
    }
}

SiteAttr

属性组合数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:cat_id>/attr_top

获取市场情报类目下属性组合

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持all-淘宝+天猫，cshop-淘宝, tmall-天猫, chaoshi-天猫超市, nochaoshi-天猫非超市,global-淘宝全球购,tmallhk-天猫国际,jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营, jd_hk-京东全球购)
catid string Y 121390006 类目ID
start string Y 2019-10 月份
type string Y couple 切换属性组合列表（couple）或单独属性分类下属性列表（single）
attr_name string N 颜色分类 属性分类（只有type为single时才生效）

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

{
    "status": "", //["ok", "error"]
    "result": {
        "count": 25, // 搜索总数
        "data":[
            {
                "attr":{
                    "洗衣程序": ",混合洗,节能,羽绒洗,单脱水"
                }, // 属性组合名称（属性分类:属性名）
                "qoq": "-", // 环比
                "sold": 25209, // 销量
                "sale": 75980291, // 销售额
                "sold_share": 0.0744,  //销量占比
                "shop_num": 48, // 店铺数
                "yoy": "-", // 同比
                "sale_share": 0.182, // 销售额占比
                "item_num": 209, // 宝贝数
                "attr_str": "洗衣程序+,混合洗,节能,羽绒洗,单脱水", // 属性组合
                "attr_value": ",混合洗,节能,羽绒洗,单脱水", // 属性名
            }
        ]
    }
}

Attr

属性数据

HTTP Request

GET https://market.moojing.com/api/platform/<string:plat>/cats/<string:cat_id>/attr_summary

获取市场情报类目品牌下属性数据

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持all-淘宝+天猫，cshop-淘宝, tmall-天猫, chaoshi-天猫超市, nochaoshi-天猫非超市,global-淘宝全球购,tmallhk-天猫国际,jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营, jd_hk-京东全球购)
catid string Y 121390006 类目ID
brandid string Y 10031692 品牌ID
attrs string Y {"颜色分类":"香槟金"} 要查看的属性组合（json形式，目前仅支持同时传递2个属性组合进行分析）
start string Y 2019-10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "cid": [,…], // 属性所属类目的面包屑导航所需数据
        "top_items": [{"uid": "470168984", "title": "Haier/海尔EG10014B39GU1 10公斤kg蓝晶变频滚筒家用洗衣机全自动", "sold": 9246,…}], // 属性下宝贝列表，具体参照 SiteHotItems
        "sold": 35677, // 属性销量
        "sale": 95218517, // 属性销售额
        "cid_path": "大家电|洗衣机", // 属性所属类目的面包屑导航所需数据
        "plat": "天猫", // 属性所属平台
        "attrname": "香槟金", // 属性名
        "shop_num": 120, // 属性下店铺数
        "item_num": 395, // 属性下宝贝数
    }
}

ShopSale

店铺销售趋势

HTTP Request

GET https://market.moojing.com/api/shop/sale/trend

获取市场情报类目品牌下店铺趋势

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持all-淘宝+天猫，cshop-淘宝, tmall-天猫, chaoshi-天猫超市, nochaoshi-天猫非超市,global-淘宝全球购,tmallhk-天猫国际,jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营, jd_hk-京东全球购)
uid string Y 470168984 店铺id
cat_id string Y 16 类目id
brand_id string Y all 品牌id
start string Y 2019_10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "trend": {
            "2018_2": [
                [
                    [
                        [
                            "0", // 店铺所属类目id
                            ""  //店铺所属类目名
                        ], 
                        [
                            "all",  // 店铺所属品牌id
                            "" // 店铺所属品牌名
                        ]
                    ], 
                    {
                        "item_num": 549, // 属于该类目品牌下的宝贝数
                        "sold": 159043, // 属于该类目品牌下的销量
                        "sale": 272735946.2 // 属于该类目品牌下的销售额
                    }
                ]
            ],
        },
        "uid": "470168984", // 店铺id
        "shop_name": "海尔官方旗舰店" // 店铺名
    }
}

ItemSale

宝贝销售趋势

HTTP Request

GET https://market.moojing.com/api/item/sale/trend

获取市场情报类目品牌下宝贝趋势

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持all-淘宝+天猫，cshop-淘宝, tmall-天猫, chaoshi-天猫超市, nochaoshi-天猫非超市,global-淘宝全球购,tmallhk-天猫国际,jd-京东, jd_exclude_self-京东非自营, jd_only_self-京东自营, jd_hk-京东全球购)
item_id string Y 594652555638 宝贝id
start string Y 2019_10 月份

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

{
    "status": "", //["ok", "error"]
    "result": {
        "trend": {
            "2019_10": {
                "comment": 18805, // 商品评价数
                "sold": 23993, // 商品销量
                "title": "Midea/美的 MB80ECO 8公斤kg波轮小型洗衣机 全自动家用大容量", // 商品标题
                "price": 999, // 商品价格
                "sale": 23969007, // 商品销售额
            }
        }
    }
}

ShopDetail

店铺详情接口

HTTP Request

https://market.moojing.com/api/shopdetail

获取市场情报类目品牌下店铺详情

请求参数

参数名称 类型 是否必须 事例值 描述
plat string Y tmall 平台ID(仅支持taobao-淘宝+天猫,jd-京东, gome-国美, suning-苏宁)
start string Y 2019-10 起始月份
end string N 2020-08 结束月份,与起始月份的差不能大于12个月
shopname string N 韩都衣舍旗舰店 店铺名称,shopname与id有且只有一个, 多个店铺名之间用英文逗号(,)分隔
id string N 0 shopname与id有且只有一个 多个店铺id之间用英文逗号(,)分隔

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

{
"status": "", //["ok", "error"]
"errors": [
    "店铺id:100052 不存在!",
    "店铺id:100000 不存在!"
    "店铺名:魅族旗舰店 不存在!",
],
"result": [{
        "isfirst": true,  // 是否第一次查询
        "comment": "9070380", //评论数
        "month": "2020-07",
        "start":"2013-06-13 09:58:23",//开店时间
        "shopname": "小米官方旗舰店",
        "uid":1714128138,//店铺id
        "order_id":"5f880e5ea27201176cb759d0@2020-02",//订单号
        "tses": [  // 该店铺本次查询的月份
            "2020-01",
            "2020-02",
            "2020-03",
            "2020-04",
            "2020-05",
            "2020-06",
            "2020-07",
            "2020-08"
        ],
        "datas":[{
            "cid2name": "电吹风", // 二级类目名称
            "leafcat": "350213", // 叶子类目id
            "leafcatsale": 4299529, // 叶子类目销售额
            "cid1name": "个人护理/保健/按摩器材", // 一级类目名称
            "leafcatsold": 36571, // 叶子类目销量
            "cid1": "50002768", // 二级类目id
            "cid2": "350213",  // 一级类目id
            "brand_sales": [
                [
                    "373112369",  // 品牌id
                    "MIJIA/米家",  // 品牌名称
                    4299529,  // 品牌销售额
                    36571 // 品牌销量
                ]
            ],
            "leafcatname": "电吹风" // 叶子类目名称
        }],        
        "loc":"广东 佛山",//店铺所在地
        "shipaddress":"广东 佛山", //发货地
        "serv": "xxx", //淘系服务态度
        "desc": "aaa", //淘系描述相符
        "post": "xxx", //淘系物流服务
    }
}]

价控

价控系统

ItemList

价控商品列表

HTTP Request

GET https://detact.moojing.com/api/items/list

获取价控商品信息

请求参数

参数名称 类型 是否必须 事例值 描述
order_by string N update_time 搜索商品名称
desc string N true true/false 排序是否倒序
group_id string N 05de6f74-2305-11eb-9cf3-52540052d882 按分组获取商品
q string N 茶具 搜索商品名称
page int N 1 页码数
page_size int N 10 每页记录数
itemid string N 553412729081 商品id,最多可以传10个,多个id使用英文逗号分隔
skuid string N 4244101828376 skuid,最多可以传10个,多个id使用英文逗号分隔
uid string N 174933900 旺旺id

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

{
    "status": "ok", //["ok", "error"]
    "result": {
        "count": 1, //查询结果总数
        "not_start": 0, //尚未开始监测的商品数
        "item_count": "10", //已添加的商品数
        "data": [{
            "username": "testuser",  // 用户名
            "sku_id": "4037342351264",  // skuid
            "monit_price": 12.0,  // 监控价格
            "uid": "2041700324",  // 旺旺id
            "coupon":  // 优惠卷
            [
              {
                "price": "28.00",  // 价格
                "period": "2021.12.12-2021.12.14",  // 优惠卷有效日期
                "content": "跨店每200减20",  // 优惠信息
                "startTime": "2021-12-12 00:00:00",  // 优惠卷开始时间
                "endTime": "2021-12-14 23:59:59",  // 优惠卷结束时间
                "type": "default",  // 内部字段，对于用户无意义
              },
            ],
            "group_name": "",  // 分组名称
            "weekly_error": "-",  // 7天内异常天数
            "shop_id": "109765959",  // 店铺id
            "pro_price": 33.0,  // 页面价
            "dis_price": 29.7,  // 折后价
            "coupon_valid":  // 生效优惠券
            [
              {
                "price": "28.00",  // 价格
                "period": "2021.12.12-2021.12.14",  // 优惠卷有效日期
                "content": "跨店每200减20",  // 优惠信息
                "startTime": "2021-12-12 00:00:00",  // 优惠卷开始时间
                "endTime": "2021-12-14 23:59:59",  // 优惠卷结束时间
                "type": "default",  // 内部字段，对于用户无意义
              },
            ],
            "dis_info": "33.0 - 3.300000(跨店每200减20) = 29.7", //减去优惠券得到最终价格的计算过程
            "propPath": "1627207:3232482",  // 内部字段，对于用户无意义
            "title": "景德镇茶杯陶瓷带盖 青瓷瓷器家用小水杯办公室单杯个人杯子茶具",  // 宝贝标题
            "shop_name": "洁升旗舰店",  // 店铺名称
            "platform": "tmall",  //cshop-淘宝，tmall-天猫，jd-京东
            "first_image": "//img.alicdn.com/imgextra/i3/2041700324/O1CN01ulgrdv1EGQnjkLoaV_!!2041700324.jpg",  // 商品首图
            "cat_path": ["122952001", "122996002", "50006119"],  // 类目路径
            "pathname": "餐饮具-&gt;杯子/水杯/水壶-&gt;马克杯",  // 类目名称
            "stock": 36,  // 库存状态
            "status": 0,  //状态 0-正常 4004-已下架
            "skuId": "4037342351264",  // skuid
            "update_time": "2021-12-13 18:02:51",  // 更新时间
            "sku_name": "莲蓬荷花（内置茶隔）",  // sku名称
            "price": 119.6,  // 内部字段，对于用户无意义
            "priceText": "35",  // 内部字段，对于用户无意义
            "shop_coupon": [],  // 店铺优惠卷
            "plat": "taobao",  // 商品平台
            "sub_priceText": "35",  // 内部字段，对于用户无意义
            "discount": 0.09999999999999998,  // 折扣率
            "sku_image": "https://gw.alicdn.com/bao/uploaded/i2/2041700324/O1CN011EGQnKHD6Ub2dBL_!!2041700324.jpg",  // sku图片
            "item_id": "570133817662",  // 商品id
            "sub_price": "35.00",  // 内部字段，对于用户无意义
            "backcid": "50006119",  // 叶子类目id
            "url": "https://detail.tmall.com/item.htm?id=570133817662",  // 商品链接
            "interval": 1.0,  // 监控间隔
            "orig_price": "140.00",  // 划线价
            "limit": "",  // 内部字段，对于用户无意义
            "group_id": null,  // 分组id
            "monthly_error": 3,  //30天内异常天数
            }

    ]
    }
}

ItemADD

添加监控商品

HTTP Request

POST https://detact.moojing.com/api/items/add

添加监控商品

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
url string Y https://item.taobao.com/item.htm?id=19162819866 商品url
price string Y 10 价格下限
interval int Y 12 检测间隔
group_id string N 0774afc2-14e3-11eb-b711-52540052d882 分组id

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

{
  "status": "ok",
  "result": {
    "item_id": "123456789"
  }
}

ItemADDMany

批量添加监控商品

HTTP Request

POST https://detact.moojing.com/api/items/add_many

批量添加监控商品

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
overlimit string N delete overlimit=delete:添加商品超过限制时按已添加商品的最后添加时间排序删除最早添加的商品;否则超限商品添加失败
use_db_cache bool N True 是否使用数据库缓存,False会立即抓取不管数据库中是否存在，否则读取数据库已有商品数据
override bool N True 是否覆盖已有商品
items list Y [{"url": "https://item.taobao.com/item.htm?id=19162819866", "interval": 12, "price": 10, "group_name": "test_group"}] 商品信息，格式如下

items

参数名称 类型 是否必须 事例值 描述
url string Y https://item.taobao.com/item.htm?id=19162819866 商品url
price string Y 10 价格下限
interval int Y 12 检测间隔
group_name string N test_group 分组名称

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

{
    "status": "ok",
    "result": {
        "status": "ok",
        "skip_item_count": 0,  // 已存在且不覆盖商品数
        "good": 2,  // 成功添加商品数=新添加商品数+已存在且覆盖商品数+已存在且不覆盖商品数
        "new_item_count": 2,  // 新添加商品数
        "updated_item_count": 0,  // 已存在且覆盖商品数
        "taskid": "127c2abb-48d0-40ea-9092-144590afdfd9",  // 任务id
        "fail": [  // 失败信息
            {
                "status": "parse_error",
                "msg": "数据解析失败",
                "row": 3
            }
        ]  
    }
}

ItemTaskList

批量添加监控商品任务列表

HTTP Request

GET https://detact.moojing.com/api/items/task_list

批量添加监控商品

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
desc bool N true 是否逆序排序
page int N 1 页码数
page_size int N 10 每页记录数

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

{
    "status": "ok",
    "result": {
        "data": {
            "count": 2,
            "data": [
                {
                    "created_at": "2022-11-25 12:00:00",  // 任务创建时间
                    "taskid": "127c2abb-48d0-40ea-9092-144590afdfd9"  // 任务id
                },
                {
                    "created_at": "2022-11-25 13:00:00",
                    "taskid": "29fc8d39-6314-4971-a52c-e705c38d8bd4"
                }
            ]
        }
    }
}

ItemTask

批量添加监控商品任务详情

HTTP Request

GET https://detact.moojing.com/api/items/task

批量添加监控商品

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
taskid str Y 127c2abb-48d0-40ea-9092-144590afdfd9 任务id

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

{
    "status": "ok",
    "result": {
        "data": {
            "failed": [  // 失败信息
                {
                    "msg": "数据解析失败",  // 失败原因
                    "row": 3  
                }
            ],
            "created_at": "2022-11-25 12:00:00",
            "succeed": [
                {
                    "item_id": "677013205734",
                    "msg": "ok"
                },
                {
                    "item_id": "630287218492",
                    "msg": "ok"
                }
            ],
            "waiting": [],  // 暂未更新商品
            "taskid": "127c2abb-48d0-40ea-9092-144590afdfd9"
        }
    }
}

ItemRemove

批量删除监控商品

HTTP Request

POST https://detact.moojing.com/api/items/remove

批量删除监控商品

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
skus string N "{\"19162819866\":[\"4205130491327\",\"4205130491320\"]}" json格式字符串，"{'item_id': ['sku_id1', 'sku_id2', ...], ...}}"
items string N '["705078594580","705078594580","3603119922949050302"]' json格式字符串，内容为商品ID的列表

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

{
  "status": "ok",
  "result": {}
}

ShopInfo

查询店铺信息

HTTP Request

POST https://detact.moojing.com/api/shops/info

异步查询店铺信息，返回taskid。使用taskid在ShopResult接口获取店铺信息。

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
shop_names list N ["SK-II官方旗舰店"] 监控的店铺名
uids list N ["917264765"， "123456"] 监控的店铺uid
urls list N ["https://skii.tmall.com/shop/view_shop.htm "] 监控的店铺链接

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

{
    "status": "ok",
    "result": {
        "taskid": "371d9e59-de39-4ae1-81b0-c48d0cd0c575"
    }
}

ShopAdd

添加监控店铺

HTTP Request

POST https://detact.moojing.com/api/shops/add

异步添加监控店铺，返回taskid。使用taskid在ShopResult接口获取店铺信息。

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
shop_names list N ["SK-II官方旗舰店"] 监控的店铺名
uids list N ["917264765"， "123456"] 监控的店铺uid
urls list N ["https://skii.tmall.com/shop/view_shop.htm "] 监控的店铺链接
interval int N 12 监控间隔
plat str N douyin,taobao,默认值:taobao 平台
fetch_type str N list表示只抓取列表,不传或者其他表示抓取详情 指定店铺抓取类型

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

{
    "status": "ok",
    "result": {
        "taskid": "371d9e59-de39-4ae1-81b0-c48d0cd0c575"
    }
}

ShopResult

添加监控店铺

HTTP Request

GET https://detact.moojing.com/api/shops/result

查看ShopInfo与ShopAdd提交的店铺信息

请求参数

参数名称 类型 是否必须 事例值 描述
taskid string Y 11778530-9817-46f9-a702-cf78e37a08e4 任务id

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

{
    "status": "ok",
    "result": {
        "fail": {
            "123456": "no_items_found"  // 添加失败原因
        },
        "shop_info": [
            {
                "shop_type": "tmall",
                "sid": "72571314",
                "uid": "917264765",
                "shop_name": "SK-II官方旗舰店"
            }
        ],
        "good": 1
    }
}

ItemPriceTrend

商品价格趋势

HTTP Request

GET https://detact.moojing.com/api/items/price/trend

获取商品价格趋势

请求参数

参数名称 类型 是否必须 事例值 描述
item_id string Y 568051577100 商品 id
sku_id string Y 3812996054353 sku id
plat string Y taobao 商品平台，taobao/jd

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

{
    "status": "ok",
    "result": {
        "data": {
            "coupon": [], 
            "info": { // 商品信息，与商品列表格式相同
                "username": "testuser",
                "sku_id": "3812996054353",
                "monit_price": 9,
                "coupon": [],
                "pro_price": 27.9,
                "dis_price": 27.9,
                "propPath": "1627207:1050840782",
                "title": "塑料茶杯男女士随手运动壶大容量便携茶水分离杯子过滤网带盖水杯",
                "stock": 0,
                "status": 0,
                "skuId": "3812996054353",
                "update_time": "2021-07-08 08:00:03",
                "priceText": "27.9",
                "price": 27.9,
                "sku_name": "白色650ML",
                "shop_coupon": [],
                "plat": "taobao",
                "sub_priceText": "27.9",
                "discount": 0,
                "sku_image": "//img.alicdn.com/imgextra/i2/744026428/TB2S8mFe_qWBKNjSZFxXXcpLpXa_!!744026428.jpg",
                "item_id": "568051577100",
                "sub_price": "27.90",
                "group_id": null,
                "url": "https://item.taobao.com/item.htm?id=568051577100&scm=1007.34127.227518.0&pvid=bfcfdd02-222b-4175-bdd8-007f3b4f71a2",
                "interval": 4,
                "limit": ""
            },
            "pro_price": [  //页面价
                [
                    1624291240000,  //时间戳
                    27.9 //页面价
                ], ...
            ],
            "dis_price": [ //折后价
                [
                    1624291240000,  //时间戳
                    27.9 //折后价
                ], ...            
            ],
            "price": [ //划线价
                [
                    1624291240000,  //时间戳
                    27.9 //划线价
                ], ...            
            ]
        }
    }
}

ItemGroup

商品加入分组

HTTP Request

POST https://detact.moojing.com/api/items/group

将商品批量添加到分组

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
skus string Y "{\"19162819866\":[\"4205130491327\",\"4205130491320\"]}" json格式字符串，"{'item_id': ['sku_id1', 'sku_id2', ...], ...}}"
group_id string Y 0774afc2-14e3-11eb-b711-52540052d882 分组id

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

{
    "status": "ok",
    "result": {}
}

GetUserGroup

获取用户分组

HTTP Request

GET https://detact.moojing.com/api/user/group

获取用户分组

请求参数

无参数

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

{
    "status": "ok",
    "result": [
        {
            "username": "testuser",
            "_id": "0774afc2-14e3-11eb-b711-52540052d882", //分组id
            "group_name": "test_group" //分组名称
        }, ...
    ]
}

PostUserGroup

添加用户分组

HTTP Request

POST https://detact.moojing.com/api/user/group

添加用户分组

post请求格式为 application/json

请求参数

参数名称 类型 是否必须 事例值 描述
group_name string Y new_group 分组名称

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

{
    "status": "ok",
    "result": {
        "data": [{
            "_id": "ef97aaf0-dfa1-11eb-be56-52540052d882",  // 分组id
            "group_name": "new_group" //分组名称
        }]
    }
}

DeleteUserGroup

删除用户分组

HTTP Request

DELETE https://detact.moojing.com/api/user/group

删除用户分组

请求参数

参数名称 类型 是否必须 事例值 描述
group_id string Y ef97aaf0-dfa1-11eb-be56-52540052d882 分组id

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

{
    "status": "ok",
    "result": {}
}

TaskTrend

价格监测任务趋势

HTTP Request

GET https://detact.moojing.com/api/task/trend

价格监测任务趋势

请求参数

无参数

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

{
    "status": "ok",
    "result": {
        "data": {
            "success": [ //成功记录
                [
                    1599667200000, //时间戳
                    150 //成功数
                ], ...
            ],
            "error": [ //失败记录
                [
                    1599667200000, //时间戳
                    0 //失败数
                ], ...
            ]
        }
    }
}

TaskList

任务日志

HTTP Request

GET https://detact.moojing.com/api/task/list

获取任务日志

请求参数

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

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

{
    "status": "ok",
    "result": {
        "count": 617, //总的数据量
        "data": [{
            "status": 0, //任务状态 0-正常 4004-已下架
            "title": "物生物正品耐热玻璃杯加厚过滤式透明花茶杯居家办公水杯子蘑菇杯", //宝贝标题
            "start_time": "2021-07-08 12:03:02", //执行时间
            "pic": "//img.alicdn.com/imgextra/i3/64229432/O1CN01BbvDNj2JXuGfN39fL_!!64229432.jpg", //图片url
            "plat": "taobao", //平台
            "end_time": "2021-07-08 12:07:32", //任务结束时间
            "item_id": "19162819866", //商品id
            "message": "" //错误信息
        }, ...]
    }
}

Errors

魔镜API错误代码: 如果调用api出错了，返回值将是如下所示的json格式的字符串

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