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
          • 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
          • IM
            • IM
    • 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
        • 1688-KA-Order-EN.md
        • README.md
        • Taobao-Order-CN.md
        • Taobao-Order-EN.md
  1. AlibabaProduct

AlibabaProductKeywordsQuery

POST
/alibaba/ka/product/keywords/query
filter:
totalEpScoreLv1:Comprehensive Experience score (5 stars)
totalEpScoreLv2:Comprehensive experience score (4.5 stars -5.0 stars)
totalEpScoreLv3:Comprehensive experience score (4 stars -4.5 stars)
totalEpScoreLv4:Comprehensive experience score (below 4 stars)
certifiedFactory:Certified Factory
shipInToday:Shipment today
shipIn24Hours:24-hour delivery
shipIn48Hours:Shipment within 48 hours
noReason7DReturn:Seven days without reason
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",
    "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: eb4e1d5755e246cf986caa3b6cce28d7' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'nonce-str;' \
--header 'timestamp: 1715669977082' \
--header 'timestamp;' \
--header 'user-id: 2218427022945' \
--header 'user-id;' \
--header 'signature: 8A15DC76ADFF1C8D775AB141549D603E' \
--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",
    "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-04-30 07:11:09
Previous
The acquisition logic of 1688 commodity prices
Next
AlibabaProductImageQuery
Built with