关键词建议

获取建议关键词和建议出价。

相关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