搜狗首页  |   服务首页  |   客服热线:010-56898080

关键词推荐服务  |  关键词推荐服务(Restful)

getKRFileStatus

查询关键词推荐结果文件是否生成。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/keywordrecommend/getKRFileStatus

请求参数体:

{
    "body": {//
        "krFileId": ""//
    },
    "header": {
        "adType": 1,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "xxxxxx",
        "token": "xxxxxx",
        "username": "xxxxxx"
    }
}
									   

响应结果:

{
    "data": {//
        "isGenerated": 0//
    },
    "desc": "success",
    "failures": [],
    "oprs": 1,
    "oprtime": 1,
    "quota": 1,
    "rquota": 100,
    "status": 0
}
									   

getKRFilePath

获取关键词推荐结果文件的下载路径

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/keywordrecommend/getKRFilePath

请求参数体:

{
    "body": {//
        "krFileId": ""//
    },
    "header": {
        "adType": 1,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "xxxxxx",
        "token": "xxxxxx",
        "username": "xxxxxx"
    }
}
									   

响应结果:

{
    "data": {//
        "krFilePath": ""//
    },
    "desc": "success",
    "failures": [],
    "oprs": 1,
    "oprtime": 1,
    "quota": 1,
    "rquota": 100,
    "status": 0
}
									   

getKRFileId

KR Service 即关键词推荐服务,通过调用该服务,可以输入一个查询词,得到搜狗返回给您的推荐结果词。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/keywordrecommend/getKRFileId

请求参数体:

{
    "body": {//
        "seedWords": [],//
        "filterType": {//
            "exclusiveWords": [],//
            "inclusiveWords": [],//
            "flags": [],//
            "regionExtend": true,//
            "pv": 0,//
            "competition": 0,//
            "maxNum": 0,//
            "deviceType": 0//
        }
    },
    "header": {
        "adType": 1,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "xxxxxx",
        "token": "xxxxxx",
        "username": "xxxxxx"
    }
}
									   

响应结果:

{
    "data": {//
        "krFileId": ""//
    },
    "desc": "success",
    "failures": [],
    "oprs": 1,
    "oprtime": 1,
    "quota": 1,
    "rquota": 100,
    "status": 0
}
									   

getKRCustom

量身推荐接口:根据用户的账户和业务内容,返回对应的为用户量身定制的推荐词(以下简称为量身推荐词)。 对于userid,计划id,组id这三个层级的id,每个层级的id都有自己专属的量身推荐词。。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/keywordrecommend/getKRCustom

请求参数体:

{
    "body": {//
        "id": 0,//
        "type": 0,//
        "filterType": {//
            "exclusiveWords": [],//
            "inclusiveWords": [],//
            "flags": [],//
            "regionExtend": true,//
            "pv": 0,//
            "competition": 0,//
            "maxNum": 0,//
            "deviceType": 0//
        }
    },
    "header": {
        "adType": 1,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "xxxxxx",
        "token": "xxxxxx",
        "username": "xxxxxx"
    }
}
									   

响应结果:

{
    "data": [//
        {
            "word": "",//
            "broadPV": 0,//
            "competition": 0,//
            "flags": [],//
            "cpcPlanName": "",//
            "cpcGrpName": ""//
        }
    ],
    "desc": "success",
    "failures": [],
    "oprs": 1,
    "oprtime": 1,
    "quota": 1,
    "rquota": 100,
    "status": 0
}
									   

getKRBySeedWords

获取从指定时间到当前时间段内有变化的物料 ( 关键词、创意 )id 。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/keywordrecommend/getKRBySeedWords

请求参数体:

{
     "body": {//
        "seedWords": [],//
        "filterType": {//
            "exclusiveWords": [],//
            "inclusiveWords": [],//
            "flags": [],//
            "regionExtend": true,//
            "pv": 0,//
            "competition": 0,//
            "maxNum": 0,//
            "deviceType": 0//
        }
    },
    "header": {
        "adType": 1,
        "agentpassword": "",
        "agentusername": "",
        "apiusertype": "",
        "password": "xxxxxx",
        "token": "xxxxxx",
        "username": "xxxxxx"
    }
}
									   

响应结果:

{
    "data": [//
        {
            "seedWord": "",//
            "krResultTypes": [//
                {
                    "word": "",//
                    "broadPV": 0,//
                    "competition": 0,//
                    "flags": [],//
                    "cpcPlanName": "",//
                    "cpcGrpName": ""//
                }
            ]
        }
    ],
    "desc": "success",
    "failures": [],
    "oprs": 1,
    "oprtime": 1,
    "quota": 1,
    "rquota": 100,
    "status": 0
}