Qeasy Cloud
Get Started

领星ERP 广告分析 - 关键词分析 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
广告 / 分析 · POST · 请求参数 12 个(必填 2) · 响应参数 45 个 · 限流令牌桶容量 1
Updated At
2026-11-21

广告分析 - 关键词分析

POST/basicOpen/adReport/analyze/keyword
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId广告Profile IDinteger—Optional广告Profile ID,与sid二选一必传
2sid系统内店铺IDinteger—Optional系统内店铺ID,与profileId二选一必传
3asinAmazon ASIN列表array<any>—OptionalAmazon ASIN列表,与msku二选一必传,最多10个
4msku商家SKU列表array<any>—Optional商家SKU列表,与asin二选一必传,最多10个
5campaignId广告活动ID列表(可选)array<any>—Optional广告活动ID列表(可选),与ASIN/MSKU反查结果取交集
6adGroupId广告组ID列表(可选)array<any>—Optional广告组ID列表(可选),与ASIN/MSKU反查出的广告组ID取交集
7startDate查询开始日期string—Required查询开始日期,格式YYYY-MM-DD,最大跨度31天
8endDate查询结束日期string—Required查询结束日期,格式YYYY-MM-DD
9sponsoredType广告类型筛选string—Optional广告类型筛选。 sp:SP广告 sb:SB广告
10order排序规则array<any>—Optional排序规则,最多3个,不传时默认按spends降序。 column: 排序字段名 sort: 排序方向,asc/desc
11page页码integer—Optional页码,从1开始,默认1
12limit每页返回条数integer—Optional每页返回条数,默认25,最大1000

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-06-30 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1total满足条件的总记录数(用于分页)integer128Required满足条件的总记录数(用于分页)
6.2listlistobject—Optional
6.2.1key记录唯一标识键stringrunning shoesRequired记录唯一标识键
6.2.2impressions展示量integer5000Required展示量
6.2.3clicks点击量integer200Required点击量
6.2.4spends广告花费number150.5Required广告花费
6.2.5sales广告销售额number1200Required广告销售额
6.2.6orders广告订单数integer30Required广告订单数
6.2.7adUnits广告销量integer35Required广告销量
6.2.8unitPrice广告销售单价number40Required广告销售单价
6.2.9cpc每次点击成本CPCnumber0.75Required每次点击成本CPC
6.2.10ctr点击率CTR(%)number4Required点击率CTR(%)
6.2.11cvr订单转化率CVR(%)number15Required订单转化率CVR(%)
6.2.12acos广告销售成本比ACOS(%)number12.54Required广告销售成本比ACOS(%)
6.2.13roas广告投入产出比ROASnumber7.97Required广告投入产出比ROAS
6.2.14cpa每次成交费用CPAnumber5.02Required每次成交费用CPA
6.2.15directSales直接销售额number1000Required直接销售额
6.2.16directOrders直接订单数integer25Required直接订单数
6.2.17directUnits直接销量integer28Required直接销量
6.2.18directUnitPrice直接销售单价number40Required直接销售单价
6.2.19directAcos直接ACOS(%)number15.05Required直接ACOS(%)
6.2.20directRoas直接ROASnumber6.64Required直接ROAS
6.2.21indirectSales间接销售额number200Required间接销售额
6.2.22indirectOrders间接订单数integer5Required间接订单数
6.2.23indirectUnits间接销量integer7Required间接销量
6.2.24indirectUnitPrice间接销售单价number40Required间接销售单价
6.2.25indirectAcos间接ACOS(%)number75.25Required间接ACOS(%)
6.2.26indirectRoas间接ROASnumber1.33Required间接ROAS
6.2.27indirectOrdersOfOrdersPercent间接订单占比(%)number16.67Required间接订单占比(%)
6.2.28keywordText关键词文本stringrunning shoesRequired关键词文本
6.2.29localizeKeywordText关键词中文翻译string跑步鞋Required关键词中文翻译
6.2.30searchrankABA搜索排行integer1500RequiredABA搜索排行
6.2.31count该关键词关联的广告活动数量integer3Required该关键词关联的广告活动数量
6.2.32bnOrders品牌新客订单数(SB专有)integer5Required品牌新客订单数(SB专有)
6.2.33bnSales品牌新客销售额(SB专有)number200Required品牌新客销售额(SB专有)
6.2.34bnCvr品牌新客转化率(SB专有number2.5Required品牌新客转化率(SB专有,%)
6.2.35bnOrdersPercentage品牌新客订单占比(SB专有number16.67Required品牌新客订单占比(SB专有,%)
6.2.36bnSalesPercentage品牌新客销售额占比(SB专有number16.67Required品牌新客销售额占比(SB专有,%)
7total总数integer128Required总数

The 广告分析 - 关键词分析 API (/basicOpen/adReport/analyze/keyword) 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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.