一、前言
微店商品列表API是微店开放平台提供的重要接口,允许开发者通过编程方式获取店铺内的商品列表信息。该接口广泛应用于电商数据分析、商品展示平台搭建、价格监控系统开发等场景。相比传统爬虫方式,API调用更加稳定高效,且符合平台规范。前往体验API:c0b.cc/R4rbK2 。
二、接口概述
1. 接口特性
- 请求方式:支持HTTP GET/POST请求,推荐RESTful风格。
- 数据格式:返回JSON格式数据,包含商品ID、名称、价格、库存等核心字段。
- 分页参数:支持page_no(页码)和page_size(每页数量)参数,默认每页20条,最大100条。
- 排序支持:提供价格(price_asc/desc)、销量等排序方式。
2. 请求参数
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
access_token | string | 是 | 访问令牌 |
page_no | int | 否 | 页码,默认1 |
page_size | int | 否 | 每页数量,默认20 |
order_by | string | 否 | 排序方式(如create_time_desc) |
status | string | 否 | 商品状态(onsale/instock/soldout) |
keyword | string | 否 | 搜索关键词 |
3. 返回数据结构
json
{
"items": [
{
"item_id": "商品ID",
"title": "商品标题",
"price": "商品价格",
"stock": "库存数量",
"thumb_url": "缩略图URL"
}
],
"page_info": {
"page_no": 1,
"page_size": 20,
"total_count": 100
}
}
三、Python请求示例
# 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="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
代码说明:
- 使用requests库发送HTTP GET请求,包含完整的错误处理机制。
- 支持分页参数配置,可灵活控制返回数据量。
- 验证API返回状态码确保数据有效性。
- 包含时间戳参数防止请求被缓存。