/basicOpen/adReport/analyze/searchTerm{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/analyze/searchTerm"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/analyze/searchTerm?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,
"query": "running shoes",
"localizeQuery": "跑步鞋",
"searchrank": 1500,
"count": 3,
"sponsoredType": "sp,sb",
"viewImpressions": 3000,
"vcpmSpends": 50,
"vcpm": 16.67,
"vtr": 60,
"vctr": 6.67,
"spc": 6
}
],
"total": 128
},
"total": 128
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | profileId | 广告Profile ID | integer | — | Optional | 广告Profile ID,与sid二选一必传 |
| 2 | sid | 系统内店铺ID | integer | — | Optional | 系统内店铺ID,与profileId二选一必传 |
| 3 | asin | Amazon ASIN列表 | array<any> | — | Optional | Amazon ASIN列表,与msku二选一必传,最多10个 |
| 4 | msku | 商家SKU列表 | array<any> | — | Optional | 商家SKU列表,与asin二选一必传,最多10个 |
| 5 | campaignId | 广告活动ID列表(可选) | array<any> | — | Optional | 广告活动ID列表(可选),与ASIN/MSKU反查结果取交集 |
| 6 | adGroupId | 广告组ID列表(可选) | array<any> | — | Optional | 广告组ID列表(可选),与ASIN/MSKU反查出的广告组ID取交集 |
| 7 | startDate | 查询开始日期 | string | — | Required | 查询开始日期,格式YYYY-MM-DD,最大跨度31天 |
| 8 | endDate | 查询结束日期 | string | — | Required | 查询结束日期,格式YYYY-MM-DD |
| 9 | sponsoredType | 广告类型筛选 | string | — | Optional | 广告类型筛选。 sp:SP广告 sb:SB广告 |
| 10 | order | 排序规则 | array<any> | — | Optional | 排序规则,最多3个,不传时默认按spends降序。 column: 排序字段名 sort: 排序方向,asc/desc |
| 11 | page | 页码 | integer | — | Optional | 页码,从1开始,默认1 |
| 12 | limit | 每页返回条数 | integer | — | Optional | 每页返回条数,默认25,最大1000 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-06-30 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | total | 满足条件的总记录数(用于分页) | integer | 128 | Required | 满足条件的总记录数(用于分页) |
| 6.2 | list | list | object | — | Optional | |
| 6.2.1 | key | 记录唯一标识键 | string | running shoes | Required | 记录唯一标识键 |
| 6.2.2 | impressions | 展示量 | integer | 5000 | Required | 展示量 |
| 6.2.3 | clicks | 点击量 | integer | 200 | Required | 点击量 |
| 6.2.4 | spends | 广告花费 | number | 150.5 | Required | 广告花费 |
| 6.2.5 | sales | 广告销售额 | number | 1200 | Required | 广告销售额 |
| 6.2.6 | orders | 广告订单数 | integer | 30 | Required | 广告订单数 |
| 6.2.7 | adUnits | 广告销量 | integer | 35 | Required | 广告销量 |
| 6.2.8 | unitPrice | 广告销售单价 | number | 40 | Required | 广告销售单价 |
| 6.2.9 | cpc | 每次点击成本CPC | number | 0.75 | Required | 每次点击成本CPC |
| 6.2.10 | ctr | 点击率CTR(%) | number | 4 | Required | 点击率CTR(%) |
| 6.2.11 | cvr | 订单转化率CVR(%) | number | 15 | Required | 订单转化率CVR(%) |
| 6.2.12 | acos | 广告销售成本比ACOS(%) | number | 12.54 | Required | 广告销售成本比ACOS(%) |
| 6.2.13 | roas | 广告投入产出比ROAS | number | 7.97 | Required | 广告投入产出比ROAS |
| 6.2.14 | cpa | 每次成交费用CPA | number | 5.02 | Required | 每次成交费用CPA |
| 6.2.15 | directSales | 直接销售额 | number | 1000 | Required | 直接销售额 |
| 6.2.16 | directOrders | 直接订单数 | integer | 25 | Required | 直接订单数 |
| 6.2.17 | directUnits | 直接销量 | integer | 28 | Required | 直接销量 |
| 6.2.18 | directUnitPrice | 直接销售单价 | number | 40 | Required | 直接销售单价 |
| 6.2.19 | directAcos | 直接ACOS(%) | number | 15.05 | Required | 直接ACOS(%) |
| 6.2.20 | directRoas | 直接ROAS | number | 6.64 | Required | 直接ROAS |
| 6.2.21 | indirectSales | 间接销售额 | number | 200 | Required | 间接销售额 |
| 6.2.22 | indirectOrders | 间接订单数 | integer | 5 | Required | 间接订单数 |
| 6.2.23 | indirectUnits | 间接销量 | integer | 7 | Required | 间接销量 |
| 6.2.24 | indirectUnitPrice | 间接销售单价 | number | 40 | Required | 间接销售单价 |
| 6.2.25 | indirectAcos | 间接ACOS(%) | number | 75.25 | Required | 间接ACOS(%) |
| 6.2.26 | indirectRoas | 间接ROAS | number | 1.33 | Required | 间接ROAS |
| 6.2.27 | indirectOrdersOfOrdersPercent | 间接订单占比(%) | number | 16.67 | Required | 间接订单占比(%) |
| 6.2.28 | query | 搜索词文本 | string | running shoes | Required | 搜索词文本 |
| 6.2.29 | localizeQuery | 搜索词中文翻译 | string | 跑步鞋 | Required | 搜索词中文翻译 |
| 6.2.30 | searchrank | ABA搜索排行 | integer | 1500 | Required | ABA搜索排行 |
| 6.2.31 | count | 触发该搜索词的关键词+投放数量 | integer | 3 | Required | 触发该搜索词的关键词+投放数量 |
| 6.2.32 | sponsoredType | 广告类型 | string | sp,sb | Required | 广告类型 |
| 6.2.33 | viewImpressions | 可见展示次数(SB专有) | number | 3000 | Required | 可见展示次数(SB专有) |
| 6.2.34 | vcpmSpends | 可见展示花费基数(SB专有) | number | 50 | Required | 可见展示花费基数(SB专有) |
| 6.2.35 | vcpm | 每千次可见展示费用vCPM(SB专有) | number | 16.67 | Required | 每千次可见展示费用vCPM(SB专有) |
| 6.2.36 | vtr | 可见率VTR(SB专有 | number | 60 | Required | 可见率VTR(SB专有,%) |
| 6.2.37 | vctr | 可见点击率vCTR(SB专有 | number | 6.67 | Required | 可见点击率vCTR(SB专有,%) |
| 6.2.38 | spc | 每次点击带来的销售额SPC(SP专有) | number | 6 | Required | 每次点击带来的销售额SPC(SP专有) |
| 7 | total | 总数 | integer | 128 | Required | 总数 |
The 广告分析 - 搜索词分析 API (/basicOpen/adReport/analyze/searchTerm) 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.