/basicOpen/multiplatform/ads/reportSearchTrendsList{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/ads/reportSearchTrendsList"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/reportSearchTrendsList?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"reportDate\": \"2024-11-01\",\n \"pageSize\": 20,\n \"pageNum\": 1,\n \"orderType\": \"DESC\",\n \"itemBrand\": \"value\",\n \"itemQueryType\": 1,\n \"itemQueryField\": 1,\n \"searchKeywordType\": 1,\n \"orderField\": \"keywordRank\",\n \"searchKeyword\": \"value\",\n \"itemQueryValue\": \"value\",\n \"itemBrandType\": 1\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
"response_time": "2024-11-12 16:00:00",
"data": {
"list": [],
"total": 100
},
"total": 1
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | reportDate | 报告日期 | string | — | 可选 | 报告日期,必填,格式:yyyy-MM-dd |
| 2 | pageSize | 每页大小 | integer | — | 可选 | 每页大小,必填,不能大于100 |
| 3 | pageNum | 页码 | integer | — | 可选 | 页码,必填 |
| 4 | orderType | 排序方向 | string | — | 可选 | 排序方向,枚举值:ASC-升序, DESC-降序 |
| 5 | itemBrand | itemBrand | object | — | 可选 | 商品品牌(在item_brand_1/2/3中搜索),模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 6 | itemQueryType | 字段类型 | integer | — | 可选 | 字段类型,枚举值:0-模糊搜索, 1-精确搜索 |
| 7 | itemQueryField | 查询字段 | integer | — | 可选 | 查询字段,枚举值:0-itemId, 1-itemName |
| 8 | searchKeywordType | 搜索关键词类型 | integer | — | 可选 | 搜索关键词类型,枚举值:0-模糊搜索, 1-精确搜索 |
| 9 | orderField | 排序字段(驼峰格式) | string | — | 可选 | 排序字段(驼峰格式),枚举值:searchKeyword-搜索关键词, keywordRank-关键词排名, totalPctClickShare-前3商品点击占比总和, totalPctConvShare-前3商品转化占比总和 |
| 10 | searchKeyword | 搜索关键词 | object | — | 可选 | 搜索关键词,模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 11 | itemQueryValue | 文本框中的值 | object | — | 可选 | 文本框中的值,模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 12 | itemBrandType | 商品品牌类型 | integer | — | 可选 | 商品品牌类型,枚举值:0-模糊搜索, 1-精确搜索 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 响应码 | integer | — | 必填 | 响应码 |
| 2 | data | 返回数据 | object | — | 必填 | 返回数据 |
| 2.1 | list | 列表数据 | array<object> | — | 必填 | 列表数据 |
| 2.1.1 | itemBrand1 | 销量排名第1的商品品牌名 | string | Brand A | 必填 | 销量排名第1的商品品牌名 |
| 2.1.2 | itemBrand2 | 销量排名第2的商品品牌名 | string | Brand B | 必填 | 销量排名第2的商品品牌名 |
| 2.1.3 | itemBrand3 | 销量排名第3的商品品牌名 | string | Brand C | 必填 | 销量排名第3的商品品牌名 |
| 2.1.4 | itemId1 | 销量排名第1的商品ID | string | 12345678 | 必填 | 销量排名第1的商品ID |
| 2.1.5 | itemId2 | 销量排名第2的商品ID | string | 23456789 | 必填 | 销量排名第2的商品ID |
| 2.1.6 | itemId3 | 销量排名第3的商品ID | string | 34567890 | 必填 | 销量排名第3的商品ID |
| 2.1.7 | itemName1 | 销量排名第1的商品名称 | string | Wireless Gaming Mouse | 必填 | 销量排名第1的商品名称 |
| 2.1.8 | itemName2 | 销量排名第2的商品名称 | string | Bluetooth Mouse | 必填 | 销量排名第2的商品名称 |
| 2.1.9 | itemName3 | 销量排名第3的商品名称 | string | Optical Mouse | 必填 | 销量排名第3的商品名称 |
| 2.1.10 | keywordRank | 关键词排名 | string | 5 | 必填 | 关键词排名,0表示该日期无数据 |
| 2.1.11 | localizeKeyword | 关键词译文 | string | 无线鼠标 | 必填 | 关键词译文 |
| 2.1.12 | pctClickShareItem1 | 第1商品的点击占比 | string | 0.45 | 必填 | 第1商品的点击占比 |
| 2.1.13 | pctClickShareItem2 | 第2商品的点击占比 | string | 0.25 | 必填 | 第2商品的点击占比 |
| 2.1.14 | pctClickShareItem3 | 第3商品的点击占比 | string | 0.15 | 必填 | 第3商品的点击占比 |
| 2.1.15 | pctConvShareItem1 | 第1商品的转化占比 | string | 0.5 | 必填 | 第1商品的转化占比 |
| 2.1.16 | pctConvShareItem2 | 第2商品的转化占比 | string | 0.23 | 必填 | 第2商品的转化占比 |
| 2.1.17 | pctConvShareItem3 | 第3商品的转化占比 | string | 0.12 | 必填 | 第3商品的转化占比 |
| 2.1.18 | reportDate | 报告日期 | string | 2024-11-01 | 必填 | 报告日期,格式:yyyy-MM-dd |
| 2.1.19 | searchKeyword | 搜索关键词 | string | wireless mouse | 必填 | 搜索关键词 |
| 2.1.20 | totalPctClickShare | 前3商品点击占比总和 | string | 0.85 | 必填 | 前3商品点击占比总和 |
| 2.1.21 | totalPctConvShare | 前3商品转化占比总和 | string | 0.85 | 必填 | 前3商品转化占比总和 |
| 2.1.22 | trendData | 最近7天的趋势数据 | array<object> | — | 必填 | 最近7天的趋势数据,按日期顺序,包含日期和排名信息 |
| 2.1.22.1 | keywordRank | 关键词排名 | string | 5 | 必填 | 关键词排名,0表示该日期无数据 |
| 2.1.22.2 | reportDate | 报告日期 | string | 2024-11-01 | 必填 | 报告日期,格式:yyyy-MM-dd |
| 2.2 | total | 总记录数 | string | 100 | 必填 | 总记录数 |
| 3 | error_details | 错误详情 | array<any> | — | 必填 | 错误详情 |
| 4 | message | 提示信息 | string | — | 必填 | 提示信息 |
| 5 | request_id | 请求id | string | — | 必填 | 请求id |
| 6 | response_time | 响应时间 | string | — | 必填 | 响应时间 |
| 7 | total | 总记录数 | integer | — | 必填 | 总记录数 |
领星ERP的接口:查询沃尔玛 - 词 - 沃尔玛热门搜索词(/basicOpen/multiplatform/ads/reportSearchTrendsList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。