如何为Etsy的createDraftListing API确定数字下载类正确taxonomy_id

1. 从Etsy API获取可用taxonomy_ids列表 #

使用Etsy API的getTaxonomyNodes端点（GET /v3/application/taxonomy/nodes）可获取完整分类节点列表，支持通过参数筛选：

• level：指定分类层级，比如level=1获取一级分类，level=2获取二级分类
• parent_id：获取指定父分类下的子节点，精准缩小范围

示例请求代码：

axios.get('https://openapi.etsy.com/v3/application/taxonomy/nodes', {
  headers: {
    'x-api-key': 'Your-Etsy-API-Key',
    'Authorization': 'Bearer Your-OAuth-Token',
  },
  params: {
    level: 2,
    parent_id: 105 // 筛选数字艺术父分类下的子节点
  }
})
.then(response => {
  console.log('Taxonomy nodes:', response.data);
})
.catch(error => {
  console.error('Error fetching taxonomy:', error);
});

2. 确定数字下载类产品的合适taxonomy_id #

最佳操作分为两步：

• 先用上述API获取分类列表，匹配你的产品类型：比如可打印海报选Digital Prints（ID:106），字体文件选Fonts（ID:3937）
• 参考Etsy前台同类产品的分类：搜索你的产品类型（如“digital planner”），查看热门商品的分类标签，再对应API返回的分类ID，确保匹配度

注意：设置type: "download"时，需确认所选taxonomy_id支持数字下载（创意类数字分类均支持）。

3. 数字下载类产品常见taxonomy_id映射 #

整理了常用的数字产品分类ID，可直接参考：

• 105: Digital Art & Collectibles（通用数字产品父分类）
• 106: Digital Prints（数字海报、插画等）
• 339: Printables（可打印计划、贴纸、邀请函等）
• 3937: Fonts（字体文件）
• 1246: SVG Files（矢量图形文件）
• 2020: Digital Planners（电子计划本）

修改后的代码示例 #

假设你的产品是数字海报，使用对应分类ID：

import axios from 'axios';

const listingData = {
  quantity: 9,
  title: "Example Digital Print",
  description: "High-resolution printable wall art",
  price: 19.99,
  who_made: "i_did",
  when_made: "2020_2024",
  taxonomy_id: 106, // 对应Digital Prints分类
  type: "download",
};

axios.post('https://openapi.etsy.com/v3/application/listings', listingData, {
  headers: {
    'x-api-key': 'Your-Etsy-API-Key',
    'Authorization': 'Bearer Your-OAuth-Token',
    'Content-Type': 'application/json',
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error posting to Etsy:', error);
});

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