1. AlibabaProduct
Xportcn KA client
  • English version
    • API Reference
      • Basics
        • Get user address information
        • Address added and updated
      • Warehouse logistics
        • Please refer to the estimated overseas freight
        • Order overseas freight preview
        • Create international logistics orders
        • Update domestic logistics information
      • KA
        • Interface description flowchart
        • The acquisition logic of 1688 commodity prices
        • Alibaba
          • OrderStatusMaunal.md
          • Help Manual
          • AlibabaProduct
            • AlibabaProductKeywordsQuery
              POST
            • AlibabaProductImageQuery
              POST
            • AlibabaProductCategory
              POST
            • AlibabaProductDetail
              POST
            • AlibabaProductFreightEstimateGet
              POST
            • AlibabaProductDetailMulti
              POST
          • AlibabaOrderController
            • order pay
            • Order list
            • Order Preview (The preview interface needs to be called before creating an order)
            • Create an order
            • Get order details
            • Order Logistics
            • OrderClose
          • IM
            • IM
        • Taobao
          • TaoProduct
            • TaoBaoProductDetail
            • TaoBaoProductKeywordsQuery
            • TaoBaoProductImageQuery
        • Balance
          • BalanceDetailGet
    • Product Documentation
      • Announcement
      • Summarize
      • Beginner's guide
        • Become a developer
        • Obtain the Access Key and Access key
        • Start development
      • API tutorial
        • Development manual
        • Error code
      • Message service access
        • Message access manual
      • Account test
        • 1688 Test account
      • Q&A
        • Merchandise store search screening
      • OrderStatusFlow
        • README.md
        • Taobao-Order-CN.md
        • Taobao-Order-EN.md
  1. AlibabaProduct

AlibabaProductKeywordsQuery

POST
/alibaba/ka/product/keywords/query

filter:
#Comprehensive Experience Score / 综合体验分
totalEpScoreLv1:Comprehensive experience score (5 stars) / 综合体验分(5星)
totalEpScoreLv2:Comprehensive experience score (4.5 stars - 5.0 stars) / 综合体验分(4.5星-5.0星)
totalEpScoreLv3:Comprehensive experience score (4 stars - 4.5 stars) / 综合体验分(4星-4.5星)
totalEpScoreLv4:Comprehensive experience score (below 4 stars) / 综合体验分(4星以下)

#24-Hour Collection Rate / 24小时揽收率
getRate24HLv1:24-hour collection rate (below 95%) / 24小时揽收率(<95%)
getRate24HLv2:24-hour collection rate (>= 95%) / 24小时揽收率(>=95%)
getRate24HLv3:24-hour collection rate (>= 99%) / 24小时揽收率(>=99%)

#48-Hour Collection Rate / 48小时揽收率
getRate48HLv1:48-hour collection rate (below 95%) / 48小时揽收率(<95%)
getRate48HLv2:48-hour collection rate (>= 95%) / 48小时揽收率(>=95%)
getRate48HLv3:48-hour collection rate (>= 99%) / 48小时揽收率(>=99%)

#Shipping Timeliness / 发货时效
shipInToday:Shipment today / 当日发货
shipIn24Hours:24-hour delivery / 24小时发货
shipIn48Hours:Shipment within 48 hours / 48小时发货

#After-Sales Service / 售后服务
noReason7DReturn:Seven days without reason / 7天无理由

#Dropshipping / 一件代发
isOnePsale:Support dropshipping / 支持一件代发
isOnePsaleFreePost:Support free shipping (dropshipping with free shipping) / 支持包邮(一件代发包邮)

#New Arrivals / 上新
new7:New products in 7 days / 7天上新
new30:New products in 30 days / 30天上新

#Platform Certifications / 平台认证
1688Selection:1688 Selection / 严选
isQqyx:Global Selection / 全球严选

#Quality Return Rate / 品质退款率(品质退款:因为品质原因发生的退款)
qrr10:Quality refund rate in the past 30 days (5% - 10%) / 近30天品质退款率(5%~10%)
qrr5:Quality refund rate in the past 30 days (1% - 5%) / 近30天品质退款率(1%~5%)
qrr1:Quality refund rate in the past 30 days (0 - 1%) / 近30天品质退款率(0~1%)
qrr0:Quality refund rate in the past 30 days (0%) / 近30天品质退款率(0%)

