/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×tamp=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
}
]
}
]
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | country | 国家代码 | string | — | 必填 | 国家代码 |
| 2 | report_period | 报告周期 | string | — | 必填 | 报告周期:DAY(日)、WEEK(周)、MONTH(月)、QUARTER(季度) |
| 3 | start_date | 开始日期 | string | — | 必填 | 开始日期,格式 yyyy-MM-dd。周报告须为周日;月报告须为当月 1 日;季度报告须为 1、4、7、10 月的 1 日。结束日期自动计算 |
| 4 | asin | asin | string | — | 可选 | ASIN,精确匹配。与 keyword 可同时传入,也可均不传 |
| 5 | keyword | 搜索词关键字 | string | — | 可选 | 搜索词关键字,模糊匹配;与 asin 同时传入时取交集 |
| 6 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,从 0 开始,默认 0 |
| 7 | length | 分页长度 | integer | — | 可选 | 分页长度,默认 15 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 可选 | 状态码:0 成功,102 参数不合法,500 程序内部错误 |
| 2 | message | 提示消息 | string | 操作成功 | 可选 | 提示消息 |
| 3 | error_details | 错误信息 | array<string> | [] | 可选 | 错误信息 |
| 4 | request_id | 请求链路 ID | string | 52688b81-2398-4e60-9617-619fc2cf5b1e | 可选 | 请求链路 ID |
| 5 | response_time | 响应时间 | string | 2026-10-27 10:00:00 | 可选 | 响应时间,格式 yyyy-MM-dd HH:mm:ss |
| 6 | total | 符合筛选条件的报告分组总数 | integer | 1 | 可选 | 符合筛选条件的报告分组总数,与列表分组口径一致,不受 offset、length 影响 |
| 7 | next_token | 本接口不支持游标分页 | string | null | 可选 | 本接口不支持游标分页,返回 null |
| 8 | data | 响应数据 | array<object> | — | 可选 | 响应数据 |
| 8.1 | country | 国家代码 | string | US | 可选 | 国家代码 |
| 8.2 | report_period | 报告周期 | string | WEEK | 可选 | 报告周期 |
| 8.3 | data_start_time | 数据开始日期 | string | 2026-10-18 | 可选 | 数据开始日期,格式 yyyy-MM-dd |
| 8.4 | data_end_time | 数据结束日期 | string | 2026-10-24 | 可选 | 数据结束日期,格式 yyyy-MM-dd |
| 8.5 | search_term | 搜索词 | string | laptop stand | 可选 | 搜索词 |
| 8.6 | search_rank | 搜索排名 | integer | 5 | 可选 | 搜索排名 |
| 8.7 | diff_rank | 排名变化值 | integer | 2 | 可选 | 排名变化值 |
| 8.8 | asins | 符合筛选条件的 ASIN 列表 | array<object> | — | 可选 | 符合筛选条件的 ASIN 列表 |
| 8.8.1 | asin | asin | string | B000000001 | 可选 | ASIN |
| 8.8.2 | title | 商品标题 | string | Adjustable Laptop Stand | 可选 | 商品标题 |
| 8.8.3 | click_share | 点击份额 | number | 25 | 可选 | 点击份额 |
| 8.8.4 | cvr_share | 转化份额 | number | 12 | 可选 | 转化份额 |
领星ERP的接口:ASIN 点击排名报告(/pb/openapi/newad/asinRankReportData),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。