Lingxing
切换旧版

查询沃尔玛广告 - SP广告搜索词列表

POST/basicOpen/multiplatform/ads/reportSearchImpressionSpList

支持查询沃尔玛SP广告的搜索词列表,支持日期、广告账号、广告活动和指标范围筛选。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ads/reportSearchImpressionSpListHTTPSPOST1

请求参数

searchTextstring
搜索词,模糊匹配 searchedKeyword
campaignIdsarray<any>
广告活动ID列表,Long数组
searchedKeywordsarray<any>
搜索词精确筛选列表,String数组
startDatestring必填
开始日期,格式:yyyy-MM-dd
endDatestring必填
结束日期,格式:yyyy-MM-dd
advertiserIdsarray<any>必填
广告账号ID列表,Long数组
reportFieldFilterobject
指标范围筛选对象,key为指标字段的驼峰名称(来源为返参的指标字段),value为[min,max]数值数组
pageSizeinteger
每页条数,默认20,最大200
pageNuminteger
页码,从1开始,默认1
dayinteger
归因天数,可选值:
3
14
30
orderFieldstring
排序字段,使用驼峰字段名
orderTypestring
排序方向,可选值:
ASC:升序
DESC:降序

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/reportSearchImpressionSpList?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "searchText": "phone case",
    "campaignIds": [
        123456789
    ],
    "searchedKeywords": [
        "phone case"
    ],
    "startDate": "2026-09-01",
    "endDate": "2026-09-07",
    "advertiserIds": [
        123456789012345
    ],
    "reportFieldFilter": {
        "adSpend": [
            10,
            100
        ]
    },
    "pageSize": 20,
    "pageNum": 1,
    "day": 14,
    "orderField": "adSpend",
    "orderType": "DESC",
    "operationSourceType": "gateway"
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-09-11 12:00:00
dataobject必填
响应数据
隐藏子属性
totalinteger必填
总记录数
示例 1
listarray<object>必填
搜索词列表
隐藏子属性
mpSellerNamestring必填
店铺名称
示例 Walmart美国店
mpAdvertiserNamestring必填
广告账号名称
示例 Walmart广告账户
advertiserIdinteger必填
广告账号ID
示例 123456789012345
campaignNamestring必填
广告活动名称
示例 手机配件推广
biddingStrategystring必填
广告活动竞价策略
示例 fixed
targetingTypestring必填
投放类型
示例 manual
campaignStatusstring必填
广告活动状态
示例 enabled
campaignIdinteger必填
广告活动ID
示例 123456789
searchedKeywordstring必填
搜索词
示例 phone case
numAdsShowninteger必填
曝光次数
示例 1000
numAdsClicksinteger必填
广告点击量
示例 100
adSpendnumber必填
广告花费
示例 50
advertisedSkuSalesnumber必填
直接销售额--广告直接点击归因销售额
示例 200
advertisedSkuUnitsnumber必填
直接销量--广告直接点击归因销量
示例 10
attributedOrdersinteger必填
广告订单数--归因总订单数
示例 10
otherSkuSalesnumber必填
关联销售额--间接归因销售额
示例 100
otherSkuUnitsnumber必填
关联销量--间接归因销量
示例 5
cpcnumber必填
点击成本CPC--计算公式: 广告花费 / 点击量
示例 0.5
ctrnumber必填
点击率CTR--计算公式: 点击量 / 曝光量 * 100%
示例 10
cvrnumber必填
转化率CVR--计算公式: 广告订单 / 点击量 * 100%
示例 10
cpanumber必填
平均订单成本CPA--计算公式: 广告花费 / 广告订单
示例 5
adSpendPercentnumber必填
广告花费占比 = 当前行adSpend / 汇总行adSpend * 100%
示例 10
numAdsShownPercentnumber必填
曝光量占比 = 当前行numAdsShown / 汇总行numAdsShown * 100%
示例 10
numAdsClicksPercentnumber必填
点击占比 = 当前行numAdsClicks / 汇总行numAdsClicks * 100%
示例 10
attributedOrdersPercentnumber必填
广告订单占比 = 当前行attributedOrders / 汇总行attributedOrders * 100%
示例 10
advertisedSkuSalesPercentnumber必填
直接销售额占比 = 当前行advertisedSkuSales / 汇总行advertisedSkuSales * 100%
示例 10
advertisedSkuUnitsPercentnumber必填
直接销量占比 = 当前行advertisedSkuUnits / 汇总行advertisedSkuUnits * 100%
示例 10
otherSkuSalesPercentnumber必填
关联销售额占比 = 当前行otherSkuSales / 汇总行otherSkuSales * 100%
示例 10
otherSkuUnitsPercentnumber必填
关联销量占比 = 当前行otherSkuUnits / 汇总行otherSkuUnits * 100%
示例 10

| total | 总记录数,与data.total一致 | 是 | [int] | 1 |

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-09-11 12:00:00",
    "data": {
        "total": 1,
        "list": [
            {
                "mpSellerName": "Walmart美国店",
                "mpAdvertiserName": "Walmart广告账户",
                "advertiserId": 123456789012345,
                "campaignName": "手机配件推广",
                "biddingStrategy": "fixed",
                "campaignType": "sponsoredProducts-manual",
                "targetingType": "manual",
                "campaignStatus": "enabled",
                "campaignId": 123456789,
                "searchedKeyword": "phone case",
                "numAdsShown": 1000,
                "numAdsClicks": 100,
                "adSpend": 50,
                "advertisedSkuSales": 200,
                "advertisedSkuUnits": 10,
                "attributedOrders": 10,
                "otherSkuSales": 100,
                "otherSkuUnits": 5,
                "cpc": 0.5,
                "ctr": 10,
                "cvr": 10,
                "cpa": 5,
                "adSpendPercent": 10,
                "numAdsShownPercent": 10,
                "numAdsClicksPercent": 10,
                "attributedOrdersPercent": 10,
                "advertisedSkuSalesPercent": 10,
                "advertisedSkuUnitsPercent": 10,
                "otherSkuSalesPercent": 10,
                "otherSkuUnitsPercent": 10
            }
        ]
    },
    "total": 1
}