轻易云
注册体验

领星ERP广告分析 - 搜索词分析接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
广告 / 分析 · POST · 请求参数 12 个(必填 2) · 响应参数 47 个 · 限流令牌桶容量 1
更新日期
2026-11-21

广告分析 - 搜索词分析

POST/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&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,
          "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
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-06-30 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1total满足条件的总记录数(用于分页)integer128必填满足条件的总记录数(用于分页)
6.2listlistobject—可选
6.2.1key记录唯一标识键stringrunning shoes必填记录唯一标识键
6.2.2impressions展示量integer5000必填展示量
6.2.3clicks点击量integer200必填点击量
6.2.4spends广告花费number150.5必填广告花费
6.2.5sales广告销售额number1200必填广告销售额
6.2.6orders广告订单数integer30必填广告订单数
6.2.7adUnits广告销量integer35必填广告销量
6.2.8unitPrice广告销售单价number40必填广告销售单价
6.2.9cpc每次点击成本CPCnumber0.75必填每次点击成本CPC
6.2.10ctr点击率CTR(%)number4必填点击率CTR(%)
6.2.11cvr订单转化率CVR(%)number15必填订单转化率CVR(%)
6.2.12acos广告销售成本比ACOS(%)number12.54必填广告销售成本比ACOS(%)
6.2.13roas广告投入产出比ROASnumber7.97必填广告投入产出比ROAS
6.2.14cpa每次成交费用CPAnumber5.02必填每次成交费用CPA
6.2.15directSales直接销售额number1000必填直接销售额
6.2.16directOrders直接订单数integer25必填直接订单数
6.2.17directUnits直接销量integer28必填直接销量
6.2.18directUnitPrice直接销售单价number40必填直接销售单价
6.2.19directAcos直接ACOS(%)number15.05必填直接ACOS(%)
6.2.20directRoas直接ROASnumber6.64必填直接ROAS
6.2.21indirectSales间接销售额number200必填间接销售额
6.2.22indirectOrders间接订单数integer5必填间接订单数
6.2.23indirectUnits间接销量integer7必填间接销量
6.2.24indirectUnitPrice间接销售单价number40必填间接销售单价
6.2.25indirectAcos间接ACOS(%)number75.25必填间接ACOS(%)
6.2.26indirectRoas间接ROASnumber1.33必填间接ROAS
6.2.27indirectOrdersOfOrdersPercent间接订单占比(%)number16.67必填间接订单占比(%)
6.2.28query搜索词文本stringrunning shoes必填搜索词文本
6.2.29localizeQuery搜索词中文翻译string跑步鞋必填搜索词中文翻译
6.2.30searchrankABA搜索排行integer1500必填ABA搜索排行
6.2.31count触发该搜索词的关键词+投放数量integer3必填触发该搜索词的关键词+投放数量
6.2.32sponsoredType广告类型stringsp,sb必填广告类型
6.2.33viewImpressions可见展示次数(SB专有)number3000必填可见展示次数(SB专有)
6.2.34vcpmSpends可见展示花费基数(SB专有)number50必填可见展示花费基数(SB专有)
6.2.35vcpm每千次可见展示费用vCPM(SB专有)number16.67必填每千次可见展示费用vCPM(SB专有)
6.2.36vtr可见率VTR(SB专有number60必填可见率VTR(SB专有,%)
6.2.37vctr可见点击率vCTR(SB专有number6.67必填可见点击率vCTR(SB专有,%)
6.2.38spc每次点击带来的销售额SPC(SP专有)number6必填每次点击带来的销售额SPC(SP专有)
7total总数integer128必填总数

领星ERP的接口:广告分析 - 搜索词分析(/basicOpen/adReport/analyze/searchTerm),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。