如何通过Shopify Admin API获取带特定标签的客户数量

别担心，完全有对应的Shopify Admin API可以满足你的需求！我来一步步给你讲清楚怎么操作，不管是用REST API还是GraphQL API都能轻松实现。

一、核心思路 #

Shopify的客户管理API支持通过标签过滤来筛选客户，并且会直接返回匹配结果的总数，不需要你自己分页统计所有数据，非常高效。

二、REST API实现方式 #

1. 必备准备 #

• 拥有Shopify店铺的API访问权限（需要read_customers权限）
• 你的店铺域名（比如your-shop.myshopify.com）
• 有效的API访问令牌（可以通过私有应用或OAuth流程获取）

2. 构造请求 #

使用GET请求访问客户列表端点，通过filter参数指定标签：

curl -X GET "https://your-shop.myshopify.com/admin/api/2024-07/customers.json?filter=tag:xyz" \
-H "X-Shopify-Access-Token: your-access-token"

注意：2024-07是当前的稳定API版本，建议使用Shopify官方推荐的最新版本，避免旧版本被废弃。

3. 获取总数 #

在返回的JSON响应里，total_count字段就是带xyz标签的客户总数：

{
  "customers": [/* 匹配的客户列表（如果limit没限制的话） */],
  "total_count": 15
}

如果不想返回具体客户数据、节省带宽，可以加上fields=id和limit=1参数：

curl -X GET "https://your-shop.myshopify.com/admin/api/2024-07/customers.json?filter=tag:xyz&fields=id&limit=1" \
-H "X-Shopify-Access-Token: your-access-token"

这样响应里只会返回1个客户的ID，但total_count依然是准确的总数。

三、GraphQL API实现方式（更高效） #

如果你的应用已经在使用GraphQL，这种方式会更节省资源——可以直接只请求总数，不需要返回任何客户数据：

1. 构造查询 #

query GetTaggedCustomerCount {
  customers(first: 1, query: "tag:xyz") {
    totalCount
  }
}

2. 发送请求 #

用POST请求发送到GraphQL端点：

curl -X POST "https://your-shop.myshopify.com/admin/api/2024-07/graphql.json" \
-H "X-Shopify-Access-Token: your-access-token" \
-H "Content-Type: application/json" \
-d '{"query": "query GetTaggedCustomerCount { customers(first: 1, query: \"tag:xyz\") { totalCount } }"}'

3. 响应结果 #

返回的结果会直接给出总数：

{
  "data": {
    "customers": {
      "totalCount": 15
    }
  }
}

四、注意事项 #

• 确保你的API令牌拥有read_customers权限，否则会返回权限错误
• API版本要保持更新，Shopify每季度会推出新的API版本，旧版本会在一段时间后被废弃
• 如果标签包含特殊字符，需要进行URL编码（比如空格用%20代替）

内容的提问来源于stack exchange，提问作者Abhijit