微店商品列表 API 接口文档

一、摘要

微店商品列表 API（micro.item_search）是微店开放平台提供的核心接口，支持通过关键词、分页参数及筛选条件获取店铺商品列表数据，返回 JSON 格式的商品 ID、名称、价格、库存及图片链接等字段。该接口采用 RESTful 风格设计，适用于电商工具开发、竞品分析及多平台商品展示等场景，其核心优势在于分页灵活性与数据实时性。

二、接口概述

1.核心功能

数据维度：覆盖商品基础信息（标题、价格、库存）、SKU 规格、图片 URL 及销售数据（销量、评分）等。

请求方式：支持 HTTP GET/POST，推荐使用 RESTful 风格调用。

返回格式：默认 JSON 结构，包含 status、data 等字段，data 下细分商品列表详情。

分页参数：page_no（页码）和 page_size（每页数量），默认每页 20 条，最大 100 条。

筛选与排序：支持按分类 ID、商品状态筛选，以及按价格、销量排序。

2.调用流程

构建请求：包含关键词、分页参数、API 密钥及签名等，签名需按规则动态生成。

发送请求：通过 HTTP 请求获取商品列表 JSON 数据。

3.公共请求地址：c0b.cc/R4rbK2。

三、Python 请求示例

以下代码演示如何使用 requests 库调用微店商品列表 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 "
app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词
# 请求示例 url 默认请求参数已经做URL编码 url = "micro/item_search/?key=<您自己的apiKey>&&q=女装&page=1&sort=&price_range=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

代码说明

签名生成：按参数名排序后拼接密钥，通过 MD5 加密生成签名，确保请求安全性。

请求参数：包含 app_key、timestamp、q（关键词）、page_no、page_size 和动态生成的 sign 字段。

响应解析：返回的 JSON 数据中，data 字段包含商品列表，可提取名称、价格、库存及图片链接等信息。

四、结语

微店商品列表 API 为开发者提供了高效、安全的商品数据获取途径，支持电商工具开发、竞品分析及多平台商品展示等多样化应用。通过 Python 示例，可快速实现接口集成，但需注意遵守微店开放平台的调用规范，避免频繁请求导致限流。建议结合分页参数优化查询效率，提升数据处理的稳定性和灵活性。