轻易云
注册体验

领星ERPSP用户搜索词报表接口

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

SP用户搜索词报表

POST/pb/openapi/newad/queryWordReports
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/queryWordReports"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "sid": 109,
    "report_date": "2022-06-01",
    "show_detail": 1,
    "target_type": "keyword",
    "offset": 0,
    "length": 15
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "52688b81-2398-4e60-9617-6ty71fcf5b1e",
    "response_time": "2023-03-20 10:07:22",
    "total": 20,
    "data": [
      {
        "query": "iphone13 pro ケース",
        "target_id": 257012918513585,
        "match_type": "BROAD",
        "target_text": "iphone 13 pro",
        "ad_group_id": 876493198967,
        "impressions": 327,
        "clicks": 3,
        "cost": 150.94,
        "profile_id": 121923590660074,
        "campaign_id": 223897112753433,
        "same_orders": 0,
        "orders": 0,
        "same_sales": 0,
        "sales": 0,
        "units": 0,
        "same_units": 0,
        "report_date": "2021-07-15",
        "same_orders_1d": 0,
        "orders_1d": 0,
        "same_sales_1d": 0,
        "sales_1d": 0,
        "same_orders_7d": 0,
        "orders_7d": 0,
        "same_sales_7d": 0,
        "sales_7d": 0,
        "same_orders_30d": 0,
        "orders_30d": 0,
        "same_sales_30d": 0,
        "sales_30d": 0,
        "same_orders_14d": 0,
        "orders_14d": 0,
        "same_sales_14d": 0,
        "sales_14d": 0,
        "units_1d": 0,
        "units_7d": 0,
        "units_14d": 0,
        "units_30d": 0,
        "same_units_1d": 0,
        "same_units_7d": 0,
        "same_units_14d": 0,
        "same_units_30d": 0
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1next_token分页游标string—可选分页游标,使用上次响应中的 next_token。首次请求无需传入;与 offset 同时传入时,以 next_token 为准
2sid店铺idinteger—必填店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
3profile_idVC广告店铺profile_idinteger—必填VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
4report_date报表日期string—必填报表日期
5show_detail是否展示完整归因期信息【默认0】integer—可选是否展示完整归因期信息【默认0】:0 否,1 是
6target_type投放类型【默认 keyword】string—必填投放类型【默认 keyword】: keyword 关键词 target 商品投放,SP关键词组的搜索词,也通过此参数进行获取。
7offset分页偏移量integer—可选分页偏移量,默认0
8length分页条数integer—可选分页条数,默认15

接口响应参数

序号字段名称类型默认值必填描述
1next_token分页游标stringODAwMDAwMDAwMDAwMDAyNDE3必填分页游标,作为 next_token 传入下一次请求
2code状态码integer0必填状态码,0 成功
3message消息提示string操作成功必填消息提示
4error_details错误信息array<any>—必填错误信息
5request_id请求链路idstring52688b81-2398-4e60-9617-6ty71fcf5b1e必填请求链路id
6response_time响应时间string2023-03-20 10:07:22必填响应时间
7total总数integer20必填总数
8data响应数据array<object>—必填响应数据
8.1query搜索词stringiphone13 pro必填搜索词
8.2target_id投放id(关键词/商品投放/关键词组number257012918513585必填投放id(关键词/商品投放/关键词组,入参中 target_type=keyword时、返回关键词ID; target_type=target时、返回商品投放ID或关键词组ID;)
8.3match_type匹配类型stringBROAD必填匹配类型
8.4target_text投放的内容stringiphone 13 pro必填投放的内容
8.5ad_group_id广告组idnumber876493198967必填广告组id
8.6impressions展示量number327必填展示量
8.7clicks点击量number3必填点击量
8.8cost花费number150.94必填花费
8.9profile_id亚马逊店铺数字idnumber121923590660074必填亚马逊店铺数字id
8.10campaign_id广告活动idnumber223897112753433必填广告活动id
8.11same_orders直接成交订单数number0必填直接成交订单数
8.12orders订单数number0必填订单数
8.13same_sales直接成交销售额number0必填直接成交销售额
8.14sales销售额number0必填销售额
8.15units销量number0必填销量
8.16same_units直接成交销量number0必填直接成交销量
8.17report_date报表日期string2021-07-15必填报表日期
8.18same_orders_1dsame_orders_1dnumber0可选直接成交订单数(1d)【show_detail=1时返回字段】
8.19orders_1dorders_1dnumber0可选订单数(1d)【show_detail=1时返回字段】
8.20same_sales_1dsame_sales_1dnumber0可选直接成交销售额(1d)【show_detail=1时返回字段】
8.21sales_1dsales_1dnumber0可选销售额(1d)【show_detail=1时返回字段】
8.22same_orders_7dsame_orders_7dnumber0可选直接成交订单数(7d)【show_detail=1时返回字段】
8.23orders_7dorders_7dnumber0可选订单数(7d)【show_detail=1时返回字段】
8.24same_sales_7dsame_sales_7dnumber0可选直接成交销售额(7d)【show_detail=1时返回字段】
8.25sales_7dsales_7dnumber0可选销售额(7d)【show_detail=1时返回字段】
8.26same_orders_30dsame_orders_30dnumber0可选直接成交订单数(30d)【show_detail=1时返回字段】
8.27orders_30dorders_30dnumber0可选订单数(30d)【show_detail=1时返回字段】
8.28same_sales_30dsame_sales_30dnumber0可选直接成交销售额(30d)【show_detail=1时返回字段】
8.29sales_30dsales_30dnumber0可选销售额(30d)【show_detail=1时返回字段】
8.30same_orders_14dsame_orders_14dnumber0可选直接成交订单数(14d)【show_detail=1时返回字段】
8.31orders_14dorders_14dnumber0可选订单数(14d)【show_detail=1时返回字段】
8.32same_sales_14dsame_sales_14dnumber0可选直接成交销售额(14d)【show_detail=1时返回字段】
8.33sales_14dsales_14dnumber0可选销售额(14d)【show_detail=1时返回字段】
8.34units_1dunits_1dnumber0可选销量(1d)【show_detail=1时返回字段】
8.35units_7dunits_7dnumber0可选销量(7d)【show_detail=1时返回字段】
8.36units_14dunits_14dnumber0可选销量(14d)【show_detail=1时返回字段】
8.37units_30dunits_30dnumber0可选销量(30d)【show_detail=1时返回字段】
8.38same_units_1dsame_units_1dnumber0可选直接成交销量(1d)【show_detail=1时返回字段】
8.39same_units_7dsame_units_7dnumber0可选直接成交销量(7d)【show_detail=1时返回字段】
8.40same_units_14dsame_units_14dnumber0可选直接成交销量(14d)【show_detail=1时返回字段】
8.41same_units_30dsame_units_30dnumber0可选直接成交销量(30d)【show_detail=1时返回字段】

领星ERP的接口:SP用户搜索词报表(/pb/openapi/newad/queryWordReports),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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