如何通过 WooCommerce API 获取店铺统计数据

实时掌握店铺数据（订单、销量、客户数、库存等）可以帮你快速决策。用 WooCommerce API 自动获取这些关键数据，还能生成报表、监控业务。本文会介绍具体怎么做。

一、为什么使用 WooCommerce API 获取统计数据

WooCommerce 后台提供可视化的统计面板，但使用 API 获取数据有以下优势：

• 自动化：可集成到 ERP、BI、CRM 等系统，实时拉取数据更新。
• 多维度分析：结合外部数据库和工具，生成自定义报表。
• 跨平台管理：多店铺管理时，通过 API 集中汇总不同站点数据。

二、API 准备工作

2.1 生成 API Key

• 登录 WordPress 后台 → WooCommerce → 设置 → 高级 → REST API。

• 点击【添加密钥】，填写描述，选择用户（建议使用管理员账户），权限选择【读取/写入】（如果需要修改数据）。

• 生成后，复制 Consumer Key 与 Consumer Secret，用于 API 鉴权。

2.2 确认 API URL 结构

API 端点一般为：

https://你的域名/wp-json/wc/v3/

例如获取统计数据：

https://你的域名/wp-json/wc-analytics/{endpoint}

鉴权方式同 WooCommerce REST API，使用 Consumer Key 与 Consumer Secret 进行 Basic Auth 认证。

三、常用统计 API 端点与示例

2.1 获取销售概览

接口 URL：

GET /wp-json/wc-analytics/reports/revenue/stats

示例请求（使用 curl）：

curl -X GET https://你的域名/wp-json/wc-analytics/reports/revenue/stats \
-u ck_xxxxxxxxxxxxxxxxx:cs_xxxxxxxxxxxxxxxxx

常用查询参数：

参数	说明	示例值
before	结束日期（ISO8601）	2025-07-07
after	开始日期（ISO8601）	2025-07-01
interval	时间粒度	day, week, month, year

返回示例：

{
  "totals": {
    "total_sales": 25000,
    "net_revenue": 23000,
    "orders_count": 45,
    "avg_order_value": 511.11
  },
  "intervals": [
    {
      "date_start": "2025-07-01",
      "date_end": "2025-07-01",
      "subtotals": {
        "total_sales": 5000,
        "net_revenue": 4500,
        "orders_count": 10,
        "avg_order_value": 500
      }
    },
    ...
  ]
}

2.2 获取订单统计

接口 URL：

GET /wp-json/wc-analytics/orders

示例请求（Python requests）：

import requests
from requests.auth import HTTPBasicAuth

url = "https://你的域名/wp-json/wc-analytics/orders"
consumer_key = "ck_xxxxxxxxxxxxxxxxx"
consumer_secret = "cs_xxxxxxxxxxxxxxxxx"

response = requests.get(url, auth=HTTPBasicAuth(consumer_key, consumer_secret))

if response.status_code == 200:
    data = response.json()
    for order in data['orders']:
        print("订单ID:", order['id'], "金额:", order['total'])
else:
    print("请求失败，状态码:", response.status_code)

2.3 获取顾客统计

新版 Analytics API 提供顾客统计端点：

GET /wp-json/wc-analytics/customers/stats

示例返回：

{
  "totals": {
    "customers_count": 120,
    "new_customers": 15,
    "returning_customers": 105
  }
}

可以结合 after 和 before 参数获取指定日期范围的新增用户数据。

四、分页与速率限制

• 默认每页返回 10 条，可通过 per_page 参数设置（最大 100）。
• 使用 page 参数遍历所有数据。
• WooCommerce API 没有严格速率限制，但建议合理调用频率，避免影响服务器性能。

五、最佳实践与安全建议

• 开启 HTTPS：避免 API Key 在传输过程中被截获。

• 限制 API 权限：如果只查询数据，生成读取权限的 key，避免误操作导致数据变更。
• 分页处理：WooCommerce API 默认每页最多返回 100 条，如果数据量大需要遍历分页获取。
• 与 BI 工具结合：可以使用 Power BI、Tableau、Looker Studio 连接 WooCommerce API，制作可视化仪表盘。

六、总结

用 WooCommerce API 轻松获取店铺数据：销售额、订单、客户、库存等，还能对接企业系统，让管理更高效。想实现自动同步订单、实时更新库存？查看官方 API 文档就可以开发。

需要工程师帮你判断？

把症状、错误提示和最近改动发过来。

我们先判断风险、可能原因和安全下一步，再决定是否需要登录后台或服务器。

开始初诊