1688.item_search_seller-搜索店铺列表 API 返回值说明

{
  "code": 200,
  "msg": "success",
  "request_id": "2025021414300012345",
  "items": {
    "page": "1",
    "real_total_results": 1560,
    "total_results": 1560,
    "pagecount": 78,
    "page_size": "20",
    "item": [ ... ]
  }}

{
  "code": 200,
  "msg": "success",
  "request_id": "2025021414300012345",
  "items": {
    "page": "1",
    "real_total_results": 1560,
    "total_results": 1560,
    "pagecount": 78,
    "page_size": "20",
    "item": [
      {
        "seller_id": "b2b-2200733087881719de",
        "seller_nick": "杭州丝绸源头厂家",
        "shop_name": "杭州某某丝绸服饰有限公司",
        "shop_url": "https://shop12345678.1688.com",
        "shop_id": "12345678",
        "main_business": "真丝连衣裙、丝绸围巾、真丝睡衣",
        "cat_id": "1031912",
        "cat_name": "女装",
        "products_count": 328,
        "sales_count": 15680,
        "credit_level": "AAA",
        "credit_score": 98,
        "is_enterprise": true,
        "is_factory": true,
        "years_in_business": 12,
        "location": "浙江 杭州市",
        "address": "杭州市余杭区某某路168号",
        "transaction_level": "lv.5",
        "return_rate": 0.015,
        "response_time": "1小时内",
        "shipping_speed": "24小时发货"
      },
      {
        "seller_id": "b2b-2200733087881720de",
        "seller_nick": "苏州棉麻批发基地",
        "shop_name": "苏州某某纺织品有限公司",
        "shop_url": "https://shop87654321.1688.com",
        "shop_id": "87654321",
        "main_business": "棉麻面料、棉麻服装、家居布艺",
        "cat_id": "1031913",
        "cat_name": "面料",
        "products_count": 156,
        "sales_count": 8920,
        "credit_level": "AA",
        "credit_score": 88,
        "is_enterprise": true,
        "is_factory": false,
        "years_in_business": 5,
        "location": "江苏 苏州市",
        "area": "江苏 苏州市",
        "transaction_level": "lv.3",
        "response_time": "2小时内"
      }
    ]
  }}

{
  "code": 401,
  "msg": "Unauthorized",
  "request_id": "2025021414300099999",
  "error": {
    "code": 401,
    "message": "Unauthorized: Invalid API Key"
  }}

import requestsimport timeimport hashlibimport urllib.parse# 配置参数APP_KEY = "your_app_key"APP_SECRET = "your_app_secret"API_URL = "https://api-gw.onebound.cn/1688/item_search_seller"def generate_sign(params, secret):
    """
    生成API签名（根据1688签名规则）
    """
    # 按参数名升序排序
    sorted_params = sorted(params.items())
    # 拼接字符串
    param_str = urllib.parse.urlencode(sorted_params)
    # 拼接密钥
    sign_str = param_str + secret    # MD5加密
    sign = hashlib.md5(sign_str.encode()).hexdigest().upper()
    return signdef search_sellers(keyword, page=1, page_size=20, city=None, sort="default"):
    """
    1688店铺搜索
    """
    params = {
        "key": APP_KEY,
        "api_name": "item_search_seller",
        "q": keyword,
        "page": page,
        "page_size": page_size,
        "sort": sort,
        "timestamp": int(time.time())
    }
    
    if city:
        params["city"] = city    
    # 生成签名
    params["sign"] = generate_sign(params, APP_SECRET)
    
    try:
        response = requests.get(API_URL, params=params, timeout=30)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")
        return Nonedef parse_sellers(data):
    """
    解析并打印店铺搜索结果
    """
    if not data or data.get("code") != 200:
        error_msg = data.get("msg", "未知错误") if data else "无响应数据"
        print(f"请求失败: {error_msg}")
        return
    
    items = data.get("items", {})
    sellers = items.get("item", [])
    
    print(f"共找到 {items.get('real_total_results', 0)} 家店铺，当前第 {items.get('page')} 页：\n")
    
    for idx, seller in enumerate(sellers, 1):
        print(f"{idx}. {seller.get('shop_name', '未知店铺')}")
        print(f"   昵称: {seller.get('seller_nick')}")
        print(f"   主营: {seller.get('main_business', '未填写')}")
        print(f"   信用: {seller.get('credit_level', 'N/A')} (评分: {seller.get('credit_score', 'N/A')})")
        print(f"   商品数: {seller.get('products_count', 0)}  累计销量: {seller.get('sales_count', 0)}")
        print(f"   所在地: {seller.get('location', '未知')}")
        print(f"   工厂认证: {'✓' if seller.get('is_factory') else '✗'}  企业认证: {'✓' if seller.get('is_enterprise') else '✗'}")
        print(f"   链接: {seller.get('shop_url')}\n")# 使用示例if __name__ == "__main__":
    # 搜索杭州地区的丝绸店铺
    result = search_sellers(
        keyword="丝绸 连衣裙", 
        page=1, 
        page_size=10,
        city="浙江 杭州",
        sort="credit"  # 按信用排序
    )
    
    if result:
        parse_sellers(result)