關鍵字列表

搜索指定關鍵字,查詢廣告活動資訊。

相關URL

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

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

參數

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

相關請求資訊

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

請求文件主體

屬性 是否必填? 格式 描述
sellerId String 您在新蛋商城的商家編號
campaignNumber Integer 關鍵字相關聯的廣告活動標識編號
searchKeywordType Enum 關鍵字,模糊匹配

與關鍵字配合使用,同時返回值或不返回值

如果不通過,表示該條件未被過濾

keyword String 結果限制為與指定文本完全匹配的關鍵字
activeStatus Enum 有效值:

  • Active 啟用:查詢處理中、正在投放、已超預算狀態的資料
  • Inactive 暫停:查詢暫停和已結束狀態的資料
pageInfo pageIndex Integer 當前頁索引,預設為 1
pageSize Integer 單頁中的記錄數(預設為20,每頁最大值為99999)
sortField String 排序欄位名稱,默認為InDate
sortType String 預設Desc,支援Desc、Asc兩種方式

示例:Json,Request

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

{
  "sellerId": "ANWT",
  "campaignNumber": 1171910,
  "groupNumber": 1171911,
  "searchKeywordType": null,
  "keyword": null,
  "activeStatus": null,
  "pageInfo": {
    "pageIndex": 1,
    "pageSize": 9999999,
    "sortField": null,
    "sortType": null
  }
}

回覆文件主體

屬性 格式 描述
campaignNumber Integer 與關鍵字相關聯的廣告活動標識編號
campaignName String 與關鍵字相關聯的廣告活動名稱
groupNumber Integer 與關鍵字相關聯的廣告組標識編號
groupName String 與關鍵字相關聯的廣告組名稱
keyword String 與搜索查詢匹配的文本
matchType Integer 匹配類型。有效值:

  • 0:Exact 精確
  • 1:Broad 廣泛
  • 6:Phrase 短語
normalizedKeyword String 標準化關鍵字
keywordUrl String 在新蛋網站上的關鍵字URL
suggBid Decimal 建議出價
suggBidLowest Decimal 建議最低出價
suggBidMost Decimal 建議最高出價
searchVolume String 關鍵字搜索量
competition Enum 競爭類型。有效值:

  • Low 低
  • Medium 中
  • High 高
bid Decimal 與關鍵字相關聯的競價
activeStatus Enum 有效值:

  • Active 啟用:查詢處理中、正在投放、已超預算狀態的資料
  • Inactive 暫停:查詢暫停和已結束狀態的資料
status String 廣告活動狀態描述:

  • Pending 待審核
  • Delivering 正在投放
  • Processing 處理中
  • Out of budget 已超預算
  • Inactive 已暫停
  • Ended 已結束
declineReason String 廣告活動被拒絕原因
totalRows Integer 記錄總數

示例:Json,Request

{
  "rows": [
    {
      "campaignNumber": 0,
      "campaignName": null,
      "groupNumber": 0,
      "groupName": null,
      "keyword": "drill",
      "matchType": 3,
      "normalizedKeyword": "drill",
      "keywordUrl": "https://www.newegg.com/p/pl?d=drill",
      "suggBid": null,
      "suggBidLowest": null,
      "suggBidMost": null,
      "searchVolume": null,
      "competition": null,
      "bid": 0.35,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null
    }
],
totalRows: 1
}

更新日期:06/29/2022