/basicOpen/adReport/analyze/keyword{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/analyze/keyword"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/analyze/keyword?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"profileId\": 3006217218034,\n \"startDate\": \"2026-06-01\",\n \"endDate\": \"2026-06-30\",\n \"sponsoredType\": \"sp\",\n \"order\": [\n {\n \"column\": \"spends\",\n \"sort\": \"desc\"\n }\n ],\n \"page\": 1,\n \"limit\": 25\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-06-30 12:00:00",
"data": {
"list": [
{
"key": "running shoes",
"impressions": 5000,
"clicks": 200,
"spends": 150.5,
"sales": 1200,
"orders": 30,
"adUnits": 35,
"unitPrice": 40,
"cpc": 0.75,
"ctr": 4,
"cvr": 15,
"acos": 12.54,
"roas": 7.97,
"cpa": 5.02,
"directSales": 1000,
"directOrders": 25,
"directUnits": 28,
"directUnitPrice": 40,
"directAcos": 15.05,
"directRoas": 6.64,
"indirectSales": 200,
"indirectOrders": 5,
"indirectUnits": 7,
"indirectUnitPrice": 40,
"indirectAcos": 75.25,
"indirectRoas": 1.33,
"indirectOrdersOfOrdersPercent": 16.67,
"keywordText": "running shoes",
"localizeKeywordText": "跑步鞋",
"searchrank": 1500,
"count": 3,
"bnOrders": 5,
"bnSales": 200,
"bnCvr": 2.5,
"bnOrdersPercentage": 16.67,
"bnSalesPercentage": 16.67
}
],
"total": 128
},
"total": 128
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | profileId | 广告Profile ID | integer | — | 可选 | 广告Profile ID,与sid二选一必传 |
| 2 | sid | 系统内店铺ID | integer | — | 可选 | 系统内店铺ID,与profileId二选一必传 |
| 3 | asin | Amazon ASIN列表 | array<any> | — | 可选 | Amazon ASIN列表,与msku二选一必传,最多10个 |
| 4 | msku | 商家SKU列表 | array<any> | — | 可选 | 商家SKU列表,与asin二选一必传,最多10个 |
| 5 | campaignId | 广告活动ID列表(可选) | array<any> | — | 可选 | 广告活动ID列表(可选),与ASIN/MSKU反查结果取交集 |
| 6 | adGroupId | 广告组ID列表(可选) | array<any> | — | 可选 | 广告组ID列表(可选),与ASIN/MSKU反查出的广告组ID取交集 |
| 7 | startDate | 查询开始日期 | string | — | 必填 | 查询开始日期,格式YYYY-MM-DD,最大跨度31天 |
| 8 | endDate | 查询结束日期 | string | — | 必填 | 查询结束日期,格式YYYY-MM-DD |
| 9 | sponsoredType | 广告类型筛选 | string | — | 可选 | 广告类型筛选。 sp:SP广告 sb:SB广告 |
| 10 | order | 排序规则 | array<any> | — | 可选 | 排序规则,最多3个,不传时默认按spends降序。 column: 排序字段名 sort: 排序方向,asc/desc |
| 11 | page | 页码 | integer | — | 可选 | 页码,从1开始,默认1 |
| 12 | limit | 每页返回条数 | integer | — | 可选 | 每页返回条数,默认25,最大1000 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-06-30 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | total | 满足条件的总记录数(用于分页) | integer | 128 | 必填 | 满足条件的总记录数(用于分页) |
| 6.2 | list | list | object | — | 可选 | |
| 6.2.1 | key | 记录唯一标识键 | string | running shoes | 必填 | 记录唯一标识键 |
| 6.2.2 | impressions | 展示量 | integer | 5000 | 必填 | 展示量 |
| 6.2.3 | clicks | 点击量 | integer | 200 | 必填 | 点击量 |
| 6.2.4 | spends | 广告花费 | number | 150.5 | 必填 | 广告花费 |
| 6.2.5 | sales | 广告销售额 | number | 1200 | 必填 | 广告销售额 |
| 6.2.6 | orders | 广告订单数 | integer | 30 | 必填 | 广告订单数 |
| 6.2.7 | adUnits | 广告销量 | integer | 35 | 必填 | 广告销量 |
| 6.2.8 | unitPrice | 广告销售单价 | number | 40 | 必填 | 广告销售单价 |
| 6.2.9 | cpc | 每次点击成本CPC | number | 0.75 | 必填 | 每次点击成本CPC |
| 6.2.10 | ctr | 点击率CTR(%) | number | 4 | 必填 | 点击率CTR(%) |
| 6.2.11 | cvr | 订单转化率CVR(%) | number | 15 | 必填 | 订单转化率CVR(%) |
| 6.2.12 | acos | 广告销售成本比ACOS(%) | number | 12.54 | 必填 | 广告销售成本比ACOS(%) |
| 6.2.13 | roas | 广告投入产出比ROAS | number | 7.97 | 必填 | 广告投入产出比ROAS |
| 6.2.14 | cpa | 每次成交费用CPA | number | 5.02 | 必填 | 每次成交费用CPA |
| 6.2.15 | directSales | 直接销售额 | number | 1000 | 必填 | 直接销售额 |
| 6.2.16 | directOrders | 直接订单数 | integer | 25 | 必填 | 直接订单数 |
| 6.2.17 | directUnits | 直接销量 | integer | 28 | 必填 | 直接销量 |
| 6.2.18 | directUnitPrice | 直接销售单价 | number | 40 | 必填 | 直接销售单价 |
| 6.2.19 | directAcos | 直接ACOS(%) | number | 15.05 | 必填 | 直接ACOS(%) |
| 6.2.20 | directRoas | 直接ROAS | number | 6.64 | 必填 | 直接ROAS |
| 6.2.21 | indirectSales | 间接销售额 | number | 200 | 必填 | 间接销售额 |
| 6.2.22 | indirectOrders | 间接订单数 | integer | 5 | 必填 | 间接订单数 |
| 6.2.23 | indirectUnits | 间接销量 | integer | 7 | 必填 | 间接销量 |
| 6.2.24 | indirectUnitPrice | 间接销售单价 | number | 40 | 必填 | 间接销售单价 |
| 6.2.25 | indirectAcos | 间接ACOS(%) | number | 75.25 | 必填 | 间接ACOS(%) |
| 6.2.26 | indirectRoas | 间接ROAS | number | 1.33 | 必填 | 间接ROAS |
| 6.2.27 | indirectOrdersOfOrdersPercent | 间接订单占比(%) | number | 16.67 | 必填 | 间接订单占比(%) |
| 6.2.28 | keywordText | 关键词文本 | string | running shoes | 必填 | 关键词文本 |
| 6.2.29 | localizeKeywordText | 关键词中文翻译 | string | 跑步鞋 | 必填 | 关键词中文翻译 |
| 6.2.30 | searchrank | ABA搜索排行 | integer | 1500 | 必填 | ABA搜索排行 |
| 6.2.31 | count | 该关键词关联的广告活动数量 | integer | 3 | 必填 | 该关键词关联的广告活动数量 |
| 6.2.32 | bnOrders | 品牌新客订单数(SB专有) | integer | 5 | 必填 | 品牌新客订单数(SB专有) |
| 6.2.33 | bnSales | 品牌新客销售额(SB专有) | number | 200 | 必填 | 品牌新客销售额(SB专有) |
| 6.2.34 | bnCvr | 品牌新客转化率(SB专有 | number | 2.5 | 必填 | 品牌新客转化率(SB专有,%) |
| 6.2.35 | bnOrdersPercentage | 品牌新客订单占比(SB专有 | number | 16.67 | 必填 | 品牌新客订单占比(SB专有,%) |
| 6.2.36 | bnSalesPercentage | 品牌新客销售额占比(SB专有 | number | 16.67 | 必填 | 品牌新客销售额占比(SB专有,%) |
| 7 | total | 总数 | integer | 128 | 必填 | 总数 |
领星ERP的接口:广告分析 - 关键词分析(/basicOpen/adReport/analyze/keyword),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。