/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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | reportDate | 报告日期 | string | — | Optional | 报告日期,必填,格式:yyyy-MM-dd |
| 2 | pageSize | 每页大小 | integer | — | Optional | 每页大小,必填,不能大于100 |
| 3 | pageNum | 页码 | integer | — | Optional | 页码,必填 |
| 4 | orderType | 排序方向 | string | — | Optional | 排序方向,枚举值:ASC-升序, DESC-降序 |
| 5 | itemBrand | itemBrand | object | — | Optional | 商品品牌(在item_brand_1/2/3中搜索),模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 6 | itemQueryType | 字段类型 | integer | — | Optional | 字段类型,枚举值:0-模糊搜索, 1-精确搜索 |
| 7 | itemQueryField | 查询字段 | integer | — | Optional | 查询字段,枚举值:0-itemId, 1-itemName |
| 8 | searchKeywordType | 搜索关键词类型 | integer | — | Optional | 搜索关键词类型,枚举值:0-模糊搜索, 1-精确搜索 |
| 9 | orderField | 排序字段(驼峰格式) | string | — | Optional | 排序字段(驼峰格式),枚举值:searchKeyword-搜索关键词, keywordRank-关键词排名, totalPctClickShare-前3商品点击占比总和, totalPctConvShare-前3商品转化占比总和 |
| 10 | searchKeyword | 搜索关键词 | object | — | Optional | 搜索关键词,模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 11 | itemQueryValue | 文本框中的值 | object | — | Optional | 文本框中的值,模糊搜索请使用String类型,精确搜索请使用数组类型 |
| 12 | itemBrandType | 商品品牌类型 | integer | — | Optional | 商品品牌类型,枚举值:0-模糊搜索, 1-精确搜索 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 响应码 | integer | — | Required | 响应码 |
| 2 | data | 返回数据 | object | — | Required | 返回数据 |
| 2.1 | list | 列表数据 | array<object> | — | Required | 列表数据 |
| 2.1.1 | itemBrand1 | 销量排名第1的商品品牌名 | string | Brand A | Required | 销量排名第1的商品品牌名 |
| 2.1.2 | itemBrand2 | 销量排名第2的商品品牌名 | string | Brand B | Required | 销量排名第2的商品品牌名 |
| 2.1.3 | itemBrand3 | 销量排名第3的商品品牌名 | string | Brand C | Required | 销量排名第3的商品品牌名 |
| 2.1.4 | itemId1 | 销量排名第1的商品ID | string | 12345678 | Required | 销量排名第1的商品ID |
| 2.1.5 | itemId2 | 销量排名第2的商品ID | string | 23456789 | Required | 销量排名第2的商品ID |
| 2.1.6 | itemId3 | 销量排名第3的商品ID | string | 34567890 | Required | 销量排名第3的商品ID |
| 2.1.7 | itemName1 | 销量排名第1的商品名称 | string | Wireless Gaming Mouse | Required | 销量排名第1的商品名称 |
| 2.1.8 | itemName2 | 销量排名第2的商品名称 | string | Bluetooth Mouse | Required | 销量排名第2的商品名称 |
| 2.1.9 | itemName3 | 销量排名第3的商品名称 | string | Optical Mouse | Required | 销量排名第3的商品名称 |
| 2.1.10 | keywordRank | 关键词排名 | string | 5 | Required | 关键词排名,0表示该日期无数据 |
| 2.1.11 | localizeKeyword | 关键词译文 | string | 无线鼠标 | Required | 关键词译文 |
| 2.1.12 | pctClickShareItem1 | 第1商品的点击占比 | string | 0.45 | Required | 第1商品的点击占比 |
| 2.1.13 | pctClickShareItem2 | 第2商品的点击占比 | string | 0.25 | Required | 第2商品的点击占比 |
| 2.1.14 | pctClickShareItem3 | 第3商品的点击占比 | string | 0.15 | Required | 第3商品的点击占比 |
| 2.1.15 | pctConvShareItem1 | 第1商品的转化占比 | string | 0.5 | Required | 第1商品的转化占比 |
| 2.1.16 | pctConvShareItem2 | 第2商品的转化占比 | string | 0.23 | Required | 第2商品的转化占比 |
| 2.1.17 | pctConvShareItem3 | 第3商品的转化占比 | string | 0.12 | Required | 第3商品的转化占比 |
| 2.1.18 | reportDate | 报告日期 | string | 2024-11-01 | Required | 报告日期,格式:yyyy-MM-dd |
| 2.1.19 | searchKeyword | 搜索关键词 | string | wireless mouse | Required | 搜索关键词 |
| 2.1.20 | totalPctClickShare | 前3商品点击占比总和 | string | 0.85 | Required | 前3商品点击占比总和 |
| 2.1.21 | totalPctConvShare | 前3商品转化占比总和 | string | 0.85 | Required | 前3商品转化占比总和 |
| 2.1.22 | trendData | 最近7天的趋势数据 | array<object> | — | Required | 最近7天的趋势数据,按日期顺序,包含日期和排名信息 |
| 2.1.22.1 | keywordRank | 关键词排名 | string | 5 | Required | 关键词排名,0表示该日期无数据 |
| 2.1.22.2 | reportDate | 报告日期 | string | 2024-11-01 | Required | 报告日期,格式:yyyy-MM-dd |
| 2.2 | total | 总记录数 | string | 100 | Required | 总记录数 |
| 3 | error_details | 错误详情 | array<any> | — | Required | 错误详情 |
| 4 | message | 提示信息 | string | — | Required | 提示信息 |
| 5 | request_id | 请求id | string | — | Required | 请求id |
| 6 | response_time | 响应时间 | string | — | Required | 响应时间 |
| 7 | total | 总记录数 | integer | — | Required | 总记录数 |
The 查询沃尔玛 - 词 - 沃尔玛热门搜索词 API (/basicOpen/multiplatform/ads/reportSearchTrendsList) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.