轻易云
注册体验

领星ERPASIN 点击排名报告接口

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

ASIN 点击排名报告

POST/pb/openapi/newad/asinRankReportData
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/asinRankReportData"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/pb/openapi/newad/asinRankReportData?app_key=value&timestamp=value&sign=value' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <access_token>' \\\n--data '{\n  \"country\": \"US\",\n  \"report_period\": \"WEEK\",\n  \"start_date\": \"2026-10-18\",\n  \"asin\": \"B000000001\",\n  \"keyword\": \"laptop stand\",\n  \"offset\": 0,\n  \"length\": 15\n}'",
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "52688b81-2398-4e60-9617-619fc2cf5b1e",
    "response_time": "2026-10-27 10:00:00",
    "total": 1,
    "next_token": null,
    "data": [
      {
        "country": "US",
        "report_period": "WEEK",
        "data_start_time": "2026-10-18",
        "data_end_time": "2026-10-24",
        "search_term": "laptop stand",
        "search_rank": 5,
        "diff_rank": 2,
        "asins": [
          {
            "asin": "B000000001",
            "title": "Adjustable Laptop Stand",
            "click_share": 25,
            "cvr_share": 12
          }
        ]
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1country国家代码string—必填国家代码
2report_period报告周期string—必填报告周期:DAY(日)、WEEK(周)、MONTH(月)、QUARTER(季度)
3start_date开始日期string—必填开始日期,格式 yyyy-MM-dd。周报告须为周日;月报告须为当月 1 日;季度报告须为 1、4、7、10 月的 1 日。结束日期自动计算
4asinasinstring—可选ASIN,精确匹配。与 keyword 可同时传入,也可均不传
5keyword搜索词关键字string—可选搜索词关键字,模糊匹配;与 asin 同时传入时取交集
6offset分页偏移量integer—可选分页偏移量,从 0 开始,默认 0
7length分页长度integer—可选分页长度,默认 15

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0可选状态码:0 成功,102 参数不合法,500 程序内部错误
2message提示消息string操作成功可选提示消息
3error_details错误信息array<string>[]可选错误信息
4request_id请求链路 IDstring52688b81-2398-4e60-9617-619fc2cf5b1e可选请求链路 ID
5response_time响应时间string2026-10-27 10:00:00可选响应时间,格式 yyyy-MM-dd HH:mm:ss
6total符合筛选条件的报告分组总数integer1可选符合筛选条件的报告分组总数,与列表分组口径一致,不受 offset、length 影响
7next_token本接口不支持游标分页stringnull可选本接口不支持游标分页,返回 null
8data响应数据array<object>—可选响应数据
8.1country国家代码stringUS可选国家代码
8.2report_period报告周期stringWEEK可选报告周期
8.3data_start_time数据开始日期string2026-10-18可选数据开始日期,格式 yyyy-MM-dd
8.4data_end_time数据结束日期string2026-10-24可选数据结束日期,格式 yyyy-MM-dd
8.5search_term搜索词stringlaptop stand可选搜索词
8.6search_rank搜索排名integer5可选搜索排名
8.7diff_rank排名变化值integer2可选排名变化值
8.8asins符合筛选条件的 ASIN 列表array<object>—可选符合筛选条件的 ASIN 列表
8.8.1asinasinstringB000000001可选ASIN
8.8.2title商品标题stringAdjustable Laptop Stand可选商品标题
8.8.3click_share点击份额number25可选点击份额
8.8.4cvr_share转化份额number12可选转化份额

领星ERP的接口:ASIN 点击排名报告(/pb/openapi/newad/asinRankReportData),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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