百度信息流推广API

    意图词包接口

    意图词包对象

    查询意图词包接口会返回意图词包信息,添加或者更新意图词包需要填写意图词包信息,包含如下字段:

    字段名称 类型 描述
    wtpId number 意图词包id
    wtpName string 意图词包名称
    keywords string 意图词
    estimate number 预估覆盖率,范围为:0-100
    hot number 覆盖度
    wordCount number 意图词个数

    查询推荐意图词包

    接口描述

    查询推荐意图词包。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getRecmWordPackagesFeed

    请求参数说明

    字段名称 类型 描述
    query string 需要查询词包的关键词
    planid number 计划id
    unitid number 单元id

    响应参数说明

    响应数据为推荐意图词包的数组。推荐意图词包结构如下:

    字段名称 类型 描述
    packageName string 词包名称
    keyWords string 词包内容
    estimate number 预估人群覆盖率,数据为百分比值体现
    hot number 覆盖度

    请求示例

    POST /v1/feed/cloud/SearchFeedService/getRecmWordPackagesFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
    		"query":"麦凯瑞大学",
    		"planid":96279345
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
    				"packageName":"大学",
    				"keyWords":[""浙江大学大学自考","中国大学自考"],
    				"estimate":0.2186847271261184,
    				"expmask":256,
                    "hot":2000
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    获取意图词包

    接口描述

    查询意图词包。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/getWtpFeed

    请求参数说明

    字段名称 类型 描述
    wtpIds array(number) 查询意图词包id集合; 必填,最多200个

    wtpIds传[]时,可以查询当前账户下所有意图词包。

    响应参数说明

    响应内容为意图词包数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/WtpFeedService/getWtpFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
        	"wtpIds": [12345]
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
    				"wtpId":77120141613,
    				"wtpName":"品牌手游",
    				"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
    				"estimate":0.2550926296986312,
                    "hot":5688,
                    "wordCount":3
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    添加意图词包

    接口描述

    添加意图词包(可批量)。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/addWtpFeed

    请求参数说明

    字段名称 类型 描述
    wtpFeedTypes array(object) 新增的意图词包数组,最多200个

    请求参数限制

    字段名称 类型 描述
    wtpId 意图词包id 无效
    wtpName 意图词包名称 必填
    keywords 意图词 必填
    estimate 预估覆盖率 无效

    响应参数说明

    响应为意图词包数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/WtpFeedService/addWtpFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
        	"wtpFeedTypes": [
    			{
    				"wtpName":"品牌手游",
    				"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
                }
    		]
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
    				"wtpId":77120141613,
    				"wtpName":"品牌手游",
    				"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
    				"estimate":0.2550926296986312,
                    "hot":5688,
                    "wordCount":3
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    更新意图词包

    接口描述

    更新意图词包(可批量)。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/updateWtpFeed

    请求参数说明

    字段名称 类型 描述
    wtpFeedTypes array(object) 更新的意图词包数组,最多200个

    更新WtpFeedType的参数限制如下

    字段名称 类型 描述
    wtpId 意图词包id 必填
    wtpName 意图词包名称 选填
    keywords 意图词 选填
    estimate 预估覆盖率 无效
    hot 覆盖度 无效
    wordCount 意图词个数 无效

    响应参数说明

    响应为意图词包数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/WtpFeedService/updateWtpFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
        	"wtpFeedTypes": [
    			{
    				"wtpId":77120141613,
    				"wtpName":"品牌手游+1",
    				"keywords":"我的宠物 修改版+1,巴啦啦魔法变身2+1,红警2共和国崛起+1"
                }
    		]
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
    				"wtpId":77120141613,
    				"wtpName":"品牌手游+1",
    				"keywords":"我的宠物 修改版+1,巴啦啦魔法变身2+1,红警2共和国崛起+1",
                    "hot":5200,
                    "wordCount":3
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    删除意图词包

    请求描述

    删除指定的意图词包(可批量)

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/deleteWtpFeed

    请求参数说明

    字段名称 类型 描述
    wtpIds array(number) 意图词包id数组,最多200个

    响应参数说明

    字段名称 类型 描述
    wtpFeedTypes array(object) 删除成功的意图词包数组,仅包含意图词包ID字段

    请求示例

    POST /v1/feed/cloud/WtpFeedService/deleteWtpFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
        	"wtpIds": [77120141613]
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
    				"wtpId":77120141613
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    查询意图标签过滤条件

    接口描述

    查询意图标签过滤条件,用于查询意图标签接口的参数。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getIntentTagFilterFeed

    请求参数说明

    响应参数说明

    响应为树形结构,分为行业、行为、品类三个级别。请参考如下描述和示例。

    字段名称 类型 描述
    level string 级别,第一级为"industry"表示行业,第二级为"behavior"表示行为,第三级为"category"表示品类
    conditions array(string) 可选条件的列表。
    filters array(object) 下级节点列表。

    请求示例

    POST /v1/feed/cloud/SearchFeedService/getIntentTagFilterFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
    	}
    }

    响应示例

    {
      "body": {
        "data": [
        	{
    			"level": "industry",
    			"conditions": [
    				"游戏"
    			],
    			"filters": [
    				{
    					"level": "behavior",
    					"conditions": [
    						"想玩",
    						...
    					],
    					"filters": [
    						{
    							"level": "category",
    							"conditions": [
    								"手机游戏",
    								...
    							]
    						},
    						...
    					]
    				},
    				...
    			]
    		},
            ...
        ]
      },
      "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
      }
    }

    查询意图标签

    接口描述

    查询意图标签,用于意图标签定向设置。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getIntentTagFeed

    请求参数说明

    请求字段中行业、行为、类目条件的可选值请使用查询意图标签过滤条件接口获取。

    字段名称 类型 描述
    industry string 行业条件。必填。
    behavior string 行为条件。必填。
    category string 类目条件。必填。
    query string 意图标签关键词。即模糊查询包含该关键词的意图标签。该字段为可选字段。

    响应参数说明

    响应为意图标签数组。

    字段名称 类型 描述
    industry string 行业。
    name string 意图标签名称。

    请求示例

    POST /v1/feed/cloud/SearchFeedService/getIntentTagFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
    	    "industry":"游戏",
    	    "behavior":"想玩",
    	    "category":"手机游戏",
    	    "query":"射击",
    	}
    }

    响应示例

    {
      "body": {
        "data": [
        	{
        	    "industry": "游戏",
        	    "name": "想玩射击游戏"
        	}
        ]
      },
      "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
      }
    }
    上一篇
    人群包接口
    下一篇
    查询APP偏好定向所需的APPID