關鍵字列表

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

參數

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

請求文件主體

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

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

關鍵字列表

相關URL

參數

相關請求資訊

請求文件主體

回覆文件主體