Lingxing
切换旧版

广告分析 - 搜索词分析

POST/basicOpen/adReport/analyze/searchTerm

以搜索词（query）为维度聚合 SP / SB 广告指标。支持通过 ASIN / MSKU 反查所关联广告组下的搜索词、进行聚合。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/analyze/searchTermHTTPSPOST1

请求参数

profileIdinteger
广告Profile ID，与sid二选一必传
sidinteger
系统内店铺ID，与profileId二选一必传
asinarray<any>
Amazon ASIN列表，与msku二选一必传，最多10个
mskuarray<any>
商家SKU列表，与asin二选一必传，最多10个
campaignIdarray<any>
广告活动ID列表（可选），与ASIN/MSKU反查结果取交集
adGroupIdarray<any>
广告组ID列表（可选），与ASIN/MSKU反查出的广告组ID取交集
startDatestring必填
查询开始日期，格式YYYY-MM-DD，最大跨度31天
endDatestring必填
查询结束日期，格式YYYY-MM-DD
sponsoredTypestring
广告类型筛选。
sp：SP广告
sb：SB广告
orderarray<any>
排序规则，最多3个，不传时默认按spends降序。
column: 排序字段名
sort: 排序方向，asc/desc
pageinteger
页码，从1开始，默认1
limitinteger
每页返回条数，默认25，最大1000

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/analyze/searchTerm?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": 3006217218034,
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "sponsoredType": "sp",
    "order": [
        {
            "column": "spends",
            "sort": "desc"
        }
    ],
    "page": 1,
    "limit": 25
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-06-30 12:00:00
dataobject必填
响应数据
隐藏子属性
totalinteger必填
满足条件的总记录数（用于分页）
示例 128
listobject
隐藏子属性
keystring必填
记录唯一标识键
示例 running shoes
impressionsinteger必填
展示量
示例 5000
clicksinteger必填
点击量
示例 200
spendsnumber必填
广告花费
示例 150.5
salesnumber必填
广告销售额
示例 1200
ordersinteger必填
广告订单数
示例 30
adUnitsinteger必填
广告销量
示例 35
unitPricenumber必填
广告销售单价
示例 40
cpcnumber必填
每次点击成本CPC
示例 0.75
ctrnumber必填
点击率CTR（%）
示例 4
cvrnumber必填
订单转化率CVR（%）
示例 15
acosnumber必填
广告销售成本比ACOS（%）
示例 12.54
roasnumber必填
广告投入产出比ROAS
示例 7.97
cpanumber必填
每次成交费用CPA
示例 5.02
directSalesnumber必填
直接销售额
示例 1000
directOrdersinteger必填
直接订单数
示例 25
directUnitsinteger必填
直接销量
示例 28
directUnitPricenumber必填
直接销售单价
示例 40
directAcosnumber必填
直接ACOS（%）
示例 15.05
directRoasnumber必填
直接ROAS
示例 6.64
indirectSalesnumber必填
间接销售额
示例 200
indirectOrdersinteger必填
间接订单数
示例 5
indirectUnitsinteger必填
间接销量
示例 7
indirectUnitPricenumber必填
间接销售单价
示例 40
indirectAcosnumber必填
间接ACOS（%）
示例 75.25
indirectRoasnumber必填
间接ROAS
示例 1.33
indirectOrdersOfOrdersPercentnumber必填
间接订单占比（%）
示例 16.67
querystring必填
搜索词文本
示例 running shoes
localizeQuerystring必填
搜索词中文翻译
示例 跑步鞋
searchrankinteger必填
ABA搜索排行
示例 1500
countinteger必填
触发该搜索词的关键词+投放数量
示例 3
sponsoredTypestring必填
广告类型
示例 sp,sb
viewImpressionsnumber必填
可见展示次数（SB专有）
示例 3000
vcpmSpendsnumber必填
可见展示花费基数（SB专有）
示例 50
vcpmnumber必填
每千次可见展示费用vCPM（SB专有）
示例 16.67
vtrnumber必填
可见率VTR（SB专有，%）
示例 60
vctrnumber必填
可见点击率vCTR（SB专有，%）
示例 6.67
spcnumber必填
每次点击带来的销售额SPC（SP专有）
示例 6
totalinteger必填
总数
示例 128

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-06-30 12:00:00",
    "data": {
        "list": [
            {
                "key": "running shoes",
                "impressions": 5000,
                "clicks": 200,
                "spends": 150.50,
                "sales": 1200.00,
                "orders": 30,
                "adUnits": 35,
                "unitPrice": 40.00,
                "cpc": 0.75,
                "ctr": 4.00,
                "cvr": 15.00,
                "acos": 12.54,
                "roas": 7.97,
                "cpa": 5.02,
                "directSales": 1000.00,
                "directOrders": 25,
                "directUnits": 28,
                "directUnitPrice": 40.00,
                "directAcos": 15.05,
                "directRoas": 6.64,
                "indirectSales": 200.00,
                "indirectOrders": 5,
                "indirectUnits": 7,
                "indirectUnitPrice": 40.00,
                "indirectAcos": 75.25,
                "indirectRoas": 1.33,
                "indirectOrdersOfOrdersPercent": 16.67,
                "query": "running shoes",
                "localizeQuery": "跑步鞋",
                "searchrank": 1500,
                "count": 3,
                "sponsoredType": "sp,sb",
                "viewImpressions": 3000,
                "vcpmSpends": 50.00,
                "vcpm": 16.67,
                "vtr": 60.00,
                "vctr": 6.67,
                "spc": 6.00
            }
        ],
        "total": 128
    },
    "total": 128
}