商品列表

根据指定商品标题、启用状态、日期范围搜索相关商品信息。

参数

名称	是否必填？	描述
sellerid	是	您在新蛋商城的商家编号

请求文件主体

属性		是否必填？	格式	描述
sellerId		是	String	您在新蛋商城的商家编号
countryCode		是	String	广告活动所在的国家/地区。只接受国际标准3位国家编码
campaignNumber		是	Integer	广告活动标识编号
groupNumber		是	Integer	广告组标识编号
searchKeywordType		否	Enum	有效值： GROUP_NAME：模糊匹配，只支持单个关键词 GROUP_NUM：精准匹配，关键词输入组号用逗号分隔，支持批量查询
keyword		否	String	结果限制为具有指定名称的广告活动
activeStatus		否	Enum	结果限制为指定范围内的状态有效值： Active 启用：查询处理中、正在投放、已超预算状态的数据 Inactive 暂停：查询暂停和已结束状态的数据
countries		是	String	广告活动所在的国家/地区。只接受国际标准3位国家编码
pageInfo	pageIndex	否	Integer	当前页索引，默认为 1
	pageSize	否	Integer	一页中的记录数（最大值为每页100 条）
	sortField	否	String	排序字段名称，默认为InDate
	sortType	否	String	默认Desc，支持Desc、Asc两种方式

示例：Json，Request

POST https://api.newegg.com/marketplace/sponsoredmgmt/campaign/product/search?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
  "sellerId": "AN9A",
  "countryCode": "USA",
  "campaignNumber": 1168452,
  "groupNumber": 1168453,
  "searchKeywordType": null,
  "keyword": null,
  "activeStatus": null,
  "countries": [
    "USA"
  ],
  "pageInfo": {
    "pageIndex": 1,
    "pageSize": 4,
    "sortField": "InDate",
    "sortType": "Desc"
  }
}

回复文件主体

属性	格式	描述
campaignNumber	Integer	广告活动标识编号
campaignName	String	广告活动名称
groupNumber	Integer	广告组标识编号
groupName	String	广告组名称
itemNumber	String	新蛋商品编号
itemTitle	String	商品标题
countryCode	String	广告活动所在国家/地区的编码。只接受国际标准3位国家编码
sellingPrice	Decimal	商品实际售价
primaryImgUrl	String	商品主图URL
sellerPartNumber	String	商家商品编号
sellerName	String	卖家名称
activeStatus	Enum	有效值： Active 启用 Inactive 禁用
status	String	广告活动状态描述。有效值： Pending 待审核 Delivering 正在投放 Processing 处理中 Out of budget 已超预算 Inactive 已暂停 Ended 已结束
declineReason	String	广告活动被拒绝原因
totalRows	Integer	记录数

示例：Json，Request

{
  "rows": [
    {
      "campaignNumber": 1166512,
      "campaignName": "Campaign-2022-05-22 11:19:12",
      "groupNumber": 1166513,
      "groupName": "starnonntek",
      "itemNumber": "9SIB55YGFF8214",
      "itemTitle": "Mechanic Game Keyboard with Real RGB Backlight Foldable Wrist Rest 104 Key Blue Switch Retro Round Key cap, Black",
      "countryCode": "USA",
      "sellingPrice": null,
      "primaryImgUrl": null,
      "itemStatus": "ENABLED",
      "itemLink": null,
      "sellerPartNumber": null,
      "sellerID": null,
      "sellerName": null,
      "activeStatus": "Inactive",
      "status": "Ended",
      "declineReason": null
    }
  ],
  "totalRows": 1
}

更新日期：06/29/2022

HTTP方式	是否需要认证？	请求格式	回复格式	频率限制
POST	需要	Json	Json	1000 请求/小时

商品列表

相关URL

参数

相关请求信息

请求文件主体

回复文件主体