商品列表

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

相關URL

Newegg.com: https://api.newegg.com/marketplace/sponsoredmgmt/campaign/product/search?sellerid={sellerid}

註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。

參數

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

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
POST 需要 Json Json 1000 請求/小時

請求文件主體

屬性 是否必填? 格式 描述
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