Lingxing
切换旧版

ABA热门搜索词报告

POST/pb/openapi/newad/asinRankReportData

接口信息

API Path请求协议请求方式令牌桶容量
/pb/openapi/newad/asinRankReportDataHTTPSPOST10

请求头

标签必填说明类型示例
Content-Type是请求体格式[string]application/json

请求参数

countrystring必填
国家代码
report_periodstring必填
报告周期:DAY(日)、WEEK(周)、MONTH(月)、QUARTER(季度)
start_datestring必填
开始日期,格式 yyyy-MM-dd。周报告须为周日;月报告须为当月 1 日;季度报告须为 1、4、7、10 月的 1 日。结束日期自动计算
asinstring
ASIN,精确匹配。与 keyword 可同时传入,也可均不传
keywordstring
搜索词关键字,模糊匹配;与 asin 同时传入时取交集
offsetinteger
分页偏移量,从 0 开始,默认 0
lengthinteger
分页长度,默认 15

请求cURL示例

curl --location 'https://openapi.lingxing.com/pb/openapi/newad/asinRankReportData?app_key=value&timestamp=value&sign=value' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \
--data '{
  "country": "US",
  "report_period": "WEEK",
  "start_date": "2026-10-18",
  "asin": "B000000001",
  "keyword": "laptop stand",
  "offset": 0,
  "length": 15
}'

返回结果

JSON Object

codeinteger
状态码:0 成功,102 参数不合法,500 程序内部错误
示例 0
messagestring
提示消息
示例 操作成功
error_detailsarray<string>
错误信息
示例 []
request_idstring
请求链路 ID
示例 52688b81-2398-4e60-9617-619fc2cf5b1e
response_timestring
响应时间,格式 yyyy-MM-dd HH:mm:ss
示例 2026-10-27 10:00:00
totalinteger
符合筛选条件的报告分组总数,与列表分组口径一致,不受 offset、length 影响
示例 1
next_tokenstring
本接口不支持游标分页,返回 null
示例 null
dataarray<object>
响应数据
隐藏子属性
countrystring
国家代码
示例 US
report_periodstring
报告周期
示例 WEEK
data_start_timestring
数据开始日期,格式 yyyy-MM-dd
示例 2026-10-18
data_end_timestring
数据结束日期,格式 yyyy-MM-dd
示例 2026-10-24
search_termstring
搜索词
示例 laptop stand
search_rankinteger
搜索排名
示例 5
diff_rankinteger
排名变化值
示例 2
asinsarray<object>
符合筛选条件的 ASIN 列表
隐藏子属性
asinstring
ASIN
示例 B000000001
titlestring
商品标题
示例 Adjustable Laptop Stand
click_sharenumber
点击份额
示例 25
cvr_sharenumber
转化份额
示例 12

返回成功示例

{
  "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.0,
          "cvr_share": 12.0
        }
      ]
    }
  ]
}