文档中心 > Affiliate API(已废弃)

aliexpress.affiliate.hotproduct.query (查询联盟爆品数据)

查询联盟爆品API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_signature String 可选 sssfffxxgggg 请求签名
category_ids String 可选 111,222,333 类目ID列表
fields String 可选 app_sale_price,shop_id 返回字段列表
keywords String 可选 mp3 关键词
max_sale_price Number 可选 33333 最大售价
min_sale_price Number 可选 22222 最小售价
page_no Number 可选 111
  • 默认值:1
  • 请求页数
    page_size Number 可选 50
  • 默认值:50
  • 每次请求数量
    platform_product_type String 可选 TMALL 平台商家类型:ALL,PLAZA,TMALL
    sort String 可选 SALE_PRICE_ASC 排序方式:SALE_PRICE_ASC, SALE_PRICE_DESC, DISCOUNT_ASC, DISCOUNT_DESC, LAST_VOLUME_ASC, LAST_VOLUME_DESC
    target_currency String 可选 USD 目标币种:USD, GBP, CAD, EUR, UAH, MXN, TRY, RUB, BRL, AUD, INR, JPY, IDR, SEK,KRW
    target_language String 可选 EN 目标语言:EN,RU,PT,ES,FR,ID,IT,TH,JA,AR,VI,TR,DE,HE,KO,NL,PL,MX,CL,IW,IN
    tracking_id String 可选 trackingId trackingId
    delivery_days String 可选 3 物流到达时间。3:3日达,5:5 日达,7:7日达,10:10日达
    ship_to_country String 可选 US 商品收货国家,根据该国家税率政策返回对应商品价格

    响应参数

    名称 类型 示例值 描述
    resp_result ResponseDto resp_result 返回结果
    • └ resp_code
    • Number
    • 200
    • 返回结果状态码
    • └ resp_msg
    • String
    • success
    • 返回结果状态描述
    • result
    • TrafficProductResultDto
    • result
    • 返回结果状态结果
    • └ current_page_no
    • Number
    • 1
    • 当前返回页数
    • └ current_record_count
    • Number
    • 50
    • 当前返回数量
    • products
    • Product []
    • products
    • 返回商品数量
    • └ app_sale_price
    • String
    • 362
    • app专享售价
    • └ app_sale_price_currency
    • String
    • USD
    • app专享售价币种
    • └ commission_rate
    • String
    • 3.5%
    • 佣金率
    • └ discount
    • String
    • 50%
    • 折扣比例
    • └ evaluate_rate
    • String
    • 92.1%
    • 好评率
    • └ first_level_category_id
    • Number
    • 1111111
    • 一级类目ID
    • └ first_level_category_name
    • String
    • Women's Clothing
    • 一级类目名称
    • └ lastest_volume
    • Number
    • 300
    • 近期销量
    • └ hot_product_commission_rate
    • String
    • 60%
    • 爆品佣金率
    • └ original_price
    • String
    • 100
    • 商品原始报价
    • └ original_price_currency
    • String
    • USD
    • 商品原始报价币种
    • └ platform_product_type
    • String
    • TMALL
    • 平台商家类型
    • └ product_detail_url
    • String
    • https://www.aliexpress.com/item/33006951782.html
    • 商品访问地址
    • └ product_id
    • Number
    • 33006951782
    • 商品ID
    • └ product_main_image_url
    • String
    • https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg
    • 商品主题地址
    • └ product_small_image_urls
    • String []
    • https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg
    • 商品小图地址列表
    • └ product_title
    • String
    • Spring Autumn mother daughter dress matching family outfits mother kids dress matching outfits flamingo embroidery 1 to 11 yrs
    • 商品标题
    • └ product_video_url
    • String
    • https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg
    • 商品视频地址
    • └ promotion_link
    • String
    • http://s.click.aliexpress.com/e/xxxxx
    • 推广转链信息
    • └ sale_price
    • String
    • 15.9
    • 商品售价
    • └ sale_price_currency
    • String
    • USD
    • 商品售价币种
    • └ second_level_category_id
    • Number
    • 333333
    • 商品二级类目ID
    • └ second_level_category_name
    • String
    • Women's Clothing
    • 商品二级类目名称
    • └ shop_id
    • Number
    • 111111
    • 店铺ID
    • └ shop_url
    • String
    • https://www.aliexpress.com/store/3255036
    • 店铺地址
    • └ target_app_sale_price
    • String
    • 330
    • 按目标币种转换后的APP专享价
    • └ target_app_sale_price_currency
    • String
    • USD
    • 按目标币种转换后的APP专享价币种
    • └ target_original_price
    • String
    • 380
    • 按目标币种转换后的原始价格
    • └ target_original_price_currency
    • String
    • USD
    • 按目标币种转换后的原始价格币种
    • └ target_sale_price
    • String
    • 350
    • 按目标币种转换后的售价
    • └ target_sale_price_currency
    • String
    • USD
    • 按目标币种转换后的售价币种
    • └ relevant_market_commission_rate
    • String
    • 10%
    • JV佣金率
    • promo_code_info
    • PromoCodeDto
    • promoCodeInfo
    • code信息
    • └ promo_code
    • String
    • GMG20207
    • 专属绑定PID的code码
    • └ code_campaigntype
    • String
    • 1
    • 优惠方式 1 满减,2 满折
    • └ code_value
    • String
    • On order over USD 10, get USD 7 off
    • 面额
    • └ code_availabletime_start
    • String
    • 2020-04-01 00:00:00
    • code使用有效期的开始时间
    • └ code_availabletime_end
    • String
    • 2020-04-30 23:59:59
    • code使用有效期的结束时间
    • └ code_mini_spend
    • String
    • 1
    • 最低使用门槛
    • └ code_quantity
    • String
    • 1
    • code剩余可使用的数量
    • └ code_promotionurl
    • String
    • https://s.click.aliexpress.com/e/_xxxxx
    • 品code合一url
    • └ ship_to_days
    • String
    • ship to RU in 7 days
    • 可达国家与到达时间
    • └ total_page_no
    • Number
    • 222
    • 总计页数
    • └ total_record_count
    • Number
    • 3333
    • 总计数量

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AliexpressAffiliateHotproductQueryRequest req = new AliexpressAffiliateHotproductQueryRequest();
    req.setAppSignature("sssfffxxgggg");
    req.setCategoryIds("111,222,333");
    req.setFields("app_sale_price,shop_id");
    req.setKeywords("mp3");
    req.setMaxSalePrice(33333L);
    req.setMinSalePrice(22222L);
    req.setPageNo(111L);
    req.setPageSize(50L);
    req.setPlatformProductType("TMALL");
    req.setSort("SALE_PRICE_ASC");
    req.setTargetCurrency("USD");
    req.setTargetLanguage("EN");
    req.setTrackingId("trackingId");
    req.setDeliveryDays("3");
    req.setShipToCountry("US");
    AliexpressAffiliateHotproductQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <aliexpress_affiliate_hotproduct_query_response>
        <resp_result>
            <resp_code>200</resp_code>
            <resp_msg>success</resp_msg>
            <result>
                <current_page_no>1</current_page_no>
                <current_record_count>50</current_record_count>
                <products>
                    <product>
                        <app_sale_price>362</app_sale_price>
                        <app_sale_price_currency>USD</app_sale_price_currency>
                        <commission_rate>3.5%</commission_rate>
                        <discount>50%</discount>
                        <evaluate_rate>92.1%</evaluate_rate>
                        <first_level_category_id>1111111</first_level_category_id>
                        <first_level_category_name>Women&apos;s Clothing</first_level_category_name>
                        <lastest_volume>300</lastest_volume>
                        <hot_product_commission_rate>60%</hot_product_commission_rate>
                        <original_price>100</original_price>
                        <original_price_currency>USD</original_price_currency>
                        <platform_product_type>TMALL</platform_product_type>
                        <product_detail_url>https://www.aliexpress.com/item/33006951782.html</product_detail_url>
                        <product_id>33006951782</product_id>
                        <product_main_image_url>https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg</product_main_image_url>
                        <product_small_image_urls>
                            <string>https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg</string>
                        </product_small_image_urls>
                        <product_title>Spring Autumn mother daughter dress matching family outfits mother kids dress matching outfits flamingo embroidery 1 to 11 yrs</product_title>
                        <product_video_url>https://ae01.alicdn.com/kf/HTB1tyl7bELrK1Rjy0Fjq6zYXFXaC/Spring-Autumn-mother-daughter-dress-matching-family-outfits-mother-kids-dress-matching-outfits-flamingo-embroidery-1.jpg</product_video_url>
                        <promotion_link>http://s.click.aliexpress.com/e/xxxxx</promotion_link>
                        <sale_price>15.9</sale_price>
                        <sale_price_currency>USD</sale_price_currency>
                        <second_level_category_id>333333</second_level_category_id>
                        <second_level_category_name>Women&apos;s Clothing</second_level_category_name>
                        <shop_id>111111</shop_id>
                        <shop_url>https://www.aliexpress.com/store/3255036</shop_url>
                        <target_app_sale_price>330</target_app_sale_price>
                        <target_app_sale_price_currency>USD</target_app_sale_price_currency>
                        <target_original_price>380</target_original_price>
                        <target_original_price_currency>USD</target_original_price_currency>
                        <target_sale_price>350</target_sale_price>
                        <target_sale_price_currency>USD</target_sale_price_currency>
                        <relevant_market_commission_rate>10%</relevant_market_commission_rate>
                        <promo_code_info>
                            <promo_code>GMG20207</promo_code>
                            <code_campaigntype>1</code_campaigntype>
                            <code_value>On order over USD 10, get USD 7 off</code_value>
                            <code_availabletime_start>2020-04-01 00:00:00</code_availabletime_start>
                            <code_availabletime_end>2020-04-30 23:59:59</code_availabletime_end>
                            <code_mini_spend>1</code_mini_spend>
                            <code_quantity>1</code_quantity>
                            <code_promotionurl>https://s.click.aliexpress.com/e/_xxxxx</code_promotionurl>
                        </promo_code_info>
                        <ship_to_days>ship to RU in 7 days</ship_to_days>
                    </product>
                </products>
                <total_page_no>222</total_page_no>
                <total_record_count>3333</total_record_count>
            </result>
        </resp_result>
    </aliexpress_affiliate_hotproduct_query_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

    返回
    顶部