Etsy Shop listings API
List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response.
价格与服务商
Etsy Shop listings API 价格：一个 API，2 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 Etsy Shop listings
{
"data": {
"items": [
{
"currency": "USD",
"image": "https://example.com/image.jpg",
"listingId": "a1b2c3d4",
"originalPrice": 19.99,
"price": 19.99,
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-10-23 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- shopNamestring
StudioStelleHD
Etsy shop name, as in the shop URL (https://www.etsy.com/shop/<name>), e.g. StudioStelleHD. The Etsy Search and Etsy Product SKUs return it as shopName.
- pageinteger
1-based results page of the shop's listings. Each page is billed as one request.
响应
JSON，每个字段一个示例值。
The shop's active listings for the requested page, in the shop's own order. Populated whenever the provider has data for the entity.
- currencystring
Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.
- imagestring
Primary listing image URL, or null when the listing has none. Populated whenever the provider has data for the entity.
- listingIdstring
Etsy listing id, the number in the listing URL (https://www.etsy.com/listing/<id>/...); pass it to the Etsy Product SKU. Populated whenever the provider has data for the entity.
- originalPricenumber
Price before the current sale, or null when the listing is not on sale.
- pricenumber
Current price in the listing currency, or null when not shown. Populated whenever the provider has data for the entity.
- titlestring
Listing title. Populated whenever the provider has data for the entity.
- urlstring
Etsy listing page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Listings wrapper, or null when the shop has none.
- totalResultsinteger
Total listings the shop has for sale, or null when not reported.
- foundboolean
True when the shop has at least one active listing on the requested page.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 Etsy Shop listings API
AnyAPI 的 Etsy Shop listings API 只需一次 POST 请求 /v1/run/etsy.shop_listings，就以统一格式的 JSON 返回 Etsy 数据。List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response.AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.85 起，以美元计价，无需订阅，也没有每月最低消费。