文档中心 > API类目 > 国际站外贸直通车操作

alibaba.scbp.ad.keyword.recommend.word (推词)

推词

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_context TopContextDto 必须 用户信息
  • └ product_line_id
  • Number
  • 必须
  • 110101
  • 产品线id
  • └ product_id
  • Number
  • 可选
  • 110101010
  • 产品id
recommend_query RecommendKeywordQueryDTO 必须 推词请求实体类
  • └ search_type
  • Number
  • 必须
  • 1
  • 搜索类型:1-系统推荐 2-按词分组推荐 3-按词推荐词
  • └ campaign_id
  • Number
  • 可选
  • 15488545
  • 计划id
  • └ exact_match
  • Boolean
  • 可选
  • false
  • true-精准匹配 false-模糊匹配
  • └ keyword
  • String
  • 可选
  • test
  • 关键词
  • └ order_by
  • String
  • 可选
  • keyword
  • 排序字段:searchIndex,buyIndex,star,keyword
  • └ order
  • String
  • 可选
  • asc
  • 排序规则 asc/desc
  • └ group_id
  • Number
  • 可选
  • 154878
  • 词组id,searchType为2时必传

响应参数

名称 类型 示例值 描述
result_list AdRecommendWordDTO [] 推词返回实体类
  • └ keyword
  • String
  • test
  • 关键词
  • └ normal_word
  • String
  • TEST
  • 归一化词
  • └ search_index
  • Number
  • 59
  • 搜索热度
  • └ buy_index
  • Number
  • 89
  • 购买热度
  • └ star
  • Number
  • 5
  • 星级(推广评分)
  • └ best_product_id
  • Number
  • 1548787
  • 最优绑定品id
  • └ suggest_price
  • String
  • 12.3
  • 建议出价
  • └ avg_price
  • String
  • 12.0
  • 同行平均出价
  • └ base_price
  • String
  • 11.5
  • 市场底价

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaScbpAdKeywordRecommendWordRequest req = new AlibabaScbpAdKeywordRecommendWordRequest();
AlibabaScbpAdKeywordRecommendWordRequest.TopContextDto obj1 = new AlibabaScbpAdKeywordRecommendWordRequest.TopContextDto();
obj1.setProductLineId(110101L);
obj1.setProductId(110101010L);
req.setTopContext(obj1);
AlibabaScbpAdKeywordRecommendWordRequest.RecommendKeywordQueryDTO obj2 = new AlibabaScbpAdKeywordRecommendWordRequest.RecommendKeywordQueryDTO();
obj2.setSearchType(1L);
obj2.setCampaignId(15488545L);
obj2.setExactMatch(false);
obj2.setKeyword("test");
obj2.setOrderBy("keyword");
obj2.setOrder("asc");
obj2.setGroupId(154878L);
req.setRecommendQuery(obj2);
AlibabaScbpAdKeywordRecommendWordResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_scbp_ad_keyword_recommend_word_response>
    <result_list>
        <ad_recommend_word_d_t_o>
            <keyword>test</keyword>
            <normal_word>TEST</normal_word>
            <search_index>59</search_index>
            <buy_index>89</buy_index>
            <star>5</star>
            <best_product_id>1548787</best_product_id>
            <suggest_price>12.3</suggest_price>
            <avg_price>12.0</avg_price>
            <base_price>11.5</base_price>
        </ad_recommend_word_d_t_o>
    </result_list>
</alibaba_scbp_ad_keyword_recommend_word_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部