關鍵字建議

獲取建議關鍵字和建議出價。

相關URL

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

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

參數

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

相關請求資訊

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

請求文件主體

屬性 是否必填？ 格式 描述
sellerId 是 String 您在新蛋商城的商家編號
itemList 是 String 建議出價的商家產品清單
keywordList 否 String ItemList參數中的一個或者兩個
輸入itemList時，返回與該item相關的關鍵字清單；
輸入關鍵字時，返回對應的關鍵字
sponsorType 否 Integer 有效值：

  • 0: Sponsor Products (Default)  產品推廣（默認）
  • 1: Sponsor Headlines  頭條推廣
  • 2: Sponsor Video  視頻推廣
type 否 Integer 有效值：

  • 0：MANUAL (Default)  手動 （默認）
  • 1：AUTO 自動
costModel 否 Integer 有效值：

  • 0: CPM 每千次展示費用
  • 1: CPC  每次點擊費用

示例：Json，Request

POST https://api.newegg.com/marketplace/sponsoredmgmt/campaign/keyword/getsuggest?sellerid={sellerid}
Content-Type: application/json
Accept: application/json
Authorization: 2d9da3949bdffd8594e9fa8a77764ce1
SecretKey: 55F55BC1-5E65-401B-BB1D-E29B0A19B734  
 
{
   "itemList":[
      "9SIABFSFEM7860"
   ],
   "keywordList":[
       
   ],
   "sponsorType":0,
   "type":0,
   "costModel":null
}

回覆文件主體

屬性 格式 描述
suggBidMost Decimal 建議最高出價
suggBidLowest Decimal 建議最低出價
suggBid Decimal 建議出價
status Integer 有效值：

  • 0:  Deactive
  • 1:  Active
searchVolume String 關鍵字搜索量
normalizedKeyword String 標準化關鍵字
matchType Integer 匹配類型。有效值：

  • 0：Exact  精確
  • 1：Broad  廣泛
  • 6：Phrase  短語
matchType Integer 匹配類型。有效值：

  • 2:  Close match  緊密匹配
  • 3:  Loose match  寬泛匹配
  • 4:  Substitute  同類商品
  • 5:  Complements  關聯商品
keywordUrl String 在新蛋網站上的關鍵字URL
keyword String 與產品搜索查詢匹配的關鍵字文本
items String 賣家商品
declineReason String 被拒絕原因
competition Enum 競爭類型。有效值：

  • Low  低
  • Medium  中
  • High  高
bid Decimal 與關鍵字相關聯的競價
activeStatus Enum 匹配類型的活動狀態。有效值：

  • Active  啟用
  • Inactive  暫停

示例：Json，Request

{
   "header":[
      {
         "msg":"fetch auto ml keywords success!",
         "bizCode":"200"
      }
   ],
   "rows":[
      {
         "keyword":"3060",
         "normalizedKeyword":"3060",
         "items":[
            "9SIABFSFEM7860"
         ],
         "keywordUrl":"https://www.newegg.com/p/pl?d=3060",
         "suggBid":0.47,
         "suggBidLowest":0.47,
         "suggBidMost":1.0,
         "bid":null,
         "matchType":0,
         "searchVolume":"10000+",
         "competition":"High"
      },
      {
         "keyword":"3060 ti",
         "normalizedKeyword":"3060|ti",
         "items":[
            "9SIABFSFEM7860"
         ],
         "keywordUrl":"https://www.newegg.com/p/pl?d=3060 ti",
         "suggBid":0.46,
         "suggBidLowest":0.46,
         "suggBidMost":0.98,
         "bid":null,
         "matchType":0,
         "searchVolume":"3000+",
         "competition":"Low"
      },
      {
         "keyword":"3060 ti",
         "normalizedKeyword":"3060|ti",
         "items":[
            "9SIABFSFEM7860"
         ],
         "keywordUrl":"https://www.newegg.com/p/pl?d=3060 ti",
         "suggBid":0.46,
         "suggBidLowest":0.46,
         "suggBidMost":0.72,
         "bid":null,
         "matchType":1,
         "searchVolume":"3000+",
         "competition":"Low"
      },
      {
         "keyword":"3060 ti",
         "normalizedKeyword":"3060|ti",
         "items":[
            "9SIABFSFEM7860"
         ],
         "keywordUrl":"https://www.newegg.com/p/pl?d=3060 ti",
         "suggBid":0.46,
         "suggBidLowest":0.46,
         "suggBidMost":0.85,
         "bid":null,
         "matchType":6,
         "searchVolume":"3000+",
         "competition":"Low"
      }
   ],
   "totalRows":4,
   "suggBid":0.47,
   "suggBidLowest":0.46,
   "suggBidMost":1.0,
   "matchTypes":[
      {
         "matchType":2,
         "matchTypeName":"Close match",
         "suggBid":1.75,
         "suggBidLowest":0.4,
         "suggBidMost":3.1,
         "bid":null,
         "activeStatus":null,
         "status":null,
         "declineReason":null
      },
      {
         "matchType":3,
         "matchTypeName":"Loose match",
         "suggBid":0.45,
         "suggBidLowest":0.4,
         "suggBidMost":0.5,
         "bid":null,
         "activeStatus":null,
         "status":null,
         "declineReason":null
      },
      {
         "matchType":4,
         "matchTypeName":"Substitutes",
         "suggBid":0.255,
         "suggBidLowest":0.19,
         "suggBidMost":0.32,
         "bid":null,
         "activeStatus":null,
         "status":null,
         "declineReason":null
      },
      {
         "matchType":5,
         "matchTypeName":"Complements",
         "suggBid":0.31,
         "suggBidLowest":0.24,
         "suggBidMost":0.38,
         "bid":null,
         "activeStatus":null,
         "status":null,
         "declineReason":null
      }
   ]
}

更新日期：10/03/2022