/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
}
]
}
]
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | country | 国家代码 | string | — | Required | 国家代码 |
| 2 | report_period | 报告周期 | string | — | Required | 报告周期:DAY(日)、WEEK(周)、MONTH(月)、QUARTER(季度) |
| 3 | start_date | 开始日期 | string | — | Required | 开始日期,格式 yyyy-MM-dd。周报告须为周日;月报告须为当月 1 日;季度报告须为 1、4、7、10 月的 1 日。结束日期自动计算 |
| 4 | asin | asin | string | — | Optional | ASIN,精确匹配。与 keyword 可同时传入,也可均不传 |
| 5 | keyword | 搜索词关键字 | string | — | Optional | 搜索词关键字,模糊匹配;与 asin 同时传入时取交集 |
| 6 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,从 0 开始,默认 0 |
| 7 | length | 分页长度 | integer | — | Optional | 分页长度,默认 15 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Optional | 状态码:0 成功,102 参数不合法,500 程序内部错误 |
| 2 | message | 提示消息 | string | 操作成功 | Optional | 提示消息 |
| 3 | error_details | 错误信息 | array<string> | [] | Optional | 错误信息 |
| 4 | request_id | 请求链路 ID | string | 52688b81-2398-4e60-9617-619fc2cf5b1e | Optional | 请求链路 ID |
| 5 | response_time | 响应时间 | string | 2026-10-27 10:00:00 | Optional | 响应时间,格式 yyyy-MM-dd HH:mm:ss |
| 6 | total | 符合筛选条件的报告分组总数 | integer | 1 | Optional | 符合筛选条件的报告分组总数,与列表分组口径一致,不受 offset、length 影响 |
| 7 | next_token | 本接口不支持游标分页 | string | null | Optional | 本接口不支持游标分页,返回 null |
| 8 | data | 响应数据 | array<object> | — | Optional | 响应数据 |
| 8.1 | country | 国家代码 | string | US | Optional | 国家代码 |
| 8.2 | report_period | 报告周期 | string | WEEK | Optional | 报告周期 |
| 8.3 | data_start_time | 数据开始日期 | string | 2026-10-18 | Optional | 数据开始日期,格式 yyyy-MM-dd |
| 8.4 | data_end_time | 数据结束日期 | string | 2026-10-24 | Optional | 数据结束日期,格式 yyyy-MM-dd |
| 8.5 | search_term | 搜索词 | string | laptop stand | Optional | 搜索词 |
| 8.6 | search_rank | 搜索排名 | integer | 5 | Optional | 搜索排名 |
| 8.7 | diff_rank | 排名变化值 | integer | 2 | Optional | 排名变化值 |
| 8.8 | asins | 符合筛选条件的 ASIN 列表 | array<object> | — | Optional | 符合筛选条件的 ASIN 列表 |
| 8.8.1 | asin | asin | string | B000000001 | Optional | ASIN |
| 8.8.2 | title | 商品标题 | string | Adjustable Laptop Stand | Optional | 商品标题 |
| 8.8.3 | click_share | 点击份额 | number | 25 | Optional | 点击份额 |
| 8.8.4 | cvr_share | 转化份额 | number | 12 | Optional | 转化份额 |
The ASIN 点击排名报告 API (/pb/openapi/newad/asinRankReportData) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.