轻易云
注册体验

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

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

SB用户搜索词报表

POST/pb/openapi/newad/hsaQueryWordReports
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/hsaQueryWordReports"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "sid": 109,
    "report_date": "2022-06-01",
    "target_type": "target",
    "nextToken": "MQ==",
    "length": 15
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "52688b81-2398-4e60-9617-619fc2cf5b1e",
    "response_time": "2023-03-20 10:14:22",
    "total": 3,
    "nextToken": "MjA=",
    "data": [
      {
        "query": "laptop stand",
        "target_id": 144272087511089300,
        "match_type": "EXACT",
        "target_text": "laptop stand",
        "ad_group_id": 144329503293620480,
        "impressions": 224,
        "clicks": 1,
        "cost": 1.03,
        "profile_id": 121923590660074,
        "campaign_id": 144264775656379200,
        "report_date": "2021-06-23",
        "same_orders": 0,
        "orders": 0,
        "same_sales": 0,
        "sales": 0,
        "new_to_brand_orders": 0,
        "new_to_brand_order_percentage": 0,
        "new_to_brand_order_rate": 0,
        "new_to_brand_sales": 0,
        "new_to_brand_units": 0,
        "video_first_quartile_views": null,
        "video_midpoint_views": null,
        "video_third_quartile_views": null,
        "video_complete_views": null,
        "video_5_second_views": null,
        "video_5_second_view_rate": null,
        "video_unmutes": null
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sid店铺idinteger—可选店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】,sid跟profile_id其中一个必填
2profile_idVC广告店铺profile_idinteger—可选VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
3report_date报表日期string—必填报表日期
4target_type投放类型【默认 keyword】string—可选投放类型【默认 keyword】:keyword 关键词,target 商品投放
5nextToken游标翻页string—可选游标翻页,首次请求不传,后续传上次响应中的 nextToken,和 offset 二选一
6offset分页偏移量integer—可选分页偏移量,默认0,和 nextToken 二选一
7length分页条数integer—可选分页条数,默认15

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示string操作成功必填消息提示
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring52688b81-2398-4e60-9617-619fc2cf5b1e必填请求链路id
5response_time响应时间string2023-03-20 10:14:22必填响应时间
6total总数integer3必填总数
7nextToken下一页游标stringMQ==可选下一页游标,无更多数据时为空
8data响应数据array<object>—必填响应数据
8.1query搜索词stringlaptop stand必填搜索词
8.2target_idtarget_idnumber144272087511089300必填投放id(关键词/商品投放 根据target_type)
8.3match_type匹配类型stringEXACT可选匹配类型,仅 target_type=keyword 时返回
8.4target_text投放的内容stringlaptop stand必填投放的内容
8.5is_asin是否为 ASIN 商品投放(0integer0可选是否为 ASIN 商品投放(0:否,1:是),仅 target_type=target 时返回
8.6ad_group_id广告组idnumber144329503293620480必填广告组id
8.7impressions展示量number224必填展示量
8.8clicks点击量number1必填点击量
8.9cost花费number1.03必填花费
8.10profile_id亚马逊店铺数字idnumber121923590660074必填亚马逊店铺数字id
8.11campaign_id广告活动idnumber144264775656379200必填广告活动id
8.12report_date报表日期string2021-06-23必填报表日期
8.13country国家stringUS可选国家,仅 target_type=target 时返回
8.14same_orders直接成交订单数number0可选直接成交订单数,仅 target_type=keyword 时返回
8.15orders订单数number0必填订单数
8.16same_sales直接成交销售额number0可选直接成交销售额,仅 target_type=keyword 时返回
8.17sales销售额number0必填销售额
8.18view_orders浏览后归因订单数number0可选浏览后归因订单数,仅 target_type=target 时返回
8.19view_sales浏览后归因销售额number0可选浏览后归因销售额,仅 target_type=target 时返回
8.20units_ordered点击归因销量number0可选点击归因销量,仅 target_type=target 时返回
8.21view_units_ordered浏览后归因销量number0可选浏览后归因销量,仅 target_type=target 时返回
8.22new_to_brand_orders品牌新买家订单数量number0可选品牌新买家订单数量,仅 target_type=keyword 时返回
8.23new_to_brand_order_percentage品牌新买家订单百分比number0可选品牌新买家订单百分比,仅 target_type=keyword 时返回
8.24new_to_brand_order_rate品牌新买家转换率number0可选品牌新买家转换率,仅 target_type=keyword 时返回
8.25new_to_brand_sales品牌新买家销售额number0可选品牌新买家销售额,仅 target_type=keyword 时返回
8.26new_to_brand_units品牌新买家销量number0可选品牌新买家销量,仅 target_type=keyword 时返回
8.27viewable_impressions可视展示量integer0可选可视展示量,仅 target_type=target 时返回
8.28add_to_list加入购物清单次数(合计)integer0可选加入购物清单次数(合计),仅 target_type=target 时返回
8.29add_to_list_from_clicks通过点击加入购物清单次数integer0可选通过点击加入购物清单次数,仅 target_type=target 时返回
8.30video_first_quartile_views播放25%的次数integer0必填播放25%的次数
8.31video_midpoint_views播放50%的次数integer0必填播放50%的次数
8.32video_third_quartile_views播放75%的次数integer0必填播放75%的次数
8.33video_complete_views播放100%的次数integer0必填播放100%的次数
8.34video_5_second_views观看完整视频或 5 秒(以较短者为准)的展示次数integer0必填观看完整视频或 5 秒(以较短者为准)的展示次数
8.35video_5_second_view_ratevideo_5_second_view_ratenumber0必填观看完整视频或 5 秒(以较短者为准)的展示次数百分比
8.36video_unmutes取消视频静音的展示次数integer0必填取消视频静音的展示次数

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

需要对接这个接口?

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