1688（阿里巴巴批發網）開放平臺提供了店鋪商品相關 API，用于查詢指定店鋪的商品列表、商品詳情等核心數據。本文將從接口摘要、接口概述、Python 請求示例、使用結語四個維度，詳細講解 1688 店鋪所有商品 API 的使用方法，幫助開發者快速實現接口對接。

一、摘要

1688 店鋪所有商品 API 是阿里巴巴開放平臺為開發者提供的核心業務接口之一，主要用于查詢 1688 商家店鋪下的商品列表及商品基礎信息，包括商品 ID、商品名稱、價格、庫存、規格、類目、商品狀態等關鍵數據。

適用場景

商家自身店鋪的商品數據管理、批量運營與統計分析；

第三方服務商開發店鋪管理工具、電商 ERP 系統；

合規的電商行業數據分析、市場調研與選品分析。

二、接口概述

1688 開放平臺的 API 采用RESTful 風格，基于 HTTP/HTTPS 協議通信，支持 GET/POST 請求方式，返回格式以 JSON 為主。以下以供應商店鋪商品列表查詢接口（核心接口）為例，介紹接口的核心信息。接口地址：c0b.cc/R4rbK2 。

三、Python 請求示例

以下示例基于 Python 3.x 實現 1688 店鋪商品 API 的調用，核心包含參數構造、簽名生成、請求發送、響應解析，使用requests庫作為 HTTP 客戶端。

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 請求示例 url 默認請求參數已經做URL編碼
 url = "1688/item_search_shop/?key=&secret=&seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj）

注意事項

參數替換：需將代碼中的APP_KEY、APP_SECRET、SELLER_ID替換為開放平臺的實際信息；

簽名驗證：簽名生成是接口調用的核心，需嚴格按照 1688 的規則實現，否則會返回簽名錯誤；

分頁處理：若商品總數超過單頁條數，需循環調用接口（遞增page_no）獲取所有頁數據；

頻率限制：需遵守接口的 QPS 限制，避免頻繁調用導致限流；

參數格式：部分參數（如seller_id）為字符串類型，需確保參數類型與官方文檔一致。

四、結語

1688 店鋪所有商品 API 是對接 1688 電商生態的重要入口，其使用需嚴格遵守平臺的相關規范，確保數據的合規采集與使用。

審核編輯 黃宇