Lingxing
切换旧版

SP用户搜索词报表

POST/pb/openapi/newad/queryWordReports

基本信息

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

请求头

标签必填说明类型示例
X-API-VERSION是【兼容旧版本】
不添加标签：offset 为分页页码，从1开始
值为 2 时：offset 为分页偏移量，从0开始		[int]2

请求参数

sidinteger必填
店铺id ，对应查询亚马逊店铺列表接口对应字段【sid】
profile_idinteger必填
VC广告店铺profile_id，对应查询广告账号列表接口对应字段【profile_id】，sid跟profile_id其中一个必填
report_datestring必填
报表日期
show_detailinteger
是否展示完整归因期信息【默认0】：0 否，1 是
target_typestring必填
投放类型【默认 keyword】：
keyword 关键词
target 商品投放，SP关键词组的搜索词，也通过此参数进行获取。
offsetinteger
分页偏移量，默认0
lengthinteger
分页条数，默认15

请求示例

{
    "sid": 109,
    "report_date": "2022-06-01",
    "show_detail": 1,
    "target_type": "keyword",
    "offset": 0,
    "length": 15
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 操作成功
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 52688b81-2398-4e60-9617-6ty71fcf5b1e
response_timestring必填
响应时间
示例 2023-03-20 10:07:22
totalinteger必填
总数
示例 20
dataarray<object>必填
响应数据
隐藏子属性
querystring必填
搜索词
示例 iphone13 pro
target_idnumber必填
投放id（关键词/商品投放/关键词组，入参中
target_type=keyword时、返回关键词ID；
target_type=target时、返回商品投放ID或关键词组ID；）
示例 257012918513585
match_typestring必填
匹配类型
示例 BROAD
target_textstring必填
投放的内容
示例 iphone 13 pro
ad_group_idnumber必填
广告组id
示例 876493198967
impressionsnumber必填
展示量
示例 327
clicksnumber必填
点击量
示例 3
costnumber必填
花费
示例 150.94
profile_idnumber必填
亚马逊店铺数字id
示例 121923590660074
campaign_idnumber必填
广告活动id
示例 223897112753433
same_ordersnumber必填
直接成交订单数
示例 0
ordersnumber必填
订单数
示例 0
same_salesnumber必填
直接成交销售额
示例 0
salesnumber必填
销售额
示例 0
unitsnumber必填
销量
示例 0
same_unitsnumber必填
直接成交销量
示例 0
report_datestring必填
报表日期
示例 2021-07-15
same_orders_1dnumber
直接成交订单数(1d)【show_detail=1时返回字段】
示例 0
orders_1dnumber
订单数(1d)【show_detail=1时返回字段】
示例 0
same_sales_1dnumber
直接成交销售额(1d)【show_detail=1时返回字段】
示例 0
sales_1dnumber
销售额(1d)【show_detail=1时返回字段】
示例 0
same_orders_7dnumber
直接成交订单数(7d)【show_detail=1时返回字段】
示例 0
orders_7dnumber
订单数(7d)【show_detail=1时返回字段】
示例 0
same_sales_7dnumber
直接成交销售额(7d)【show_detail=1时返回字段】
示例 0
sales_7dnumber
销售额(7d)【show_detail=1时返回字段】
示例 0
same_orders_30dnumber
直接成交订单数(30d)【show_detail=1时返回字段】
示例 0
orders_30dnumber
订单数(30d)【show_detail=1时返回字段】
示例 0
same_sales_30dnumber
直接成交销售额(30d)【show_detail=1时返回字段】
示例 0
sales_30dnumber
销售额(30d)【show_detail=1时返回字段】
示例 0
same_orders_14dnumber
直接成交订单数(14d)【show_detail=1时返回字段】
示例 0
orders_14dnumber
订单数(14d)【show_detail=1时返回字段】
示例 0
same_sales_14dnumber
直接成交销售额(14d)【show_detail=1时返回字段】
示例 0
sales_14dnumber
销售额(14d)【show_detail=1时返回字段】
示例 0
units_1dnumber
销量(1d)【show_detail=1时返回字段】
示例 0
units_7dnumber
销量(7d)【show_detail=1时返回字段】
示例 0
units_14dnumber
销量(14d)【show_detail=1时返回字段】
示例 0
units_30dnumber
销量(30d)【show_detail=1时返回字段】
示例 0
same_units_1dnumber
直接成交销量(1d)【show_detail=1时返回字段】
示例 0
same_units_7dnumber
直接成交销量(7d)【show_detail=1时返回字段】
示例 0
same_units_14dnumber
直接成交销量(14d)【show_detail=1时返回字段】
示例 0
same_units_30dnumber
直接成交销量(30d)【show_detail=1时返回字段】
示例 0

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "52688b81-2398-4e60-9617-6ty71fcf5b1e",
    "response_time": "2023-03-20 10:07:22",
    "total": 20,
    "data": [
        {
            "query": "iphone13 pro ケース",
            "target_id": 257012918513585,
            "match_type": "BROAD",
            "target_text": "iphone 13 pro",
            "ad_group_id": 876493198967,
            "impressions": 327,
            "clicks": 3,
            "cost": 150.94,
            "profile_id": 121923590660074,
            "campaign_id": 223897112753433,
            "same_orders": 0,
            "orders": 0,
            "same_sales": 0.00,
            "sales": 0.00,
            "units": 0,
            "same_units": 0,
            "report_date": "2021-07-15",
            "same_orders_1d": 0,
            "orders_1d": 0,
            "same_sales_1d": 0.00,
            "sales_1d": 0.00,
            "same_orders_7d": 0,
            "orders_7d": 0,
            "same_sales_7d": 0.00,
            "sales_7d": 0.00,
            "same_orders_30d": 0,
            "orders_30d": 0,
            "same_sales_30d": 0.00,
            "sales_30d": 0.00,
            "same_orders_14d": 0,
            "orders_14d": 0,
            "same_sales_14d": 0.00,
            "sales_14d": 0.00,
            "units_1d": 0,
            "units_7d": 0,
            "units_14d": 0,
            "units_30d": 0,
            "same_units_1d": 0,
            "same_units_7d": 0,
            "same_units_14d": 0,
            "same_units_30d": 0
        }
    ]
}