商品列表

根據指定商品標題、啟用狀態、日期範圍搜索相關商品資訊。

參數

名稱	是否必填？	描述
sellerid	是	您在新蛋商城的商家編號

請求文件主體

屬性		是否必填？	格式	描述
sellerId		是	String	您在新蛋商城的商家編號
countryCode		是	String	您廣告活動所在的國家/地區。只接受國際標準三位國家代碼
campaignNumber		是	Integer	廣告活動標識編號
groupNumber		是	Integer	廣告組標識編號
searchKeywordType		否	Enum	有效值： GROUP_NAME 模糊匹配，只支援單個關鍵字 GROUP_NUM 精准匹配，關鍵字輸入組號用逗號分隔，支援批量查詢
keyword		否	String	結果限制為具有指定名稱的廣告活動
activeStatus		否	Enum	結果限制為指定範圍內的狀態有效值： Active 啟用：查詢處理中、正在投放、已超預算狀態的資料 Inactive 暫停：查詢暫停和已結束狀態的資料
countries		是	String	您廣告活動所在的國家/地區。只接受國際標準三位國家代碼
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	廣告活動所在國家/地區的編碼。只接受國際標準三位國家代碼
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	Decimal	記錄數

示例：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

參數

相關請求資訊

請求文件主體

回覆文件主體