怎么调用 Etsy 关键词搜索 API？
search使用 platform="etsy"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 listing_id、title、url、price、list_price、currency 等 17 个字段。
Etsy search 的参数分别是什么意思？
keyword必填- Etsy 商品搜索词，例如 ceramic mug。用于检索商品标题/列表，不是店铺名精确查询；店铺资料或评论使用 shop。
Etsy 官方 findAllListingsActive 使用 keywords 检索活跃 listing，并提供价格、币种、taxonomy、limit 和排序字段。EveryInfra keyword 对应商品检索文本；本接口的文字 category、exclude_keywords 和中性 sort 值是自身映射，不能称为 Etsy 原生参数或保证与 taxonomy ID 一一对应。官方来源：Etsy Open API：活跃 Listing 的关键词与价格条件来源核查：
category可选- 商品类别：any 不限；jewelry-and-accessories 珠宝配饰、clothing-and-shoes 服装鞋履、home-and-living 家居、wedding-and-party 婚礼派对、toys-and-entertainment 玩具娱乐、art-and-collectibles 艺术收藏、craft-supplies-and-tools 手工材料工具、vintage 复古、gifts 礼品、electronics-and-accessories 电子配件、bags-and-purses 包袋、bath-and-beauty 洗护美容。
查看全部 13 个允许值
anyart-and-collectiblesbags-and-pursesbath-and-beautyclothing-and-shoescraft-supplies-and-toolselectronics-and-accessoriesgiftshome-and-livingjewelry-and-accessoriestoys-and-entertainmentvintagewedding-and-party currency可选- 搜索结果的商品价格币种，默认 USD，支持当前接口列出的币种代码。min_price 按此币种解释，不改变 API 调用扣费币种。
查看全部 16 个允许值
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywords可选- 排除商品标题词，传字符串数组，例如 ["digital", "download"]；标题包含任一词时排除，忽略大小写。不是排除卖家或扫描完整商品描述的保证。
min_price可选- 商品搜索最低价格，非负数值，单位为 currency 所选币种；不是最小起订量、运费上限或调用预算。
sort可选- 商品搜索排序：relevance 综合相关度（默认）、price_asc 价格升序、price_desc 价格降序、newest 最近上架；兼容旧值 most_relevant / lowest_price / highest_price / recently_listed。不是店铺评论时间排序。
查看全部 4 个允许值
newestprice_ascprice_descrelevance
Etsy 特有返回字段与含义（9）
- listing_id
- 商品 ID。
- list_price
- 标价。
- on_sale
- 是否在促销。
- free_shipping
- 是否包邮。
- is_digital
- 是否为数字商品（下载类，无需物流）。
- shop_id
- 店铺 ID。
- shop_name
- 店铺名。
- shop_rating
- 店铺评分。
- shop_review_count
- 店铺评价数。