Etsy Open API v3 — 全部 GET 测试

每个按钮会由服务端用你的 Cookie 发起请求,并显示返回 JSON。按钮旁是「这接口大概是干嘛的」的体感说明(不是官方翻译)。

需已 OAuth 授权(仅 Ping 只需 API Key)。点进接口后先看到参数表单:带 {占位符} 的会显示输入框,店铺 ID、Listing、订单等会尽量预填,你可改完再点「访问 API」拉 JSON。

返回首页

(tutorial)

Readiness 状态定义(教程)(填参数)

上架/店铺「就绪」相关状态码的含义,偏官方诊断、教程里会出现,日常不一定天天用。

BuyerTaxonomyApi

买家类目树

买家逛店时左侧那种类目层级;做导购、分类页时会来拉这棵树。

买家类目属性(填参数)

点进某个类目后,买家要填的那些筛选项(尺寸、颜色之类)从哪来——就这类数据。

LedgerEntryApi

店铺账本条目列表(填参数)

支付账户流水:钱进钱出一条一条,对账、查某笔款为什么到账/扣款时常看。

单条账本条目(填参数)

流水里某一条的放大镜版,抠明细用。

OtherApi

Ping

像探活:Key 还能不能用、能不能连上 Etsy,不牵涉你店铺数据。

PaymentApi

账本相关付款(填参数)

和账本条目绑在一起的付款记录,感觉像「这笔账对应哪几次支付」。

店铺付款列表(填参数)

店铺维度最近收款的列表感,粗看现金流比翻订单快。

收据下的付款(填参数)

一单订单里怎么付的、拆成几笔——和买家付款方式、分期那种信息相关。

ReviewApi

Listing 评价(填参数)

点进某个商品页下面那一串星星和留言,按商品维度拉。

店铺评价(填参数)

整店口碑一览,不绑单个链接,更像「这家店总体评价池」。

SellerTaxonomyApi

卖家类目树

你上架时选类目的那棵树,和买家看到的那棵不一定一样。

卖家类目属性(填参数)

在某个上架类目下,你能填哪些属性、怎么映射到库存——偏卖家后台逻辑。

ShopApi

搜索店铺

像站内搜店名:按关键词捞店铺列表,不是搜商品。

店铺详情 getShop(填参数)

店铺首页背后那一坨:公告、简介、政策入口等结构化信息,一次拿全。

用户的店铺 getShopByOwnerUserId(填参数)

这个账号底下挂了几家店——多店玩家会用到。

ShopListingApi

店铺在售 Listing(active)(填参数)

你店里「正在卖」的那批链接,草稿和下架一般不会在这里。

全站 active listings

像刷全站最近上架,不是只看你一家,偏大盘/监控感。

店铺精选 Listing(填参数)

你手动标成精选/橱窗的那几条,用来做首页推荐位。

单个 Listing(填参数)

单条商品的「身份证」:标题、价格、状态等,和后台编辑页看到的是同一套核心字段。

Listing 属性(店铺路径)(填参数)

自定义属性、变体维度——买家选「红色大号」时背后那堆选项。

单个 Listing 属性(填参数)

上面那堆里的某一格,单独抠出来查。

批量 Listing IDs(填参数)

手里有一串 listing_id,想一次薅摘要,比循环单条快。

店铺 Listing 列表(填参数)

按状态翻页拉商品,比 active 更灵活——想包含草稿、下架就要靠这类接口配合参数。

收据关联 Listing(填参数)

这一单到底买了你哪些链接——拆单、对货、打印拣货单时脑子里的那张表。

退货政策下 Listing(填参数)

挂在某条退货规则下面的商品有哪些——改政策前想评估影响会看。

分区下 Listing(填参数)

店铺里某个橱窗分区(比如「新品区」)里摆了哪些商品。

ShopListingFileApi

Listing 文件列表(填参数)

数字商品、说明书附件那种——不是主图,是「可下载文件」列表。

单个 Listing 文件(填参数)

上面列表里某一个文件的详情。

ShopListingImageApi

单张图片(listing 路径)(填参数)

主图/副图里某一张的元数据(地址、排序),不是文件本体二进制。

单张图片(店铺路径 旧)(填参数)

同上,旧版 URL,能拉就别纠结,和上面二选一。

Listing 全部图片(填参数)

这个商品下所有主图副图一口气拉齐。

Listing 全部图片(店铺路径)(填参数)

同上,带 shop 前缀的老路径。

ShopListingInventoryApi

Listing 库存(填参数)

改价、改库存、对 SKU 前必看:变体、数量、offer 都在这一坨。

ShopListingOfferingApi

库存 Offering(填参数)

某个变体具体那一档报价(哪一档价、对应库存),比整份 inventory 更细一针。

ShopListingProductApi

库存 Product(填参数)

库存里「某一个 SKU/组合」那一行,夹在 listing 和 offering 之间。

ShopListingTranslationApi

Listing 翻译(填参数)

多语言标题描述——你开了哪种语言就能拉到对应文案。

ShopListingVariationImageApi

变体图(填参数)

不同颜色/款式对应哪张图——买家点变体时切图就靠这类数据。

ShopListingVideoApi

单个视频(填参数)

商品页上某一个视频的元信息。

视频列表(填参数)

这个商品挂了几个视频、顺序怎样。

ShopProductionPartnerApi

生产合作伙伴(填参数)

若你登记了外包工厂/合作方,合规或展示用;很多小店可能是空列表。

ShopReceiptApi

单笔收据(填参数)

一张订单的完整快照:谁买的、寄哪、多少钱、留言——和后台点开某一单的感觉一致。

收据列表(填参数)

订单列表页那种按时间一排,翻页、筛状态。

ShopReceiptTransactionsApi

单笔 Transaction(填参数)

订单里「一行商品」:退款、部分发货、对账常按这一行说话。

某 Listing 的交易(填参数)

这个商品历史上被下过多少单、哪些交易行——做爆品分析会瞟。

某收据的交易行(填参数)

一单里拆成几行商品,每行数量、价格——和收据详情里那块一致。

店铺全部交易行(填参数)

跨订单拉「所有行项目」,像大表导出,量大时注意限流。

ShopReturnPolicyApi

退货政策列表(填参数)

你配了几套退货规则、每套管什么——改政策前先扫一眼。

单笔退货政策(填参数)

其中一套规则的全文:天数、条件、文案。

ShopSectionApi

单个店铺分区(填参数)

店铺首页某个分类橱窗的配置(名字、排序等)。

店铺分区列表(填参数)

所有橱窗分区一列出来,整理店铺导航时有用。

ShopShippingProfileApi

承运商列表

打单时能选哪些物流商(USPS、UPS 那种字典表)。

单个运费模板(填参数)

一套运费规则:名字、处理时间、和哪些 profile 绑定。

运费模板目的地(填参数)

这套模板对哪些国家/地区怎么收费。

运费升级选项(填参数)

加急、签收那种加价项有没有开。

运费模板列表(填参数)

你店里配了几个运费模板、先扫一眼再点进某一套。

UserAddressApi

用户地址列表

账号里保存的收货地址簿,下单时常选的那些。

单个地址(填参数)

地址簿里某一条的完整字段。

UserApi

当前用户 users/me

当前授权的就是谁——和 token 里那个人对齐,比手填 user_id 省心。

用户 getUser(填参数)

按 ID 查某个用户公开资料(不是敏感后台全量)。