如何通过WooCommerce REST API筛选含指定属性及属性值的商品？

1. 修复代码语法错误 #

你的代码里attribute_term一行末尾缺少逗号，这会导致后续参数无法被正确识别，服务器可能直接忽略筛选条件，所以返回了所有商品。先补上逗号：

const response = await woocommerceApi.get("products", {
  attribute: "pa_x-attribute-slug",
  attribute_term: "x-attribute-term-slug", // 补上缺失的逗号
  per_page: 100,
});

2. 确认属性slug的正确性 #

• 全局产品属性的slug确实会自动添加pa_前缀，你需要确保使用的是完整带前缀的slug。可以在WooCommerce后台「产品 > 属性」中查看对应属性的slug，比如你创建的属性名为“x-attribute”，slug应该是pa_x-attribute（注意原slug的特殊字符会被转义，比如空格会变成横杠）。
• 如果是产品单独设置的自定义属性（非全局属性），API的attribute参数无法直接筛选，这种情况需要用元查询实现，下面会说明。

3. 自定义属性的筛选方法（针对非全局属性） #

如果“x-attribute”是产品单独设置的自定义属性，需要通过meta_query来筛选，对应的meta key是_product_attributes，示例代码如下：

const response = await woocommerceApi.get("products", {
  per_page: 100,
  filter: {
    meta_query: [
      {
        key: '_product_attributes',
        value: 'x-attribute-slug', // 自定义属性的slug（不带pa_前缀）
        compare: 'LIKE'
      },
      {
        key: '_product_attributes',
        value: 'x-attribute-term-slug', // 属性值的slug
        compare: 'LIKE'
      }
    ]
  }
});

4. 额外注意事项 #

• 确保你的API密钥拥有read_products权限，否则可能返回错误或不完整的数据。
• 如果商品总数超过per_page设置的100，需要通过page参数分页获取数据。

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