1688店铺详情API使用指南

1688 店铺详情 API 是阿里巴巴开放平台（1688 Open Platform）提供的核心接口之一，支持开发者通过店铺 ID、店铺链接等标识，获取 1688 平台店铺的基本信息、经营资质、店铺等级、主营品类等核心数据。该接口为电商数据分析、店铺监控、供应链对接、导购平台开发等场景提供了关键的数据支撑。本文将从摘要、接口概述、Python 请求示例、结语四个维度，详细介绍该 API 的使用方式。

一、摘要

1688 店铺详情 API 依托阿里巴巴的开放生态，为开发者提供标准化的店铺数据获取能力。通过调用该接口，开发者可传入店铺 ID、会员 ID 等关键参数，快速获取店铺的基础信息（如店铺名称、LOGO、联系方式）、经营信息（如开店时间、店铺类型、诚信通年限）、资质信息（如企业营业执照、商家认证信息）以及运营数据（如店铺等级、主营产品类目、交易勋章）等。

二、接口概述

接口名称：1688店铺详情API（1688.seller_info）。

请求地址：c0b.cc/R4rbK2 。

请求方法：GET/POST/HTTPS（根据具体接口定义）。

返回格式：JSON。

主要参数：

shopId：店铺ID（必填）

三、Python请求示例

为了便于理解与使用，以下为一个基于Python语言实现的请求示例，展示如何调用1688店铺详情API并解析返回结果。

# coding:utf-8

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

from __future__ import print_function

import requests

# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014"

# 请求示例 url 默认请求参数已经做URL编码

url = "https://api-gw.onebound.cn/1688/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&sid=b2b-2206619673102e9470"

headers = { "Accept-Encoding": "gzip", "Connection": "close" }

if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

关键说明

参数验证：shop_id是必传参数，可从 1688 店铺页面的 URL 中提取（如店铺 URL 为https://shop123456789.1688.com/，则shop_id为123456789）。

签名正确性：签名是请求成功的关键，需确保参数排序、拼接AppSecret的方式与官方规则一致，否则会返回 “签名错误”。

异常处理：需捕获请求超时、网络错误、接口返回错误码等异常，可添加重试机制提升稳定性。

数据解析：接口返回的字段可能因版本更新而变化，需以官方文档的返回字段为准。

四、结语

通过以上内容，您可以了解1688店铺详情API的基本使用方式，并能够借助Python轻松实现数据抓取。在实际开发过程中，请确保遵循1688开放平台的相关规范，合理控制请求频率，避免对系统造成压力。同时，建议结合业务需求对获取的数据进行清洗、存储及可视化分析，从而提升应用价值。

审核编辑 黄宇