#Excluded Countries/Regions (Not Suitable for Sale) / 排除不宜销售(排除不宜销售商品)
JPFL:Exclude products not suitable for sale in Japan / 排除日本不宜销售商品
USFL:Exclude products not suitable for sale in the United States / 排除美国不宜销售商品
KRFL:Exclude products not suitable for sale in South Korea / 排除韩国不宜销售商品
VNFL:Exclude products not suitable for sale in Vietnam / 排除越南不宜销售商品
SAFL:Exclude products not suitable for sale in Saudi Arabia / 排除沙特阿拉伯不宜销售商品
RUFL:Exclude products not suitable for sale in Eastern Europe / 排除东欧不宜销售商品
KZFL:Exclude products not suitable for sale in Kazakhstan / 排除哈萨克斯坦不宜销售商品
HKFL:Exclude products not suitable for sale in Hong Kong, China / 排除中国香港不宜销售商品
MOFL:Exclude products not suitable for sale in Macau, China / 排除中国澳门不宜销售商品
TWFL:Exclude products not suitable for sale in Taiwan, China / 排除中国台湾不宜销售商品

Parameter example: filter incoming shipIn24Hours, noReason7DReturn, English comma-separated multiple conditions; Meaning: Products that support both 24-hour delivery and 7-day no-reason return

sort:
{"price":"asc","price":"desc","monthSold":"asc"}

Request

Header Params

Body Params application/json

Example
{
    "keyword": "test",
    "beginPage": 1,
    "pageSize": 2,
    "country": "en",
    "sort": "{\"price\":\"asc\",\"monthSold\":\"asc\"}",
    "priceStart": "1",
    "priceEnd": "10",
    "currency": "USD",
    "categoryId": 0,
    "filter": "shipInToday",
    "productCollectionId": "collectionId"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://www.xportcn.com/api/alibaba/ka/product/keywords/query' \
--header 'access-key;' \
--header 'nonce-str;' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data '{
    "keyword": "test",
    "beginPage": 1,
    "pageSize": 2,
    "country": "en",
    "sort": "{\"price\":\"asc\",\"monthSold\":\"asc\"}",
    "priceStart": "1",
    "priceEnd": "10",
    "currency": "USD",
    "categoryId": 0,
    "filter": "shipInToday",
    "productCollectionId": "collectionId"
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "requestId": "00825cdcaf154f4aaee5cbc2e4dfee9f",
    "code": 200,
    "developId": "1023561483696472887",
    "msg": "成功",
    "data": {
        "totalRecords": 529,
        "totalPage": 265,
        "pageSize": 2,
        "currentPage": 1,
        "data": [
            {
                "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01blcodb1UNL0TO2S6s_!!3258482505-0-cib.jpg",
                "subject": "20A黄铜尖嘴LCR开尔文测试夹 大号鳄鱼夹 正负极测试夹平口鸭嘴夹",
                "subjectTrans": "20A Brass Tip Lcr Kaierwen Test Clip Large Crocodile Clip Positive and Negative Test Clip Flat Mouth Duckbill Clip",
                "offerId": 731218795448,
                "isJxhy": true,
                "repurchaseRate": "0%",
                "monthSold": 406,
                "topCategoryId": 57,
                "secondCategoryId": 201549101,
                "thirdCategoryId": 1039427,
                "price": 300,
                "servicePrice": 5,
                "handlingPrice": 4,
                "totalPrice": 309
            },
            {
                "imageUrl": "https://cbu01.alicdn.com/img/ibank/10231220871_2045071176.jpg",
                "subject": "优利特尿酮体试纸 尿酮试纸 酮体试纸尿目测试条生酮检测试纸",
                "subjectTrans": "Ulite urine ketone test paper urine ketone test paper Ketone test paper urine eye test strip ketogenic test paper",
                "offerId": 554175955535,
                "isJxhy": false,
                "repurchaseRate": "12.84%",
                "monthSold": 2788,
                "topCategoryId": 66,
                "secondCategoryId": 1612,
                "thirdCategoryId": 1037358,
                "price": 300,
                "servicePrice": 5,
                "handlingPrice": 4,
                "totalPrice": 309
            }
        ]
    }
}
Modified at 2026-08-13 07:37:03
Previous
Help Manual
Next
AlibabaProductImageQuery
Built with